diff --git a/doc/Home.md b/doc/Home.md
index d1194a2b6e..e797f2129d 100644
--- 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 17e4b7dc29..758b8ef7a7 100644
--- 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
index 0000000000..a5b9469ab2
--- /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 a5eeb54511..27603612f3 100644
--- 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)