Self-Hosting

Everything you need to run OpenACP on your own infrastructure.

OpenACP is designed to be self-hosted: you own the process, the config, and the data. There are no cloud accounts required beyond the messaging platform bots you configure. All state lives in ~/.openacp/.

In this section

  • Installation — System requirements, global install via npm, first-run setup wizard, and running from source.
  • Configuration — The full config schema, interactive editor, environment variable overrides, and backward compatibility guarantees.
  • Daemon Mode — Running as a background process, PID/log file locations, and autostart on boot.
  • Security — User allowlists, session limits, API bearer token authentication, and best practices.
  • Logging — Log levels, file rotation, per-session logs, and structured JSON format.
  • Updating — How to update, automatic config migrations, and the backward compatibility guarantee.