How to run OpenACP as a daemon with auto-start on boot?

[0xMag1ci4n]

I want OpenACP to run as a background service and start automatically when my server boots. How do I configure daemon mode?

[jasondbranding]

OpenACP supports daemon mode — running as a background service.

Configure in ~/.openacp/config.json:

{
  "runMode": "daemon",
  "autoStart": true,
  "api": {
    "port": 21420,
    "host": "127.0.0.1"
  }
}

• runMode: "foreground" (default) or "daemon"
• autoStart: true = auto-start on boot (default: false)
• api.port: REST API port (default: 21420)
• api.host: API server host (default: 127.0.0.1, localhost only)

CLI commands:

openacp start     # Start daemon
openacp stop      # Stop daemon
openacp status    # Check daemon status
openacp logs      # Tail daemon logs

When running as daemon, OpenACP provides a REST API for management:

openacp api health                      # Health check
openacp api new claude ~/my-project     # Create new session
openacp api send <id> "Fix the bug"     # Send prompt
openacp api status                      # List sessions
openacp api cancel <id>                 # Cancel session
openacp api topics                      # List topics
openacp api cleanup                     # Delete finished topics

REST API authenticates via Bearer token stored at ~/.openacp/api-secret.

Logs are stored at ~/.openacp/logs/ with rotation (max 10MB per file, keeps 7 files). Per-session log files are kept for 30 days.
Related: Daemon Mode · REST API · Logging