Backups can contain the keys to the system
Configuration backups can include endpoint and carrier secrets, user information and network settings. Depending on scope, voicemail or recordings may also be present. A backup repository therefore needs access protection comparable to the production data it can restore.
Keep production trunk identities from registering during a restore exercise. Include the dependencies needed to decrypt and use the backup.
Separate storage and authority
Keep a recovery copy away from the PBX host and limit who can read or delete it. Protect encryption keys and storage credentials, while ensuring authorized recovery operators can obtain them during an outage.
Inspect job scope
Compare installed modules and custom files with the backup selection. Verify completion logs and that the artifact reached its destination. A scheduled job definition is not evidence that usable backups exist.
Restore without creating a second production PBX
Use an isolated target so copied trunk credentials cannot register or place calls unexpectedly. Validate routes, selected content and manual recovery steps. Record missing items and restore duration. Use the FreePBX recovery guide for its module-aware process.
Authenticate the recovery input
FreePBX's 2026 restore advisories explicitly treat backup archives as a security boundary. Record a hash when the artifact is created, preserve provenance and custody, restrict restore privileges and network access, update the restore module before import, and verify administrator authentication after recovery. Encryption protects confidentiality but does not by itself prove origin or integrity.
Scope FreePBX destination identities to one recovery purpose
FreePBX Filestore can hold passwords, tokens, SSH keys and cloud credentials for several destination types. The destination guide keeps secret custody, path scope, rotation, retention and independent retrieval explicit.
Sources & applicability
Primary references for the technical details above. Operational examples and planning checklists are VoIP.info editorial guidance.
- Asterisk res_pjsip configuration ↗
- Asterisk release and support policy ↗
- FreePBX backup and restore ↗
- FreePBX Backup & Restore repository ↗
- FreePBX Backup & Restore job implementation — release/17.0 ↗
- FreePBX Backup & Restore restore implementation — release/17.0 ↗
- FreePBX security advisory GHSA-5v7h-49gr-jcwr ↗
- FreePBX security advisory GHSA-f6hc-rqxg-ch86 ↗
- Sangoma Filestore module ↗
- Sangoma fwconsole commands for FreePBX 15 and later ↗
- Sangoma Backup Information ↗
- Sangoma upgrading to FreePBX 17 ↗
- Sangoma FreePBX Backup and Restore Version 15+ ↗
- FreePBX Filestore release/17.0 source ↗
- FreePBX Filestore release/17.0 module metadata ↗