mayros daemon
Install, start, stop, and manage the Gateway as a system service. Uses the platform-native service manager: launchd on macOS, systemd on Linux, and schtasks on Windows.
Subcommands
daemon status
Show service install status and probe the running Gateway for health information.
Options:
| Flag | Description | Default |
|---|---|---|
--url <url> | Gateway WebSocket URL (defaults to config/remote/local) | — |
--token <token> | Gateway token (if required) | — |
--password <password> | Gateway password (password auth) | — |
--timeout <ms> | Probe timeout in ms | 10000 |
--no-probe | Skip the RPC probe (only show install status) | false |
--deep | Scan system-level services for additional Gateway instances | false |
--json | Output JSON | false |
daemon install
Install the Gateway as a system service. Creates the appropriate service definition for the current platform.
Options:
| Flag | Description | Default |
|---|---|---|
--port <port> | Gateway port | — |
--runtime <runtime> | Daemon runtime: node or bun | node |
--token <token> | Gateway token (token auth) | — |
--force | Reinstall/overwrite if already installed | false |
--json | Output JSON | false |
daemon uninstall
Uninstall the Gateway system service. Removes the service definition from the platform service manager.
Options:
| Flag | Description | Default |
|---|---|---|
--json | Output JSON | false |
daemon start
Start the Gateway system service.
Options:
| Flag | Description | Default |
|---|---|---|
--json | Output JSON | false |
daemon stop
Stop the Gateway system service.
Options:
| Flag | Description | Default |
|---|---|---|
--json | Output JSON | false |
daemon restart
Restart the Gateway system service. Equivalent to stop followed by start.
Options:
| Flag | Description | Default |
|---|---|---|
--json | Output JSON | false |
Service managers
| Platform | Service manager | Service file location |
|---|---|---|
| macOS | launchd | ~/Library/LaunchAgents/ |
| Linux | systemd | ~/.config/systemd/user/ |
| Windows | schtasks | Windows Task Scheduler |
Examples
bash# Install the Gateway as a system service mayros daemon install # Install with a custom port and token mayros daemon install --port 9090 --token mysecret # Reinstall (overwrite existing) mayros daemon install --force # Check service and Gateway status mayros daemon status # Check status with deep scan for extra instances mayros daemon status --deep # Output status as JSON mayros daemon status --json # Start / stop / restart the service mayros daemon start mayros daemon stop mayros daemon restart # Uninstall the service mayros daemon uninstall