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.