Docs File Cabinets self-hosting
File Cabinets — self-hosting
File Cabinets on Enterprise installs uses the same integration patterns as the rest of PilotBPM. See also docs/FILE-CABINETS-SELF-HOST.md in the repository.
Required
- PostgreSQL —
DATABASE_URL - Object storage — Admin → Integrations → Storage (S3, S3-compatible, or local
storage/)
Optional services
| Service | Config |
|---|---|
| Redis queue | REDIS_URL — background jobs; inline fallback when unset |
| KMS envelope encryption | Storage integration kmsKeyId + File Cabinets → Settings → Security |
| AI classification | Admin → AI — threshold at File Cabinets → Settings → Enterprise |
| SSO / MFA | Admin → Integrations → SSO — existing IdP; do not duplicate SAML/OIDC |
| System/tenant mailer or Microsoft 365 mail integration |
Enterprise settings
Tenant JSON presets are stored in FileCabinetConfig: role templates, retention templates, legal hold notes, sharing approval placeholder, and security alert thresholds.
Compliance CSV exports and retention/destruction workflows live under File Cabinets → Settings.