Service Installation

Service Installation

CortexPrism can be installed as a system service for automatic startup on all platforms.

Installation Commands

cortex service install                  # Install daemon + server as system services
cortex service uninstall                # Remove system services
cortex service install --daemon-only    # Install daemon only
cortex service install --server-only    # Install server only

Linux (systemd)

User-level systemd unit installed at ~/.config/systemd/user/cortex-daemon.service:

systemctl --user enable cortex-daemon
systemctl --user start cortex-daemon
systemctl --user status cortex-daemon

macOS (launchd)

LaunchAgent installed at ~/Library/LaunchAgents/com.cortexprism.daemon.plist:

launchctl load ~/Library/LaunchAgents/com.cortexprism.daemon.plist
launchctl unload ~/Library/LaunchAgents/com.cortexprism.daemon.plist

The plist dynamically writes the correct HOME value from the environment.

Windows

Options:

• NSSM (Non-Sucking Service Manager) — creates a Windows Service
• Task Scheduler — scheduled task with system startup trigger

.\deploy\install-service.bat
.\deploy\install-service.bat --daemon-only
.\deploy\install-service.bat --server-only

Deployment Configs

Pre-built configs in deploy/:

• cortex-daemon.service — systemd user unit
• cortex-server.service — server-only systemd unit
• cortex-node@.service — node service unit
• com.cortexprism.plist — launchd agent
• com.cortexprism.server.plist — server launchd agent
• install-service.bat — Windows NSSM/Task Scheduler

See Also

• Installation — Platform-specific install guides
• Daemon Supervisor — Daemon architecture