Requirements & sizing
Host requirements and capacity planning: how many VMs, how much CPU, memory and disk for a given certificate count and discovery footprint, and which tunables actually move the numbers.
Standalone deployment
Single-binary install for one Linux host. Bundles nginx, sets up a local MongoDB, and bootstraps secrets. The fastest path to a production-shaped instance for a single project.
CertAutoPilot OS appliance
CertAutoPilot OS is a ready-made Debian 13 system image (ISO, OVA, qcow2) that carries the backend, the web UI, nginx and MongoDB 8.0. One node or three form a cluster with `cluster init` and `cluster join` from the appliance's console โ no installer script, no SSH orchestration.
CertAutoPilot OS with an HSM
Keep the key-encryption key of a CertAutoPilot OS cluster in an HSM (Thales Luna, Fortanix DSM): what to prepare, then node by node on the console โ install the client, form the cluster, join the others, rotate the key.
Multi-VM deployment
Two or more standalone hosts behind one load balancer, sharing a single external MongoDB. Same one-command bootstrap as standalone โ every host beyond the first adopts the cluster's secrets via --secrets-from. Works with both KEK backends (env hex bytes in secrets.env, or PKCS#11 keys inside an HSM).
Docker Compose
Compose deployments for development and small production: single MongoDB by default, environment-driven secrets, healthchecks, an external/replica-set MongoDB option, and the upgrade path.
Helm chart
Production Kubernetes deployment: one all-in-one workload scaled by replicaCount, a leader-elected scheduler, External Secrets integration, and the graceful-shutdown behaviour upgrades depend on.
High availability
Replicate every layer: a 3-member MongoDB replica set, multi-replica API, leader-elected scheduler, and rolling upgrades that never drop in-flight ACME orders.
Upgrade
CertAutoPilot upgrades in place. The binary is the only moving part; state lives in MongoDB and the secret store, both of which are preserved across upgrades. Index migrations run at startup. Rollback is "run the previous binary" โ no schema migrations to reverse.
Backup & restore
Two things must be backed up together: MongoDB (all the data) and the secret store (the KEK that can decrypt it). Losing either makes the other useless. Every backup strategy in this doc backs up both at the same point in time and stores them off-host.
Outbound network access
The hosts and ports the running CertAutoPilot reaches from your network. Use this page to scope egress firewall rules: open the always-needed group, then the rest as you turn features on.
Installation and inbound network access
What installation and upgrades download, which ports cluster nodes use between each other, and which ports users, load balancers and CAs connect to. The running product's outbound traffic is on the Outbound network access page.