# Zoiper

> Connect the Zoiper softphone on Windows, Mac, iPhone or Android to a SIP device on your PBX.

- URL: https://kb.voipcloud.online/phones-and-apps/softphones/zoiper/
- Section: Phones and apps › Softphones
- Type: guide
- Applies to: All countries
- Last reviewed: 2026-11-09

Zoiper is a free third-party softphone for Windows, Mac, iOS and Android. You connect it to a **SIP device** on your PBX. Some Zoiper features, such as phonebook import, chat and push notifications, need a paid Zoiper licence, which isn't part of your PBX service.

**Tip:** Your provider's own [Webphone](https://kb.voipcloud.online/phones-and-apps/webphone/webphone-overview/) is tightly linked to the PBX and has more features. Use Zoiper if you need a third-party app.

## Before you start

1. Add a **SIP device** to the person's [User](https://kb.voipcloud.online/pbx/accept-make-divert/user/) under **Device configuration**, and click **Apply configuration**.
2. Open **Devices** at the top of the **PBX** tab and select the device. Keep its **SIP credentials** open: **Domain**, **Username** and **Password**.

The **Domain** shows the server address, a colon and the port. Copy it exactly as shown, including the port.

If **Transport protocol** shows **TLS**, [TLS encryption](https://kb.voipcloud.online/pbx/settings/general-settings/) is on for your PBX. The port in the **Domain** is then different, and you must set the app to use TLS instead of TCP, with SRTP (shown as **Media encryption**).

For the Zoiper mobile app, the device's settings also have a QR code under **Zoiper settings**. It works with the mobile app only; on a computer, enter the SIP credentials.

**Important:** Use each SIP device in one app or phone only. Signing in to the same SIP device on two apps or phones causes registration and call problems.

## Set up Zoiper on Windows or Mac

**Note:** Menus can change between versions. If a label is different, check the vendor's own help.

1. Download Zoiper from zoiper.com for your operating system and install it with the standard settings.
2. Open Zoiper. Enter the **Username** in the first field and the **Password** in the second, and click **Login**.

   ![Zoiper 5 login screen with the username and password blurred](https://kb.voipcloud.online/images/phones-and-apps/softphones/zoiper-login.webp)

3. In the hostname field, paste the **Domain**, including the colon and port. Click **Next**.

   ![Zoiper hostname step with the domain field blurred](https://kb.voipcloud.online/images/phones-and-apps/softphones/zoiper-hostname.webp)

4. Skip the authentication and outbound proxy step.
5. When Zoiper tests the connection, choose **SIP TCP**.

If you use Zoiper 5.5.7 or later, check the codecs to avoid audio problems:

1. Open **Accounts**, select the account and click **Advanced**.
2. Under **Audio codecs**, remove any G.729 codecs from **Selected codecs**. The PBX supports Opus, G.722, G.711 a-law and G.711 mu-law.

## Set up Zoiper on Android

1. Install Zoiper from Google Play and open it.
2. Under **Account setup**, enter the **Username** and **Password** and tap **Login**.
3. Paste the **Domain** into **hostname or provider**, including the port, and tap **Next**.
4. Tap **Skip** on the authentication and outbound proxy step.
5. Choose **SIP TCP**.

![Zoiper Android account setup steps, with the credentials blurred](https://kb.voipcloud.online/images/phones-and-apps/softphones/zoiper-android.webp)

If you've used Zoiper before, open **Settings**, choose your account and enter the details under **SIP Account** instead.

For better reliability, open **Settings** › **Network Settings** and review the options there. Some need Zoiper Premium.

## Set up Zoiper on iPhone

1. Install Zoiper from the App Store and open it.
2. Go to **Settings** › **Accounts**, tap **+** and accept the warning.
3. Enter the **Username**, **Password** and **Domain** (including the port) manually.
4. In your iPhone settings for Zoiper, allow notifications, background app refresh and mobile data.
5. In Zoiper, go to **Settings** › **Incoming calls** to turn on push notifications. This may need Zoiper Premium.

**Note:** iOS and Android stop apps running in the background, so Zoiper may miss incoming calls when it isn't open. For reliable incoming calls, Zoiper needs its push service (Apple push notifications on iOS, Firebase Cloud Messaging on Android). See Zoiper's own help on its push proxy.

## Check it works

1. In **PBX** › **Devices**, the SIP device's status changes from **Offline** to **Online**.
2. Make a test call and ask someone to call you, to check your headset and that calls ring.

If it stays offline, check the details and see [Softphone errors](https://kb.voipcloud.online/phones-and-apps/softphones/softphone-errors/). A device that tries to register with a wrong password is blocked, and the block lifts after 5 minutes. Fix the details, wait, then try again.

## Load your PBX phonebook into Zoiper

This needs a Zoiper Premium licence and the latest version of Zoiper.

1. In the PBX, open **Phonebooks** and choose the phonebook. Click **URLs**, then **XML Zoiper URL**, and copy the link that opens. See [Phonebooks](https://kb.voipcloud.online/pbx/settings/phonebooks/).
2. In Zoiper, open **Settings** › **Contacts**.
3. Click **Add**, choose **XML** from the list, then click the smaller **Add** button.
4. Paste the link into the local/URL path field and leave the authentication type as **Don't use**.
5. Click **XML Contact Service 1** on the left to save.

The contacts appear in the **Contacts** tab on the Zoiper home screen.

## Chat between Zoiper users

Zoiper's chat needs Zoiper Premium, and only works between Zoiper users on your PBX.

1. In **Settings**, select the account, click **Advanced** and, under features, turn on subscribe and publish presence. Save.
2. Add each colleague as a Zoiper contact (calling their internal number is the quickest way), and choose your account for presence.
3. Open the contact to see their status and send a message. Each colleague must turn on presence too.

## Related

- [Devices](https://kb.voipcloud.online/pbx/settings/devices/)
- [Softphone errors](https://kb.voipcloud.online/phones-and-apps/softphones/softphone-errors/)