Enterprise Deployment

CompassDocs Enterprise is the same application as the open-source Community edition, run from a separate image and unlocked by a license key. It adds enterprise features (SSO, SCIM provisioning, Microsoft 365 directory & Entra group sync, policy acknowledgements, training & onboarding, audit-log export, priority support) on top of everything Community already does.

The Enterprise image is public, so there’s no registry login — you just need a valid license to activate the enterprise features. Without a license it runs exactly like Community. Like Community, it’s multi-arch (amd64 + arm64), so Apple-silicon and Graviton hosts pull a native image — no emulation.

One-command install

On a host with Docker (Linux recommended; macOS/Windows via Docker Desktop):

curl -fsSL https://raw.githubusercontent.com/mattny20/CompassDocs/main/install.sh | COMPASSDOCS_EDITION=enterprise bash

This creates a ./compassdocs folder with a docker-compose.yml and a .env (with generated secrets), pulls the Enterprise image, and starts the app and its PostgreSQL database. Re-running it updates to the latest image without touching your data.

Add COMPASSDOCS_TLS=1 to also bundle a Caddy reverse proxy, so you can set your domain and HTTPS mode (automatic Let’s Encrypt, or self-signed for internal DNS) right in the setup wizard:

curl -fsSL https://raw.githubusercontent.com/mattny20/CompassDocs/main/install.sh \
  | COMPASSDOCS_EDITION=enterprise COMPASSDOCS_TLS=1 bash

Apply your license

The setup wizard has a license-key field — paste your key while creating the admin account and Enterprise features activate immediately. You can also apply or replace it any time under Settings → License, which shows the edition (Enterprise), the license status (Active), its seats and expiry, and which features it grants. See Applying an Enterprise License for the details, including the 14-day grace period.

For fully headless provisioning, bake the key in at install time instead:

curl -fsSL https://raw.githubusercontent.com/mattny20/CompassDocs/main/install.sh \
  | COMPASSDOCS_EDITION=enterprise COMPASSDOCS_LICENSE_KEY=eyJ... bash

Compose by hand

Prefer to manage the compose file yourself? Grab deploy/docker-compose.ee.yml, save it as docker-compose.yml, add a .env with a strong POSTGRES_PASSWORD (and optionally COMPASSDOCS_LICENSE_KEY), then:

docker compose up -d

Updating

cd compassdocs && docker compose pull && docker compose up -d

Pin a specific version with COMPASSDOCS_EE_VERSION in .env (image tags have no v prefix, e.g. 0.13.0); it defaults to latest.

Everything else is identical

Custom domain & HTTPS, backups, users & roles, and updates all work exactly as in Community — configure them from Settings. See Self-Hosting with Docker for the shared basics.

Note

The Enterprise image contains the enterprise feature code; a valid license then activates the features your plan includes. Running it without a license is supported and behaves like Community — nothing is held hostage.

Pricing & trials

See pricing for plans, and ask about a time-limited trial license to evaluate SSO, directory sync, and Entra group sync against your identity provider — and to pilot training & onboarding with a real deck.