Deploy on a server
For one installation, use the quick-start Compose stack. It runs PostgreSQL, migrations, API, worker, Mattermost connector and web interface.
Prepare the server
- Install Docker Engine, Compose and Git.
- Copy the example stack to a dedicated directory.
- Initialize configuration and fill in credentials and Mattermost settings.
- Check outbound access from the worker to AgentBox and from sandboxes to required systems.
- Start the services and verify a first task.
- Configure HTTPS, SSO and backups.
For initial inspection of a remote server, open an SSH tunnel:
ssh -L 8085:127.0.0.1:8085 user@your-serverThen open http://localhost:8085 on your computer.
Continuous operation
Enable Docker on boot. The stack uses restart: unless-stopped for long-running services. Migrations must finish successfully before API and worker start.
To use an external PostgreSQL instance, set DATABASE_URL for API, worker and migrations. Keep credential-store and service TOML, encryption key and environment allowlist consistent across API and worker.
Run one Mattermost connector per server and bot identity. The GitLab review connector runs separately and also requires one instance per GitLab installation and bot identity. Preserve these rules, the separate migration step and SSE proxy settings when deploying to Kubernetes.