Operations

Lifecycle commands for a running sfp server. Every command takes --tenant. Add --ssh-connection and --identity-file when running remotely from your workstation, or omit them when running directly on the server.

---

Registry credentials

Export DOCKER_REGISTRY + DOCKER_REGISTRY_TOKEN to env before every start / stop — they are not read from the tenant .env that init wrote, only from environment variables. New shell session = re-export.

export DOCKER_REGISTRY="source.flxbl.io"
export DOCKER_REGISTRY_TOKEN="your-source-flxbl-pat"

---

Commands

Goal	Command
Start the server	sfp server start --tenant <t> --base-dir /opt/sfp-server
Stop the server	sfp server stop --tenant <t>
Check health	curl https://sfp.yourcompany.com/health
Tail combined server + worker logs	sfp server logs --tenant <t>
Tail one service	sfp server logs --tenant <t> --service app --tail 200 --follow

logs flags

Flag	Default	Purpose
--service <app|worker|caddy>	combined server hatchet-worker	Restrict to one service
--follow, -f	off	docker compose logs --follow
--tail <n>	100	Lines retrieved per service

---

Updating

For image bumps, drains, and migrations, see Updating sfp server.

---

Getting help

Channel	Where
Logs	See commands above
Health	See Step 3 for /health shape + 503 semantics
Support	Your sfp support channel