Self-hosting

One VPS, Docker, automatic HTTPS.

Stack

API + workers + Redis queue + SearXNG, fronted by Caddy with automatic TLS. Pushes to dev redeploy staging; production ships on manual dispatch after CI passes. Every deploy is health-gated with automatic rollback.

Environments

# staging (plain HTTP, isolated data)
/opt/openbotics-staging/.env  →  OPENBOTICS_MONGO_DB=openbot_staging
# production (TLS via Caddy)
/opt/openbotics/.env           →  OPENBOTICS_MONGO_DB=openbot

Backups

Code: last 3 deploys kept as prev-* on the server.
Data: Docker volumes + MongoDB Atlas (point-in-time available on M10+).
Secrets: never leave the server — tarballs refuse to carry .env or vault files.

OAuth redirect

Set OPENBOTICS_PUBLIC_URL to your public origin and register {PUBLIC_URL}/api/plugins/<id>/oauth/callback with each provider.

Full runbook

The repo's docs/ holds the complete pipeline, VPS, and Electron runbooks: cicd.md, deploy-vps.md, dev-pipeline.md.