summaryrefslogtreecommitdiff
path: root/docs/config/howto_mongooseim.md
diff options
context:
space:
mode:
authorkaniini <nenolod@gmail.com>2019-05-22 04:06:54 +0000
committerkaniini <nenolod@gmail.com>2019-05-22 04:06:54 +0000
commit79c2cef2fbcbac99cce001376b8231e0e0a9adf4 (patch)
treed3e994e4930638103d8a8fea5e6ac14ad61dfb7c /docs/config/howto_mongooseim.md
parentab6e15622b0977a50408f4afb874e0b5b1704d2f (diff)
parentd378b342ba0d7f54be3b47f031c602a578191dfd (diff)
downloadpleroma-79c2cef2fbcbac99cce001376b8231e0e0a9adf4.tar.gz
pleroma-79c2cef2fbcbac99cce001376b8231e0e0a9adf4.zip
Merge branch 'mongooseim-support' into 'develop'
MongooseIM: Add basic integration endpoints. See merge request pleroma/pleroma!1172
Diffstat (limited to 'docs/config/howto_mongooseim.md')
-rw-r--r--docs/config/howto_mongooseim.md10
1 files changed, 10 insertions, 0 deletions
diff --git a/docs/config/howto_mongooseim.md b/docs/config/howto_mongooseim.md
new file mode 100644
index 000000000..a33e590a1
--- /dev/null
+++ b/docs/config/howto_mongooseim.md
@@ -0,0 +1,10 @@
+# Configuring MongooseIM (XMPP Server) to use Pleroma for authentication
+
+If you want to give your Pleroma users an XMPP (chat) account, you can configure [MongooseIM](https://github.com/esl/MongooseIM) to use your Pleroma server for user authentication, automatically giving every local user an XMPP account.
+
+In general, you just have to follow the configuration described at [https://mongooseim.readthedocs.io/en/latest/authentication-backends/HTTP-authentication-module/](https://mongooseim.readthedocs.io/en/latest/authentication-backends/HTTP-authentication-module/) and do these changes to your mongooseim.cfg.
+
+1. Set the auth_method to `{auth_method, http}`.
+2. Add the http auth pool like this: `{http, global, auth, [{workers, 50}], [{server, "https://yourpleromainstance.com"}]}`
+
+Restart your MongooseIM server, your users should now be able to connect with their Pleroma credentials.