Platform: FusionPBX on Server 5 (pbx.xzopiasecure.com)
SIP transport: TLS on port 5061 (not 5060 — plaintext disabled)
Codecs: G.711a (PCMA), G.711u (PCMU), G.729, Opus
Store a copy of this guide in Vaultwarden: "VoIP Credentials" → "Zoiper Config Guide"
Before configuring Zoiper, you need an extension created in FusionPBX:
| Field | Value |
|---|---|
| Username | 1001 (your extension number) |
| Password | Extension password from FusionPBX |
| Domain / Hostname | pbx.xzopiasecure.com |
| Port | 5061 |
| Transport | TLS (mandatory — port 5060 is UK-geofenced) |
| STUN | stun.l.google.com:19302 |
FusionPBX supports auto-provisioning for supported phones. For Zoiper:
URL format:
https://pbx.xzopiasecure.com/app/provision/?mac=<device_mac>
*97 then your voicemail PIN| Problem | Check |
|---|---|
| "Registration failed" | Verify extension password in FusionPBX → Extensions |
| No audio on calls | STUN is needed if behind NAT — use stun.l.google.com:19302 |
| Can't connect from abroad | UK geofencing is enabled — SIP from non-UK IPs is blocked by design |
| TLS errors | Verify the Let's Encrypt cert is valid: curl -I https://pbx.xzopiasecure.com |
| Registration drops | ClientAliveInterval on SSH is 300s — not related. Check Zoiper keep-alive: Options → SIP options → Register every 60s |
| Extension | Assigned to | Notes |
|---|---|---|
| 1001 | Simon Killen | Main mobile |
| 1002 | TBC | TBC |
| 1000 | Ring group | All extensions |
| 9 | Outbound trunk | Dial 9 + number |
Update this table in Vaultwarden as extensions are created.
sip:1001@pbx.xzopiasecure.com:5061 (TLS) — for registered extensionssip:1001@pbx.xzopiasecure.com:5080 (UDP) — for SIP trunk registrationTrunk IPs are allowlisted in iptables. Extension TLS traffic uses the UK-geofenced 5061 port.
Navigate to: Advanced → Default Settings → Codec
Recommended codecs (in order):
PCMU@8000h|20i (G.711u — universal PSTN compatibility)PCMA@8000h|20i (G.711a — UK PSTN standard)G729@8000h|20i (low bandwidth — good for mobile data)opus@48000h|20i (high quality — Zoiper supports)Last updated: 08 June 2026 | Xzopia Limited (NI620366)