Fresh-install checklist — pick your OS

customsso-manager v0.6.0+ supports two operating-system families. The same install.sh runs on both; the OS-specific steps you take BEFORE running it are what differ.

Pick the guide that matches your VPS:

• Fresh install on Oracle Linux 9 / 10 — the primary, most-tested target. RHEL / Rocky / AlmaLinux 9-10 also ride this branch (less formally tested).
• Fresh install on Debian 12 / 13 — added in v0.6.0. Ubuntu 22.04 / 24.04 usually work here too (Debian-derived; less tested).

Which should I pick?

• Managing a FreePBX fleet? Your PBXes are Debian-native — running the manager on Debian keeps the whole stack on one OS family.
• Standardized on Oracle Linux for your infrastructure? OL9 is the primary target and has the deepest test coverage.
• Have LUKS boot-time unlock or Tang/Clevis network-bound disk encryption already set up? Either OS works; the manager doesn't care what's underneath.

What both guides get you

• HTTPS-served manager UI on port 443 (self-signed cert generated at install; swap for Let's Encrypt or a corporate PKI cert whenever)
• First admin account created via a boot-token URL (no default password)
• One paired FreePBX box reachable through the manager UI at the end of the walk-through

Expected wall time from a clean VPS: 10 minutes on either OS.

Common minimums

• 1 vCPU / 1 GB RAM; 2 / 2 recommended for fleets over ~20 PBXes
• 10 GB free on / (install footprint is ~3 GB; leaves room for logs / jobs / MariaDB)
• Root SSH access
• Outbound git.voip-stuff.net:443 (release tarball) + deb.debian.org:443 on Debian OR the Oracle Linux mirror on OL
• At least one FreePBX 16/17 with root SSH for smoke-testing the pair flow
• SMTP relay for 2FA + password-recovery + fleet alerts (can be filled in after install via Settings → Mail)