Deploying

CLI Deploy

norn deploy <app> [ref]

• ref defaults to HEAD (latest commit on the configured branch)
• The CLI connects to the WebSocket and shows real-time progress for each pipeline step
• On completion, prints the saga ID for later inspection

Example:

$ norn deploy signal-sideband abc1234
▶ clone
✓ clone (3.2s)
▶ build
✓ build (37.1s)
▶ test
✓ test (5.8s)
▶ snapshot
✓ snapshot (1.2s)
▶ migrate
✓ migrate (0.4s)
▶ submit
✓ submit (0.8s)
▶ healthy
✓ healthy (32.0s)
▶ forge
✓ forge (1.1s)
▶ cleanup
✓ cleanup (0.2s)

deployed signal-sideband → ghcr.io/antiartificial/signal-sideband:abc1234
saga: f47ac10b-58cc-4372-a567-0e02b2c3d479

UI Deploy

Click the Deploy button on an app card in the dashboard. The deploy panel shows a live step-by-step progress view with the same information as the CLI.

API Deploy

curl -X POST http://localhost:8800/api/apps/myapp/deploy \
  -H "Content-Type: application/json" \
  -d '{"ref": "abc1234"}'

Pipeline Steps

See Deploy Pipeline for detailed documentation of each step.

Step	Description
clone	Checkout repo at ref
build	Build and push Docker image
test	Run test command
snapshot	pg_dump database
migrate	Run database migrations
submit	Translate and submit Nomad jobs
healthy	Wait for allocations to be healthy
forge	Update cloudflared ingress
cleanup	Remove temp files

Auto-Deploy

Enable auto-deploy by setting autoDeploy: true in the infraspec's repo config and configuring a GitHub webhook.

GitHub Webhook Setup

1. In your GitHub repo, go to Settings → Webhooks → Add webhook
2. Set the payload URL to https://norn.example.com/api/webhooks/github
3. Set the content type to application/json
4. Set the secret to match NORN_WEBHOOK_SECRET
5. Select "Just the push event"

When a push event is received for an app with autoDeploy: true, Norn automatically triggers a deploy with the pushed commit SHA.

Rollback

norn rollback <app>

Finds the most recent successful deployment and re-deploys its image tag. This skips the clone/build/test steps and goes straight to submit with the previous image.