Akkoma/Pleroma

How to easily integrate a XMPP server with Akkoma or Pleroma. In the following we will concentrate on Akkoma (a better Pleroma fork), but Pleroma should work more or less the same.

Ejabberd external auth

The easiest way to integrate an Ejabberd XMPP server with Akkoma is to use the external auth script from the official Akkoma documentation. It works by directly interacting with the Akkoma http API.

Please note that these http requests are unencrypted and should only be done on the same server or in a secure internal network.

Akkoma bot for Ejabberd

Another easy to use option is to run a bot on your Akkoma instance that can be interacted with to register accounts via the Ejabberd API. You can find the necessary bot software here. The this bot also has some other nice functionality to get details from Ejabberd, so it might be worth running even if another account integration method is used.

Via LDAP

If you are setting up a new Akkoma or Pleroma instance, you might also consider managing the user accounts via a separate LDAP database as explained in the official Akkoma documentation here. Please refer to our dedicated LDAP tutorial for the XMPP server part.

Prosody

We are still looking into the best options to directly link Prosody to Akkoma or Pleroma. You might be able to use the same Oauth2 method as explained in the Mastodon integration tutorial or via a http basic auth module as explained in the Friendica tutorial.