Softphone Setup

Taridium's ipbx supports most SIP 2.0 compatible softphones. These quick guides will help you get started with our recommended softphone clients.

== CounterPath X-Lite ==

[[Image:xlite.png|100px|right]]

You can download X-Lite from [http://www.counterpath.net/x-lite.html CounterPath]. You have to be sure that you have already installed ipbx and configured your general SIP settings.

=== ipbx Setup ===

You can either use your softphone as your primary channel (main phone) or as an additional channel to your extension. For details on how to setup a user please follow the instructions [[Users|here]]. If you wish to setup your softphone as additional line and you have the Additional Line/Softphone module installed, follow the instructions [[Additional_Line/Softphone|here]].

You will need to know three configuration items to register your SIP phone. 

# Server IP address or DNS Name (usually SIP Proxy and Registrar)
# SIP user name
# SIP password (secret)

These details are generally displayed in the administrator's panel under '''Users''' → '''SIP Channels'''. Click on the [[Image:edit.gif]] button to see the corresponding user name and password (secret). If you have Additional Line/Softphone module installed you will see the details on your '''User Panel''' → '''Features''' → '''Additional Line/Softphone'''.

=== Client Setup ===

After installation, start the X-Lite client and right click to display the context menu '''SIP Account Settings...'''

[[Image:xlite-step1.png]]

Click on '''Add...''' to add a new account:

In this example we are using the following values:

* '''Display Name''': 4002 - The SIP display name
* '''User name''': 4002 - The SIP user name
* '''Authorization user name''': 4002 - the SIP authentication name
* '''Domain''': 10.10.10.10 - this is your server's IP address

In X-Lite the '''Domain''' is your registrar, proxy and domain.

[[Image:xlite-step2.png]]

Click on '''OK''' to save your settings and close the accounts dialog. X-Lite should immediately attempt to register with your ipbx system:

[[Image:xlite-step3.png]]

If you have trouble registering, re-check your username and password. Note that many registration issues that arise with softphones are caused by NAT problems. You will have to configure your network firewall accordingly and almost always have a public IP address setup on your ipbx system.