Skip to content

Zoiper Softphone Setup

This guide covers configuring the Zoiper5 softphone to work with the Astradial cloud PBX.

Download and Install

Download Zoiper5 from https://www.zoiper.com/en/voip-softphone/download/current.

Available for Windows, macOS, Linux, iOS, and Android.

Account Configuration

Open Zoiper and create a new SIP account with the following settings:

Setting Value
Username org_mna9x47k_1001 (your assigned extension)
Password Get from your Astradial admin
Domain devsip.astradial.com:5080
Auth username Same as Username (leave blank if identical)
Caller ID Leave blank (set server-side)

Port 5080 is required

Many Indian ISPs block the standard SIP port 5060. Astradial runs SIP on port 5080 to avoid this. Always include :5080 in the domain field.

Transport and Network Settings

Navigate to the account's advanced/network settings:

Setting Value
Transport UDP
STUN Disabled
ICE Disabled
rport Enabled

Disable STUN

STUN must be disabled. Enabling STUN causes registration failures and obnoxious error popups in Zoiper. The server handles NAT traversal.

Audio Codecs

Recommended codec order:

  1. G.711 a-law (highest priority)
  2. G.711 u-law
  3. G.729 (if licensed)
  4. Opus

Registration Verification

After saving the account:

  1. Zoiper should show a green checkmark or "Registered" status.
  2. The registration expiry is typically 300 seconds (5 minutes).
  3. You should be able to make and receive calls.

To verify on the server side:

asterisk -rx 'pjsip show contacts'

Look for the extension in the output with status Avail.

Troubleshooting

401 Unauthorized

The server is rejecting the credentials.

Check Action
Wrong password Confirm the password with your admin. Passwords are case-sensitive.
Wrong username Verify the full username format: org_<orgid>_<ext>
Identify conflict Another device may be registered with the same IP. Check the server: asterisk -rx 'pjsip show endpoints'
Typo in domain Must be exactly devsip.astradial.com:5080

Identify section conflicts

If multiple PJSIP endpoints share the same source IP, Asterisk may match the wrong endpoint. This commonly happens when multiple users are behind the same office NAT. Check identify sections in PJSIP config on the cloud server.

SIP/UDP Not Found or Registration Timeout

The SIP packets are not reaching the server.

Check Action
ISP blocking 5060 Ensure domain includes :5080 (not the default 5060)
Firewall Check that UDP 5080 is allowed on the cloud server UFW rules
NAT/Router Try from a mobile hotspot to rule out office network issues
Transport Confirm transport is set to UDP, not TCP or TLS

STUN Error / obnoxious STUN popups

Zoiper shows repeated STUN-related errors or popups.

Solution: Disable STUN completely in the account's network settings. Astradial does not use STUN for NAT traversal.

  1. Go to Settings > Accounts > select your account > Advanced / Network.
  2. Set STUN to Disabled or remove any STUN server address.
  3. Restart Zoiper.

One-way Audio

You can hear the remote party but they cannot hear you, or vice versa.

Check Action
NAT traversal Confirm rport is enabled in Zoiper settings
Codec mismatch Ensure at least one common codec (G.711 a-law recommended)
Firewall RTP port range (10000-20000 UDP) must be open on the server
Local firewall Check that your OS firewall is not blocking Zoiper