Self-host Kortix.One CLI, one server, the whole platform.
The kortix CLI installs the web app, the API, the LLM gateway and the database on your server as one Docker Compose stack. Then it keeps the stack up to date.
$ curl -fsSL https://kortix.com/install | bash▸ Resolving latest release from GitHub…✓ Latest release: <version>✓ Checksum verified (<sha256>)✓ Installed binary at /home/ops/.kortix/kortixOne line installs the kortix CLI. It runs on Linux and macOS, on x86_64 and arm64.
Four commands on a Linux server with Docker. Then sign in at your own domain.
Everything to run it yourself. One CLI, one stack, daily updates, Enterprise when you need it.
One CLIInstall, configure, update, check.
- kortix self-host does all of it
- Questions on the first run
- Every setting in one .env
One stackDocker Compose on your server.
- Web app, API and LLM gateway
- Postgres and file storage
- TLS from Caddy on your domain
Daily updatesOr pin one exact version.
- Track stable or latest
- The database migrates first
- Roll back with one command
EnterpriseOne flag on your instance.
- SAML 2.0 single sign-on and SCIM
- Role-based access control
- Audit
How self-hosting works.From the first command to the daily update.
What runs where
init writes one Docker Compose project. Every service in it runs on your server.
Sessions and Drive run on Platinum sandboxes. They call back to your instance.
frontendThe web appkortix-apiThe REST APIllm-gatewayThe LLM gatewaysupabase-*Postgres, auth and file storagekortix-updaterPulls, migrates and rolls dailycaddyTLS on 80 and 443, domain mode
SessionsOne sandbox per sessionDrivePlatinum volumes
Self-hosting, answered.From the CLI and the docs.
Anything else, write to the team.
Can a self-hosted Kortix run air-gapped?
No. The stack pulls its images from Docker Hub, and sessions run on Platinum sandboxes that call back to your instance over the internet. For an isolated topology, talk to us: we scope it with you.
Can I try it on my own machine first?
Yes. Run kortix self-host init --tunnel cloudflare, then kortix self-host start. The web app opens at http://localhost:13737, and the API gets a public trycloudflare.com URL that changes each time the tunnel restarts.
How do I point the kortix CLI at my instance?
kortix self-host start registers a CLI host named selfhost. Switch with kortix hosts use selfhost, and back with kortix hosts use cloud.
Which models can a self-hosted instance use?
The providers each project connects, with its own keys. A self-hosted instance has no Kortix-managed models. A project can also connect Platinum as its provider with a Platinum API key.
What happens when an update fails?
A failed migration swaps nothing, and the previous version keeps serving. A failed swap keeps the previous version too. kortix self-host status shows the outcome of the last run.
How do I back up the instance?
Stop the stack, copy the instance directory and its four Docker volumes, then start it again. Drive folders and session workspaces live at Platinum, so a server backup does not hold them.
Can one server run several instances?
Yes. Pass --instance <name> to every command. Only one instance per server can use domain mode, because Caddy binds ports 80 and 443.