Skip to content

Update self-hosting page for desktop app connection #68

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ArtyomSavchenko merged 1 commit into from
Jan 16, 2026
Merged

Update self-hosting page for desktop app connection #68

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions src/content/docs/getting-started/self-host.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,24 @@ We offer the option to self-host the Huly platform on your own server. All of th

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:**
```bash
# 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 Huly instance to our cloud version through the GUI, but there is still a way to manually export/import your self-hosted data to huly.io. Feel free to reach us out when you need to do this and we will provide you guidance and help.
Expand Down