Documentation
System Services
Install the Oxmgr daemon as a system service so it starts automatically on boot. --system auto detects your platform.
Install as a System Service
# Install daemon as system service (auto-detects platform)
oxmgr service install --system auto
# Check service status
oxmgr service status --system auto
# Uninstall service
oxmgr service uninstall --system auto🐧
Linux
systemd
Creates a .service unit file in /etc/systemd/system
🍎
macOS
launchd
Creates a .plist in /Library/LaunchDaemons
🪟
Windows
Task Scheduler
Registers a scheduled task for boot startup
Verify Daemon Health
# Run oxmgr doctor to check daemon health
oxmgr doctoroxmgr doctor checks that the daemon is running, the API is reachable,
and the data directory is accessible.
Generated systemd Unit (Linux)
This is what oxmgr service install --system auto generates on Linux.
You can also write this manually if you prefer:
# /etc/systemd/system/oxmgr.service (generated by oxmgr service install)
[Unit]
Description=Oxmgr Process Manager
After=network-online.target
Wants=network-online.target
[Service]
Type=forking
ExecStart=/usr/local/bin/oxmgr daemon start
ExecStop=/usr/local/bin/oxmgr daemon stop
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.targetsudo systemctl daemon-reload
sudo systemctl enable oxmgr
sudo systemctl start oxmgr
# Check status
sudo systemctl status oxmgr
journalctl -u oxmgr -fUser vs system service
The --system auto flag installs a system-wide service (requires root on Linux/macOS).
For user-scoped install (starts on user login, not boot), the daemon can also be run as a user service via systemctl --user on Linux. Pass the systemd unit file manually in that case.
Still have questions?
Open an issue or browse the source on GitHub.