Documentation for installing a synchronized ejabberd

diff --git a/doc/Home.md b/doc/Home.md
index d1194a2b6e3418ba3f3226b7896f18fb63fef2cd..e797f2129dbd8ac550961fba8f60e771842a713c 100644 (file)
--- a/doc/Home.md
+++ b/doc/Home.md
@@ -30,6 +30,7 @@ Friendica Documentation and Resources
 * [Install](help/Install)
 * [Settings](help/Settings)
 * [Installing Connectors (Twitter/GNU Social)](help/Installing-Connectors)
+* [Install an ejabberd with synchronized credentials](help/install-ejabberd.md)
 * [Message Flow](help/Message-Flow)
 * [Using SSL with Friendica](help/SSL)
 * [Twitter/GNU Social API Functions](help/api)

diff --git a/doc/de/Home.md b/doc/de/Home.md
index 17e4b7dc29a8c6ea6ced671c88eea43ea4e8c54b..758b8ef7a744f5ce704eac58a2a66d167ec24274 100644 (file)
--- a/doc/de/Home.md
+++ b/doc/de/Home.md
@@ -32,6 +32,7 @@ Friendica - Dokumentation und Ressourcen
 * [Konfigurationen](help/Settings)
 * [Plugins](help/Plugins)
 * [Konnektoren (Connectors) installieren (Twitter/GNU Social)](help/Installing-Connectors)
+* [Installation eines ejabberd Servers mit synchronisierten Anmeldedaten](help/install-ejabberd.md) (EN)
 * [Nachrichtenfluss](help/Message-Flow)
 * [Betreibe deine Seite mit einem SSL-Zertifikat](help/SSL)
 * [Entwickler](help/Developers)

diff --git a/doc/install-ejabberd.md b/doc/install-ejabberd.md
new file mode 100644 (file)
index 0000000..a5b9469
--- /dev/null
+++ b/doc/install-ejabberd.md
@@ -0,0 +1,33 @@
+Install an ejabberd with synchronized credentials
+=================================================
+
+* [Home](help)
+
+Installation
+------------
+
+- Change it's owner to whichever user is running the server, ie. ejabberd
+
+        $ chown ejabberd:ejabberd /path/to/friendica/include/auth_ejabberd.php
+
+- Change the access mode so it is readable only to the user ejabberd and has exec
+
+        $ chmod 700 /path/to/friendica/include/auth_ejabberd.php
+
+- Edit your ejabberd.cfg file, comment out your auth_method and add:
+
+        {auth_method, external}.
+        {extauth_program, "/path/to/friendica/include/auth_ejabberd.php"}.
+
+- Disable the module "mod_register" and disable the registration:
+
+        {access, register, [{deny, all}]}.
+
+- Restart your ejabberd service, you should be able to login with your friendica credentials
+
+Other hints
+-----------
+- if a user has a space or a @ in the nickname, the user has to replace these characters:
+  - " " (space) is replaced with "%20"
+  - "@" is replaced with "(a)"
+

diff --git a/doc/readme.md b/doc/readme.md
index a5eeb54511942bb1d5daeb007a3a6ab84bbb1ad1..27603612f35caedf9d521766598b67cbd38c0bb3 100644 (file)
--- a/doc/readme.md
+++ b/doc/readme.md
@@ -30,6 +30,7 @@ Friendica Documentation and Resources
 * [Settings](help/Settings)
 * [Plugins](help/Plugins)
 * [Installing Connectors (Twitter/GNU Social)](help/Installing-Connectors)
+* [Install an ejabberd with synchronized credentials](help/install-ejabberd.md)
 * [Message Flow](help/Message-Flow)
 * [Using SSL with Friendica](help/SSL)
 * [Developers](help/Developers)