hmLoadTopic({
hmKeywords:"BOSH server,Instant Messaging,Jabber,Webmail,Webmail Instant Messaging,Webmail Jabber,Webmail Webmail IM,Webmail XMPP,XMPP",
hmTitle:"XMPP",
hmDescription:"MDaemon is equipped with an Extensible Messaging and Presence Protocol (XMPP) server, sometimes called a Jabber server. This allows your users to send and receive instant...",
hmPrevLink:"caldav.html",
hmNextLink:"scheduling_antivirus-updates.html",
hmParentLink:"index.html",
hmBreadCrumbs:"Setup Menu &gt; Web &amp; IM Services",
hmTitlePath:"Setup Menu > Web & IM Services > XMPP",
hmHeader:"<h1 class=\"p_Heading1\" style=\"page-break-after: avoid;\"><span class=\"f_Heading1\">XMPP<\/span><\/h1>\n\r",
hmBody:"<p class=\"p_BodyText_Center\"><img style=\"margin:0 auto 0 auto;width:32.5000rem;height:26.0000rem;border:none\" src=\".\/images\/xmpp.png\"\/><\/p>\n\r<p class=\"p_BodyText\"><span class=\"f_BodyText\">MDaemon is equipped with an Extensible Messaging and Presence Protocol (XMPP) server, sometimes called a Jabber server. This allows your users to send and receive instant messages using <a href=\"wc--overview.html#comagent\" class=\"topiclink\">MDaemon Instant Messenger<\/a> and third-party <a href=\"http:\/\/xmpp.org\/xmpp-software\/clients\/\" target=\"_blank\" class=\"weblink\">XMPP clients<\/a>, such as <a href=\"https:\/\/pidgin.im\/\" target=\"_blank\" class=\"weblink\">Pidgin<\/a>, <a href=\"https:\/\/gajim.org\/\" target=\"_blank\" class=\"weblink\">Gajim<\/a>, <a href=\"https:\/\/swift.im\/swift.html\" target=\"_blank\" class=\"weblink\">Swift<\/a> and many others. Clients are available for most operating systems and mobile device platforms.<\/span><\/p>\n\r<p class=\"p_BodyText\"><span class=\"f_BodyText\">The XMPP server is installed as a Windows service, and the default server ports are 5222 (SSL via STARTTLS) and 5223 (dedicated SSL). The XMPP server will use MDaemon\'s SSL configuration if it is enabled in MDaemon. Also, some XMPP clients use DNS SRV records for auto-discover of host names. Please refer to <a href=\"http:\/\/wiki.xmpp.org\/web\/SRV_Records\" class=\"weblink\">http:\/\/wiki.xmpp.org\/web\/SRV_Records<\/a> for more information.<\/span><\/p>\n\r<p class=\"p_BodyText\"><span class=\"f_BodyText\">Users sign-in through their chosen XMPP client using their email address and password. Some clients, however, require the email address to be split into separate components for signing in. For example, instead of &quot;<\/span><span class=\"f_PlainText\">frank@example.com<\/span><span class=\"f_BodyText\">,&quot; some clients require you to use &quot;<\/span><span class=\"f_PlainText\">frank<\/span><span class=\"f_BodyText\">&quot; as the Login\/Username and &quot;<\/span><span class=\"f_PlainText\">example.com<\/span><span class=\"f_BodyText\">&quot; as the Domain.<\/span><\/p>\n\r<p class=\"p_BodyText\"><span class=\"f_BodyText\">For multi-user\/group chat service, clients typically display this as &quot;rooms&quot; or &quot;conferences.&quot; When you want to start a group chat session, create a room\/conference (giving it a name) and then invite the other users to that room. Most clients don\'t require you to enter a server location for the conference; you only need to enter a name for it. When you are required to do so, however, use &quot;<\/span><span class=\"f_PlainText\">conference.&lt;your domain&gt;<\/span><span class=\"f_BodyText\">&quot; as the location (e.g. <\/span><span class=\"f_PlainText\">conference.example.com<\/span><span class=\"f_BodyText\">). A few clients require you to enter the name and location together in the form: &quot;<\/span><span class=\"f_PlainText\">room@conference.&lt;your domain&gt;<\/span><span class=\"f_BodyText\">&quot; (e.g. <\/span><span class=\"f_PlainText\">Room01@conference.example.com<\/span><span class=\"f_BodyText\">).<\/span><\/p>\n\r<p class=\"p_BodyText\"><span class=\"f_BodyText\">Some clients (such as <a href=\"https:\/\/pidgin.im\/\" target=\"_blank\" class=\"weblink\">Pidgin<\/a>), support the user search service, allowing you to search the server for users by name or email address, which makes adding contacts much easier. Usually you will not have to provide a search location, but if asked to do so, use &quot;<\/span><span class=\"f_PlainText\">search.&lt;your domain&gt;<\/span><span class=\"f_BodyText\">&quot; (e.g. <\/span><span class=\"f_PlainText\">search.example.com<\/span><span class=\"f_BodyText\">). When searching, the % symbol can be used as a wildcard. Therefore you could use &quot;%@example.com&quot; in the email address field to display a list of all users with an email address ending in &quot;@example.com.&quot;<\/span><\/p>\n\r<p class=\"p_DialogSectionHeading\" style=\"page-break-after: avoid;\"><span class=\"f_DialogSectionHeading\">XMPP Server<\/span><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Enable XMPP Server<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">Click this option to enable the XMPP server. To allow instant messaging, you must also ensure that the <\/span><span class=\"f_ControlIndent\" style=\"font-weight: bold;\">Enable instant messaging<\/span><span class=\"f_ControlIndent\"> option is enabled on the <a href=\"wc--comagent-im.html\" class=\"topiclink\">MDIM<\/a> screen.<\/span><\/p>\n\r<p class=\"p_ControlHeading2\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading2\">Enable SSL<\/span><\/p>\n\r<p class=\"p_ControlIndent2\"><span class=\"f_ControlIndent2\">Click this option if you wish to support SSL for the XMPP Server, using the <\/span><span class=\"f_ControlIndent2\" style=\"font-style: italic;\">SSL Port<\/span><span class=\"f_ControlIndent2\"> specified below. <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">Note:<\/span><span class=\"f_ControlIndent2\"> This also applies to the BOSH server <\/span><span class=\"f_ControlIndent2\" style=\"font-style: italic;\">HTTPS Port<\/span><span class=\"f_ControlIndent2\"> option below.<\/span><\/p>\n\r<p class=\"p_ControlHeading2\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading2\">Port<\/span><\/p>\n\r<p class=\"p_ControlIndent2\"><span class=\"f_ControlIndent2\">The default port for XMPP is 5222, which supports SSL via STARTTLS.<\/span><\/p>\n\r<p class=\"p_ControlHeading2\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading2\">SSL Port<\/span><\/p>\n\r<p class=\"p_ControlIndent2\"><span class=\"f_ControlIndent2\">XMPP\'s dedicated SSL port is 5223.<\/span><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Restart XMPP Server<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">Click this button to restart the XMPP server.<\/span><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Log message conversation<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">By default all instant message conversations are logged in a file called <\/span><span class=\"f_PlainText\">XMPPServer-&lt;date&gt;.log<\/span><span class=\"f_ControlIndent\">, located in the <\/span><span class=\"f_PlainText\">MDaemon\\Logs\\<\/span><span class=\"f_ControlIndent\"> folder. Clear this checkbox if you do not wish to log conversations.<\/span><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Enable BOSH Server (for Webmail IM)<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">Click this option to enable the BOSH server, allowing instant messaging within MDaemon Webmail.<\/span><\/p>\n\r<p class=\"p_ControlHeading2\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading2\">HTTP Port<\/span><\/p>\n\r<p class=\"p_ControlIndent2\"><span class=\"f_ControlIndent2\">By default the BOSH server uses HTTP port 7070.<\/span><\/p>\n\r<p class=\"p_ControlHeading2\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading2\">HTTPS Port<\/span><\/p>\n\r<p class=\"p_ControlIndent2\"><span class=\"f_ControlIndent2\">The BOSH server uses this HTTPS port when the <\/span><span class=\"f_ControlIndent2\" style=\"font-style: italic;\">Enable SSL<\/span><span class=\"f_ControlIndent2\"> option above is activated. The default port is 7443.<\/span><\/p>\n\r<p class=\"p_ControlHeading2\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading2\">Hostname<\/span><\/p>\n\r<p class=\"p_ControlIndent2\"><span class=\"f_ControlIndent2\">Use this option to specify a Hostname if necessary.<\/span><\/p>\n\r<p class=\"p_DialogSectionHeading\" style=\"page-break-after: avoid;\"><a id=\"persistent_chat_rooms\" class=\"hmanchor\"><\/a><span class=\"f_DialogSectionHeading\">Configure Persistent Chat Rooms<\/span><\/p>\n\r<p class=\"p_BodyText\"><span class=\"f_BodyText\">Click this button to open the Group Chat Rooms dialog. Ordinarily, when a user creates a chat room it will disappear when the last person leaves the room, but you can use these options to create persistent chat rooms that will remain when empty. You can also delete rooms and convert existing, temporary rooms to persistent ones.<\/span><\/p>\n\r<p class=\"p_BodyText\"><img style=\"margin:0;width:34.9375rem;height:23.2500rem;border:none\" src=\".\/images\/xmpp_chat-rooms.png\"\/><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Select chat service<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">Select the chat service to display that domain\'s chat rooms.<\/span><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">New<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">Click this button to add a persistent chat room.<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><img style=\"margin:0;width:27.3750rem;height:12.7500rem;border:none\" src=\".\/images\/xmpp_new-chat-room.png\"\/><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Select chat service<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">Select the chat service for the room.<\/span><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Room name<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">Type a name for the chat room, without any spaces.<\/span><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Room description<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">Include a description of the room here. Users will see this when selecting a room to join.<\/span><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Password (optional)<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">If you wish to require a password in order to join the chat, enter the password here.<\/span><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Delete<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">If you wish to remove a room, select the room and click this button to delete it.<\/span><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Make Persistent<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">When a temporary chat room is in the list, select the room and click this button if you wish to make it persistent.<\/span><\/p>\n\r<p class=\"p_SeeAlso\" style=\"page-break-after: avoid; border-right: none; border-bottom: none; border-left: none;\"><span class=\"f_SeeAlso\">See:<\/span><\/p>\n\r<p class=\"p_SeeAlsoLinks\" style=\"page-break-after: avoid;\"><span class=\"f_SeeAlsoLinks\"><a href=\"wc--comagent-im.html\" class=\"topiclink\">Webmail » MDIM<\/a><\/span><\/p>\n\r<p class=\"p_BodyText\"><span class=\"f_BodyText\">&nbsp;<\/span><\/p>\n\r"
})
