start
Launch services defined in your configuration.
$ sysg start
Options
--config
Path to the configuration file. If not specified, systemg looks for systemg.yaml or sysg.yaml in the current directory.
$ sysg start --config /etc/myapp/services.yaml
--service
Optionally start only the named service instead of all services.
$ sysg start --service api
--daemonize
Run the supervisor as a background daemon. The supervisor continues running after you close your terminal, and subsequent commands communicate with it via Unix socket.
$ sysg start --daemonize
--sys
Opt into privileged system mode. Requires running as root.
$ sudo sysg start --sys
--drop-privileges
Drop privileges after performing privileged setup.
$ sudo sysg start --sys --drop-privileges
--log-level
Set logging verbosity for this invocation. Accepts named levels (trace, debug, info, warn, error, off) or numeric values (5-0).
$ sysg start --log-level debug
Examples
Start with default configuration
$ sysg start
Looks for systemg.yaml or sysg.yaml in the current directory.
Start with specific configuration
$ sysg start --config /etc/myapp/services.yaml
Daemon mode
Run the supervisor in the background. Subsequent commands communicate with this long-lived process.
$ sysg start --daemonize
Check if the daemon is running:
$ sysg status
Debug mode
See detailed output during startup:
$ sysg start --log-level debug
What happens
- Services start in dependency order
- Each service gets its own process group
- Logs are written to
~/.local/share/systemg/logs/ - PIDs are tracked for other commands
In daemon mode, the supervisor monitors services and handles restarts according to your configuration.