Service Installation

Install the worker as a system service with launchd (macOS) or systemd (Linux).

macOS (launchd)

Install

bash

cueapi-worker install-service --config /absolute/path/to/cueapi-worker.yaml

Creates a launchd plist at ~/Library/LaunchAgents/com.cueapi.worker.plist. The worker starts automatically on login.

Manage

bash

# Start
launchctl load ~/Library/LaunchAgents/com.cueapi.worker.plist
 
# Stop
launchctl unload ~/Library/LaunchAgents/com.cueapi.worker.plist
 
# Check status
launchctl list | grep cueapi

Uninstall

bash

cueapi-worker uninstall-service

Linux (systemd)

Install

bash

cueapi-worker install-service --config /absolute/path/to/cueapi-worker.yaml

Creates a systemd user unit at ~/.config/systemd/user/cueapi-worker.service.

Enable and start

bash

systemctl --user enable cueapi-worker
systemctl --user start cueapi-worker

Manage

bash

# Check status
systemctl --user status cueapi-worker
 
# View logs
journalctl --user -u cueapi-worker -f
 
# Restart
systemctl --user restart cueapi-worker
 
# Stop
systemctl --user stop cueapi-worker

Uninstall

bash

systemctl --user stop cueapi-worker
systemctl --user disable cueapi-worker
cueapi-worker uninstall-service

Note

The config path must be absolute when installing as a service. The service runs from a different working directory.

Previous← Running NextTroubleshooting →