Deploy
Keep habakkuk serve running on a server or a home machine: service managers and containers, remote access, security, backups and updates, and monitoring.
On this page
habakkuk serve is the long-running process. It runs the channels, the job workers (resuming interrupted turns), schedules, the board, background memory review, retention, and the HTTP server when there is an http section.
- Run one
serveper$HABAKKUK_HOME. - It stops cleanly on
SIGINTorSIGTERM, and anything in flight resumes on the next start. - A small machine is enough: it is one static binary with SQLite storage, and the models run at your providers (or on a separate model server).
Pick a setup#
| You have | Do this |
|---|---|
| A Linux or macOS machine that stays on | habakkuk setup service writes a systemd or launchd file; see Run it on a server |
| Docker | Run the image with a volume for /data; see In a container |
| A laptop you close at night | Run serve there anyway: work missed while it slept resumes, and late schedule slots are skipped |
| Webhook channels or a remote dashboard | Put it behind HTTPS; see Remote access |
In this section#
Run it on a server systemd, launchd and Docker, and what
serve needs.Remote access reverse proxies, tunnels and habakkuk expose tailscale.Security what an agent may do by default, the audit, and secret managers.Backups and updates habakkuk backup, restore, updates and retention.Observability status, health checks, logs, metrics and traces.In this section
- Run it on a serverKeep habakkuk serve running under systemd, launchd or Docker: the setup service command, unit files, container volumes, ports and keys.
- Remote accessReach the dashboard and receive webhook channels from outside: keep the listener on loopback, set a token, and put a reverse proxy, tunnel or Tailscale in front.
- SecurityWhat Habakkuk lets an agent do by default: approvals for chat-driven and tainted turns, guests, vetted skills, private files, no surprise network calls, a locked-down local server, the audit and secret managers.
- Backups and updatesBack up and restore $HABAKKUK_HOME while Habakkuk runs, move to another machine, update and roll back, and how retention keeps storage small.
- ObservabilitySee what Habakkuk is doing: status, channel health, doctor, the health endpoint, the log, Prometheus metrics and OpenTelemetry traces.