Q. Why am I not getting sound or vibration alerts?

A.  Make sure they are enabled in the settings screen. In addition for sound alerts, make sure the silence switch is not turned on.  Finally, both sound and vibrate only occur when the screen  is locked or the app is running in the background. In other cases it is assumed that you are looking at the monal app and dont need the additional notification of a new message.


Q. How do I remove contacts?

A. Swipe on them on the contacts screen and then tap remove.


Group chat (MUC)

Monal supports XMPP MUC (Multi user chat)

Using Group Chat

If  a group chat room is entered, Monal will join it  and it will show up in both the  active chats list and as an online “user” in the contacts list.  Talking in a group chat is the exact same as talking in a normal one. When entering a room, Monal requests the server send the last 5 messages  of the conversation if it is available.


If invited to a room, Monal will ask to accept the invitation and join the room if accepted.


Joining a Room

A room is joined by going to In the More-> Group chat.

If the server supports it, Monal will discover at login what the address of the group chat service is.    The server field on this page  will be  filled with the correct information if it is discovered.

After entering the room name  and a password if necessary, tap join to enter the chat. Monal will either connect or return an error.

Leaving a Room

To leave a room, swipe the item in active chats and  press the close button.

Setting Nickname

Not available in the current build but will be available in the future.

Searching Rooms

Not available in the current build but will be available in the future.

Searching  Users

Not available in the current build but will be available in the future.

Openfire, Jabberd and any other XMPP/Jabber server

Openfire, Jabberd, ejabberd,prosody etc are all standard XMPP (Jabber) servers.

When setting up a standard XMPP/Jabber account, select XMPP in the Accounts tab.

In the account set up screen first try entering your username under Jabber ID. The username  is almost always  like an email address and would look something like user@domain.com. Enter the password and enable the account.  After saving and returning to the accounts page Monal will try to connect. For simple configurations with one server and domain this will automatically work.

If this does not work, edit the saved account by tapping on it in the Accounts tab.  Scroll down and look at the Advanced Settings.  It is highly recommended that you check with the XMPP server administrator to determine what the server,  port and SSL  settings should be. The resource does not matter.   Manually enter the new server name and port  and enable/disable SSL.  Save by returning back to Accounts.  Monal should now correctly connect.

Common quick fixes

1. If you are not sure about the SSL setting, try once with it on and off.  if it works with both, always turn SSL on if it works.

2. The port is almost always  5222.  Some SSL systems require 5223.  Normally it is never 5223 unless SSL is also enabled.

3. It is possible your set up is different. In some configurations, username is just a name without a domain. Check with your IM server administrator to find out how it should be





Facebook chat is possible after creating a Facebook username. If you haven’t already done so, go to http://www.facebook.com/username and create a username.

In Monal, select Accounts and then Facebook under Add New Account

In the following page, enter the  facbeook username  under Jabber ID and password and enable the account. The Jabber ID will always be in the form facebookusername@chat.facebook.com. The password is the regular facebook password for the account.  Leave all other settings alone.

When first logging in, it is possible Monal will be slower on older iPhones as it downloads all the pictures for every facebook friend who is online. This is only happens on the first login.

Cisco Webex

Cisco Webex connections are standard XMPP connections. To set up a new connection, go to the accounts tab and select XMPP connection.


Here you need to enter your Jabber ID. This is the Webex login this would be in the form xxx@yourdomain.com. Enter your password and then enable the account. Return to the accounts screen and it should auto connect.

You do not ordinarily  need to adjust any other settings.

The resource setting does not matter and the port setting  and server settings should be left alone.