]> git.mxchange.org Git - friendica.git/blob - doc/install-ejabberd.md
Merge pull request #2315 from silke/documentation
[friendica.git] / doc / install-ejabberd.md
1 Install an ejabberd with synchronized credentials
2 =================================================
3
4 * [Home](help)
5
6 [Ejabberd](https://www.ejabberd.im/) is a chat server that uses XMPP as messaging protocol that you can use with a large amount of clients. In conjunction 
7 with the "xmpp" addon it can be used for a web based chat solution for your users.
8
9 Installation
10 ------------
11
12 - Change it's owner to whichever user is running the server, ie. ejabberd
13
14         $ chown ejabberd:ejabberd /path/to/friendica/include/auth_ejabberd.php
15
16 - Change the access mode so it is readable only to the user ejabberd and has exec
17
18         $ chmod 700 /path/to/friendica/include/auth_ejabberd.php
19
20 - Edit your ejabberd.cfg file, comment out your auth_method and add:
21
22         {auth_method, external}.
23         {extauth_program, "/path/to/friendica/include/auth_ejabberd.php"}.
24
25 - Disable the module "mod_register" and disable the registration:
26
27         {access, register, [{deny, all}]}.
28
29 - Enable BOSH:
30   - Enable the module "mod_http_bind"
31   - Edit this line:
32
33         {5280, ejabberd_http,    [captcha, http_poll, http_bind]}
34
35   - In your apache configuration for your site add this line:
36
37         ProxyPass /http-bind http://127.0.0.1:5280/http-bind retry=0
38
39 - Restart your ejabberd service, you should be able to login with your friendica credentials
40
41 Other hints
42 -----------
43 - if a user has a space or a @ in the nickname, the user has to replace these characters:
44   - " " (space) is replaced with "%20"
45   - "@" is replaced with "(a)"