customsso-manager documentation

Fleet SSO controller for FreePBX. This documentation set covers install, day-to-day operation, and the security model.

Contents

• Fresh install — pick OS
• › Oracle Linux 9 / 10
• › Debian 12 / 13 · Ubuntu
• Deployment guide
• Pairing a PBX
• Operations guide
• Native UI over HTTPS
• UCP admin impersonation
• Manager-side cron scheduler
• Backup & disaster recovery
• Recovery
• Security model
• Threat model
• Timezone / clock

Quick install

curl -sSfL https://git.voip-stuff.net/customsso-manager/install.sh -o /tmp/setup.sh && sudo bash /tmp/setup.sh

Full walk-through: Fresh install.

Reference bundles (reusable patterns, MIT)

Self-contained snippets extracted from the manager codebase for reuse in other self-hosted PHP projects. Each includes source files + a design README + a port-review checklist.

• First-run boot-token setup — first-admin bootstrap without a default credential. One-shot install-time URL that self-destroys on use. Full pattern: controller + view + reset helper + install snippet + route wiring + security checklist.