Deploy

Self-host OpenBrain

Public deployment runs from the open-source OpenBrain repository. The default entrypoint is a single Caddy port on your host.

1. Clone and deploy

On your server, pull the repository and run the deploy script. It creates deploy/compose/.env when missing, pulls images, starts services, and prints the admin login.

ssh <server>
cd ~/code/openbrain
bash deploy/scripts/deploy.sh

2. Verify the stack

After deployment, verify the public endpoints on localhost before exposing the port through your ingress.

curl -I http://127.0.0.1:9527
curl -I http://127.0.0.1:9527/admin
curl -I http://127.0.0.1:9527/v1/model-presets
curl -I http://127.0.0.1:9527/ai/health

3. Open Admin

OpenBrain Admin is served under /admin on the same Caddy port. Configure models, org settings, storage, and RAG embedding policies from there.

http://<server-ip>:9527/admin

OPENBRAIN_DEFAULT_ORG_ID=cloud
OPENBRAIN_DEFAULT_ORG_NAME=Cloud

Single-organization self-host

Self-host OpenBrain is a single-organization deployment. Set OPENBRAIN_DEFAULT_ORG_ID and related env values in deploy/compose/.env, then redeploy to reconcile the default org.