Zoiper and Jabber

The example setup steps below show how to set up an Ejabberd server on Ubuntu 12.04 LTS.

The steps use examples from Ubuntu's help pages at:

https://help.ubuntu.com/community/SettingUpJabberServer

Steps and configuration files on other Linux distributions and/or OSes may differ.

This tutorial is NOT a detailed guide for Ejabberd server administration. It shows only some basic steps necessary to get an Ejabberd server working.

Installation and configuration

Install the server with:

sudo apt-get install ejabberd

After insalling open /etc/ejabberd/ejabberd.cfg.

Optionally add your domain name(s) like that:

{hosts, ["localhost"]}.

becomes:

{hosts, ["localhost","servername.com"]}.

Also, create an admin user by chaning:

{acl, admin, {user, "", "localhost"}}.

to:

{acl, admin, {user, "adminname", "servername.com"}}.

Now, restart the service:

sudo service ejabberd restart

Finally, set the password for your admin user:

sudo ejabberdctl register adminname servername.com password

The ejabberd server is working and the basic configuration is done. Ejabberd comes with a web base management tool, available at:

http://servername.com:5280/admin

To log in enter the admin username and password.

Adding Users

To add new users open:

http://servername.com:5280/admin

and go to:

Virtual Hosts >> servername.com >> Users

or directly to:

http://servername.com:5280/admin/server/servername.com/users/

Fill in the "User" and "Password" fields and click on "Add User".

1. Start Zoiper.

   

2. Click on Settings.

   

3. Choose Preferences.

   

4. Click on "Create account".

   

5. Choose "XMPP" and click on "Next".

   

6. Type in your chat Username, your Password and your chat Domain name (server).

   

7. Set your account name.

   1. Your Account name (this is the name your new account will appear in Zoiper with) will be prefilled.
   2. Changed your Account name if necessary.
   3. Click on "Next".
   

8. Add more accounts if needed.

   1. If you wish to add more accounts click on "Add more".
   2. To finish click on "Close".
   

9. Click on "Register" to connect to the chat server.

   

10. Continue after being registered.

    Once you connect successfully, the label to the to right hand side of the "XMPP account options" section will change to "Registered".

    After that click on "OK".

    

11. To manually add a new chat contact click on "Add" on the bottom.

    

12. On the row "Manually add other contacts" click on "Add".

    

13. Enter some contact details.

    Fill in the new contact's "Display as" and all other desired Personal information fields and click on "Phone numbers" .

    

14. Set the contact Phone / URI

    1. In the "Presence and chat" section type in the new contact's chat URI.
    2. From the "Account" dropdown menu choose your chat account, you would like to new contact to be attached to.
    

15. Click on "OK".

    

16. Finish adding contact.

    1. A warning will appear, stating the new contact does not have any phone numbers assigned to.
    2. Click on "Yes" if you do not wish to add any phone numbers to the new contact.
    3. Otherwise click on "No" and add the desired information.
    

17. New contact has been added.

    1. The new contact will now appear in your Contacts list in Zoiper.
    2. Click on it to expand it.
    

18. Click on "Chat" to start a new chat.

    

19. Send a message to the contact.

    1. A new chat window will appear.
    2. Type in your messages and hit "Enter" or click on "Send" to send them.
    

20. You can now chat.