Running as a Service

Please follow the appropriate guide for your system:

Linux (systemd)

Create a service file at /etc/systemd/system/cc-headless.service:

[Unit]
Description=ObitCC Headless Worker
After=network.target

[Service]
Type=simple
User=your-username
WorkingDirectory=/home/your-username/cc-headless
ExecStart=/home/your-username/cc-headless/cc-headless-linux-amd64 -k YOUR_API_KEY -u https://cc.obitmc.com
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

Enable and start the service:

sudo systemctl daemon-reload
sudo systemctl enable cc-headless
sudo systemctl start cc-headless
sudo systemctl status cc-headless

View logs:

sudo journalctl -u cc-headless -f

macOS (launchd)

Create a plist file at ~/Library/LaunchAgents/com.obitcc.headless.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.obitcc.headless</string>
    <key>ProgramArguments</key>
    <array>
        <string>/Users/your-username/cc-headless/cc-headless-macos-arm64</string>
        <string>-k</string>
        <string>YOUR_API_KEY</string>
        <string>-u</string>
        <string>https://cc.obitmc.com</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>StandardOutPath</key>
    <string>/tmp/cc-headless.log</string>
    <key>StandardErrorPath</key>
    <string>/tmp/cc-headless.error.log</string>
</dict>
</plist>

Load and start:

launchctl load ~/Library/LaunchAgents/com.obitcc.headless.plist
launchctl start com.obitcc.headless

Windows (Task Scheduler)

1. Open Task Scheduler

2. Create Basic Task → Name it "ObitCC Headless"

3. Trigger: "When the computer starts"

4. Action: "Start a program"

   • Program: C:\path\to\cc-headless-windows-amd64.exe

   • Arguments: -k YOUR_API_KEY -u https://cc.obitmc.com

5. Enable "Run whether user is logged on or not"

6. Check "Run with highest privileges"