Skip to content

Configure Bria Softphone

Bria (CounterPath, now part of Alianza) is a popular commercial SIP softphone for desktop and mobile. UnifiedBX has a bria config helper that generates Bria-specific provisioning. Even without it, any SIP extension works with Bria — you just enter credentials manually.

Before You Start

  • A SIP extension exists for the user (see Add an Extension).
  • Bria desktop or mobile installed on the user's device.
  • The user has the extension number, Secret, and the UnifiedBX FQDN/IP.

Steps (manual provisioning)

In Bria:

  1. Settings → Accounts → SIP Account.
  2. Fill in:
    • Account Name — display label, e.g. WTG Office.
    • Display As — Username only.
    • Username — the extension number, e.g. 1001.
    • Password — the Secret from the extension.
    • Domain — UnifiedBX FQDN, e.g. pbx.client.com.
    • Authorization Name — same as Username.
    • Outbound Proxy — same as Domain (or blank if same).
    • Transport — TCP or TLS. Avoid UDP for mobile/NAT users.
    • Register — Yes.
  3. Save.
  4. Bria attempts to register. Successful registration shows a green dot.

Steps (Bria provisioning helper, if installed)

If the bria module is on the system:

  1. Go to System Admin → Bria.
  2. Pick the extension(s) to provision.
  3. Generate the QR code or provisioning URL.
  4. User scans QR with Bria mobile, OR enters URL on Bria desktop Help → Sign In with QR.
  5. Bria auto-configures the account.
  • Codecs: OPUS, G.722, ULAW (in that order). Restrict if you have bandwidth limits.
  • DTMF: RFC 2833.
  • Echo cancellation: ON.
  • Network: SIP keepalive 30 seconds for NAT traversal.
  • Quality: "Adaptive" for variable networks.

Verify

asterisk -rx "pjsip show endpoint 1001"

Bria's contact should appear under the endpoint with Available status.

Place a test call in/out from Bria.

Common Issues

  • Registration fails. Wrong Domain (don't use https:// — just the FQDN), or firewall blocking SIP from Bria's source IP. If user is at home, the home router may block outbound SIP — try TLS on port 5061.
  • One-way audio. NAT issue. Set Transport to TCP or TLS (avoids UDP NAT problems). On UnifiedBX side, ensure External Address is set in Sysadmin → Network Settings.
  • Calls drop after ~30 seconds. SIP keepalive too long; lower to 30s.
  • Mobile data eats audio. Codec wrong; switch to OPUS or G.722, drop ULAW.
  • Bria desktop crashes on Mac. Known with some Bria versions; update to latest.