Fonality Knowledge Base - Welcome! > IP Phones > Softphone > How do I install a Softphone?

How do I install a Softphone?

Need to download the softphone application?   http://cp.fonality.com/softphone

Make sure that you have your softphone license key written down somewhere as you will need it during the installation process.

  1. Plug your headset into your computer's headset port (sometimes located on the front of the computer)
  2. Log into the PBXtra Admin Panel at using your server’s admin username and password.
  3. Click the “Extensions” tab, and locate the extension you wish to pair with the softphone. Click on the extension number and review all off the settings for accuracy (email address, web username, web password, etc.)
  4. Set the “Phones/Devices” drop-down menu to the softphone (e.g. SOFTPHONE001).
  5. Click “Apply all changes” once you have selected all of your desired settings.
  6. Run the softphone installer: http://cp.fonality.com/softphone
  7. When the installer runs, enter your registration key (from the CSV file emailed when you ordered your softphone(s).
  8. When you complete the installation wizard, your phone will be fully configured with the correct extension and device information.

Standard Softphone Settings

  • Display name: EXTN
  • Username: SOFTPHONEXXX
  • Password: EXTN
  • Authorization Username: SOFTPHONEXXX
  • Domain: sNNNN.pbxtra.fonality.com
  • [x] Register with domain
  • [x] Use as outbound proxy
  • [_] Manual override
  • [_] (SIP listen port) Manual override

Troubleshooting

Remote Softphones

Change your Domain value to sNNNNx.pbxtra.fonality.com and make sure that your connections at both ends (remote softphone & PBXtra ) are open on UDP port 5060 and the UDP port range 9710-20000.

After adding the 'x' the softphone still will not register

There is a known-issue with the Fonality Softphone where adding the 'x' to the registrar server string does not allow the Softphone to be used remotely.  The following work-around has been qualified and approved by Fonality Tech Support:

  1. Launch the Fonality Softphone
  2. Right-click on the Softphone and select Settings
  3. Select the Server option underneath SIP Accounts (see the image below)
  4. Check the Manual Override option underneath Domain Proxy (please be careful - there are two identical options that say "Manual Override" in this section)
  5. Fill in sNNNN.pbxtra.fonality.com in the text box next to the word Host (note: you do not need to use the 'x' in this case)
  6. Click Apply
  7. Now UNCHECK the Manual Override option (you are UNDOING everything you just accomplished)
  8. Click Apply
  9. Click Close
  10. The Softphone should register with your server. 

softphone.jpg

The work-around documented here need only be performed the first time you attempt to use the Softphone from a location remote to your server.  Once you have completed these steps once, the Softphone can be taken to your office and then taken back out to a remote location and register correctly (you must keep in mind that the x in the registrar string needs to be removed when you are local, and added when you are remote each and every time).

Tag page