service

See the workflow guide for examples. Global flags such as --json go before the command; see global options.

synq service

Manage the services in a compose stack (a multi-service project)

synq service|services [options] [command]

Subcommand	Purpose
`list [options]`	List the services in a stack
`get [options] <service>`	Show one service's configuration
`create [options] <name>`	Add a service to a stack
`delete\|rm [options] <service>`	Remove a service from a stack
`sync [options] <compose-file>`	Sync a stack's services from a docker-compose file (services not in the file are removed)
`start [options] <service>`	Start a service's container
`stop [options] <service>`	Stop a service's container
`restart [options] <service>`	Bounce a service's container (does NOT apply changed env — use `deploy --refresh` for that)
`containers [options]`	List the stack's active-deployment containers
`drift`	Resolve compose drift on a service (upstream compose changed a value you edited)
`env`	Read and write a service's environment variables
`logs [options] <service>`	Show or stream a service's runtime logs
`exec [options] <service> <command>`	Run a shell command inside a service's isolated container
`notes [options] <service>`	Show or replace a service's Markdown notes

synq service containers

List the stack's active-deployment containers

synq service containers [options]

Option	Meaning
`-p, --project <id\|slug\|name>`	Stack (project) id, slug, or name

synq service create

Add a service to a stack

synq service create [options] <name>

Argument	Meaning
`name`	Service name (unique within the stack)

Option	Meaning
`-p, --project <id\|slug\|name>`	Stack (project) id, slug, or name
`--image <image>`	Container image (e.g. postgres:16)
`--build <context>`	Build context path (relative to repo root)
`--dockerfile <path>`	Dockerfile path (relative to build context)
`--port <mapping>`	Port mapping, e.g. 8080:80 (repeatable) (default: [])
`--depends-on <service>`	Service this depends on (repeatable) (default: [])
`--env <KEY=VALUE>`	Compose environment default (repeatable) (default: [])
`--command <command>`	Override the container command
`--restart <policy>`	Restart policy: no \| always \| on-failure \| unless-stopped
`--expose`	Expose the service publicly through managed routing
`--exposed-port <port>`	Container port to expose publicly
`--domain <label>`	Free subdomain label (with --expose)

synq service delete

Remove a service from a stack

synq service delete|rm [options] <service>

Argument	Meaning
`service`	Service name or id

Option	Meaning
`-p, --project <id\|slug\|name>`	Stack (project) id, slug, or name
`-y, --yes`	Skip the confirmation prompt

synq service drift

Resolve compose drift on a service (upstream compose changed a value you edited)

synq service drift [options] [command]

Subcommand	Purpose
`accept [options] <service>`	Apply the upstream compose values, discarding your edits
`keep [options] <service>`	Keep your edits and stop flagging the upstream change

synq service drift accept

Apply the upstream compose values, discarding your edits

synq service drift accept [options] <service>

Argument	Meaning
`service`	Service name or id

Option	Meaning
`-p, --project <id\|slug\|name>`	Stack (project) id, slug, or name

synq service drift keep

Keep your edits and stop flagging the upstream change

synq service drift keep [options] <service>

Argument	Meaning
`service`	Service name or id

Option	Meaning
`-p, --project <id\|slug\|name>`	Stack (project) id, slug, or name

synq service env

Read and write a service's environment variables

synq service env [options] [command]

Subcommand	Purpose
`get [options] <service>`	List a service's environment variables (secrets masked)
`set [options] <service> <pairs...>`	Set a service's environment variables for one environment

synq service env get

List a service's environment variables (secrets masked)

synq service env get [options] <service>

Argument	Meaning
`service`	Service name or id

Option	Meaning
`-p, --project <id\|slug\|name>`	Stack (project) id, slug, or name
`-e, --env <environment>`	Environment: production \| preview \| development

synq service env set

Set a service's environment variables for one environment

synq service env set [options] <service> <pairs...>

Argument	Meaning
`service`	Service name or id
`pairs`	KEY=VALUE pairs

Option	Meaning
`-p, --project <id\|slug\|name>`	Stack (project) id, slug, or name
`-e, --env <environment>`	Environment: production \| preview \| development (default: "production")
`--secret`	Mark the provided variables as secret
`--replace`	Replace ALL variables for this environment with only the given pairs

synq service exec

Run a shell command inside a service's isolated container

synq service exec [options] <service> <command>

Argument	Meaning
`service`	Service name or id
`command`	Shell command (quote it as one argument)

Option	Meaning
`-p, --project <id\|slug\|name>`	Stack (project) id, slug, or name
`--cwd <path>`	Working directory inside the container
`--timeout <ms>`	Command timeout in milliseconds (default: "30000")

synq service get

Show one service's configuration

synq service get [options] <service>

Argument	Meaning
`service`	Service name or id

Option	Meaning
`-p, --project <id\|slug\|name>`	Stack (project) id, slug, or name

synq service list

List the services in a stack

synq service list [options]

Option	Meaning
`-p, --project <id\|slug\|name>`	Stack (project) id, slug, or name

synq service logs

Show or stream a service's runtime logs

synq service logs [options] <service>

Argument	Meaning
`service`	Service name or id

Option	Meaning
`-p, --project <id\|slug\|name>`	Stack (project) id, slug, or name
`-f, --follow`	Stream new log lines as they arrive (SSE)
`--tail <n>`	Number of lines to show from the end (default: "200")

synq service notes

Show or replace a service's Markdown notes

synq service notes [options] <service>

Argument	Meaning
`service`	Service name or id

Option	Meaning
`-p, --project <id\|slug\|name>`	Stack (project) id, slug, or name
`--set <markdown>`	Replace the notes with this Markdown text
`--file <path>`	Replace the notes with the contents of a file (- reads stdin)
`--clear`	Remove the notes

synq service restart

Bounce a service's container (does NOT apply changed env — use deploy --refresh for that)

synq service restart [options] <service>

Argument	Meaning
`service`	Service name or id

Option	Meaning
`-p, --project <id\|slug\|name>`	Stack (project) id, slug, or name
`--force`	Bounce even with pending env changes (they will NOT be applied)

synq service start

Start a service's container

synq service start [options] <service>

Argument	Meaning
`service`	Service name or id

Option	Meaning
`-p, --project <id\|slug\|name>`	Stack (project) id, slug, or name

synq service stop

Stop a service's container

synq service stop [options] <service>

Argument	Meaning
`service`	Service name or id

Option	Meaning
`-p, --project <id\|slug\|name>`	Stack (project) id, slug, or name

synq service sync

Sync a stack's services from a docker-compose file (services not in the file are removed)

synq service sync [options] <compose-file>

Argument	Meaning
`compose-file`	Path to docker-compose.yml / compose.yaml

Option	Meaning
`-p, --project <id\|slug\|name>`	Stack (project) id, slug, or name
`-y, --yes`	Skip the confirmation prompt

On this page