Skip to content
TraceX Docs

Self-hosting TraceX

We offer the option to self-host the TraceX platform on your own server. TraceX is based on the Huly platform. Upstream deployment instructions are available in the huly-selfhost GitHub repository. The main repository readme includes documentation on the following:

  • Cloning and configuring the repository
  • Setting up AWS SES email notifications
  • Setting up Love Service (Audio & Video calls)
  • Setting up AI Service
  • Configuring OpenID Connect
  • Configuring GitHub OAuth
  • Disabling Sign-up

Everything you see in the cloud version can potentially be self-hosted; however, we may not “prepackage” some services for various reasons. Some integrations (like GitHub) may require you to install a separate app in GitHub or work with Google to enable an API, and we do not have extensive documentation to describe every case. Also, some parts of cloud version rely on proprietary Cloudflare services, which we intentionally do not include into self-hosting packages to avoid any vendor lock-ins.

Connecting the Desktop App to your self-hosted server

You can connect the Huly Desktop App to your self-hosted server by launching it with the --server option pointing to your server URL.

Windows:

  1. Right-click the Huly shortcut → Properties
  2. In the “Target” field, add --server https://your-huly-server.com after the exe path
  3. Example: "C:\Program Files\Huly\Huly.exe" --server https://your-huly-server.com

macOS:

Terminal window
# Using the app name
open -a "Huly" --args --server https://your-huly-server.com


# Or using the executable path directly
/Applications/Huly.app/Contents/MacOS/Huly --server https://your-huly-server.com

Migrating data between self-hosted and cloud

We do not have a way for users to migrate data from a self-hosted TraceX instance to the cloud version through the GUI. Contact the TraceX Community for guidance on migration options.

In the reverse direction (migrating from could to self-hosted), if you are an owner of the workspace, you can do this in the desktop app. In the menu we have Backup option that saves workspace backup to your filesystem. When you have the backup, you can restore it to the self-hosted version.

Support for self-hosting

Support for self-hosting is community-driven, and the best way to get in touch with others who are self-hosting is through the TraceX Community. Here, you can ask questions, share tips, and get help from others who are also self-hosting TraceX.

Our team is also active in the community and we do our best to respond to as many questions as we can. However, due to the technical complexities of self-hosting and the wide range of factors that vary between individual setups, we may not be able to respond to every request for self-hosting support. For this reason, we encourage community members to support each other whenever possible, and of course we welcome any supplementary documentation provided by the community to add to our repository.