lizard restart

Rolling restart of the current build — no rebuild.

Usage

lizard restart [nameOrId] [flags]

Flags

FlagDescription
-s, --service <name>Service
--detachReturn after the restart is accepted
--waitWait for the new restart attempt to become ready; works with --json
--timeout <seconds>Readiness wait budget with --wait; default 120
--jsonReturn JSON for scripts

Examples

Restart a service

lizard restart --service api

Restart without streaming logs

lizard restart --service api --detach

Wait before running the next check

Requires CLI 0.3.94 or later. Use 0.3.95 or later for workers without HTTP.

lizard --json restart --service api --wait --timeout 120

Without --wait, JSON mode returns after the restart is accepted. With --wait, the result includes ok, status, attemptId, and waitedMs. The CLI waits for a new restart attempt, so an unchanged status from before the request does not count as success. A failed wait or timeout returns a nonzero exit code.

For HTTP services, the CLI also checks the service domain twice. Workers with containerPort=0 use the readiness status from the backend and do not need an HTTP listener, even when they have a generated domain.

lizard --json restart --service worker --wait --timeout 60

The timeout applies to the readiness wait after the restart request. It does not cancel the restart, and network calls can make the total command take longer. Check application data or a health endpoint after the command when your workflow needs more than process readiness.

See also

  • lizard redeploy — trigger a fresh build instead of recycling the current one
  • lizard logs — inspect logs around a restart with --restart latest or --restart <id>
  • Deployments — restarts vs. redeploys, and recovering from a crash

Updated