Skip to main content

Documentation Index

Fetch the complete documentation index at: https://sysg.dev/llms.txt

Use this file to discover all available pages before exploring further.

restart

Restart services with zero downtime.
$ sysg restart

Options

ShortLongDescription
-c--configPath to the configuration file. When specified, reloads the configuration and restarts all services with the new settings
-s--serviceName of a specific service to restart. If not specified, all services are restarted
---daemonizeStart the supervisor before restarting if it is not already running
---sysOpt into privileged system mode. Requires running as root
---drop-privilegesDrop child service privileges during spawn. In root/system mode, services without an explicit user run as nobody
---log-levelSet logging verbosity for this invocation. Accepts named levels (trace, debug, info, warn, error, off) or numeric values (5-0)

Examples

Restart all services

$ sysg restart

Restart specific service

$ sysg restart --service api

Restart with new configuration

$ sysg restart --config production.yaml
Reloads configuration and restarts all services.

Deployment strategies

Services configured with deployment.strategy: rolling get zero-downtime restarts:
  1. New instance starts
  2. Health checks pass
  3. (Optional) blue/green switch_command shifts traffic to candidate slot
  4. Old instance receives SIGTERM
  5. Grace period allows requests to complete
  6. Old instance stops
Services without rolling deployment stop then start. For deployment scripts, prefer:
sysg restart --config <config> --daemonize
This keeps restart behavior explicit when supervisor detection is unavailable.

See also