ownstack deploy

Synopsis

ownstack deploy [APP] [--stack=NAME] [--wait] [--image [TAG]]

Common forms

CommandWhat it does
ownstack deployDeploy the linked app to all its stacks.
ownstack deploy my-appDeploy a specific app.
ownstack deploy --stack=prod-eastDeploy only to one stack.
ownstack deploy --imageImage deploy (default tag from registry config).
ownstack deploy --image=ghcr.io/me/app:v1.2.3Image deploy with explicit tag.
ownstack deploy --waitStream the build log live.

Inspecting deployments

$ ownstack remote deploy-log [--app=NAME] [--deployment=ID] [--follow]

How it works

  1. CLI hands the (app, optional stack, optional image) to the control plane API.
  2. Control plane enqueues one deployment job per target stack.
  3. Each job SSHes to its stack, pushes your repo (or pulls the image), runs build + release + restart.

Common pitfalls

SymptomCause
A deploy is already in progressAn earlier deploy hasn't finished. Wait, or check the dashboard for stuck jobs.
No git repositoryApp's git_repository_url is unset. Set it in the dashboard or via API.
Build succeeds, healthcheck failsWeb process not bound to $PORT. See Healthchecks.