This is an old revision of the document!


Chats

* [Home](help)

There are two possibilities to use chat on your friendica site

  • IRC Chat
  • XMPP / Jabber
  • Addon: irc

This addon is used to provide a web chat interface on your Friendica node to the IRC server freenode.net. After activating the addon, you can find the chat at example.com/irc. Note: you can use this chat without any login at your site so that everyone could use it.

If you follow the link, you will see the login page of the IRC chat. Now choose a nickname and a chatroom. You can choose any name you like for the room, even something like superchatwhosenameisonlyknownbyme. Finally, solve the captchas and click the connect button.

The following window shows some text while connecting. This text isn't important, just wait for the next window. The first line shows your name and your current IP address. The right part of the window shows all users. The lower part of the window contains an input field.

ejabberd

Prosody

If you want to use your Friendica installation for authentication with the prosody XMPP server, you have to do the following.

  1. Enable the auth_http_async module of prosody
  2. Adopt the configuration file (prosody.cfg.lua) of your prosody server to use Friendica for authentication (use your Friendica nodes domain instead of example.com)
authentication = "http_async";
http_auth_url = "https://example.com/api/account/verify_credentials.json";

You can now use your Friendica account credentials to login to your prosody, there is no need to register a new account on the XMPP server.

The two XMPP client addons in Friendica (JappixMini and XMPP) are outdated and may or may not work on your server.

Currently we advise to use a dedicated client program to use the XMPP accounts linked to the Friendica accounts.

Jappix Mini —

  • Addon: jappixmini

The Jappix Mini Addon creates a chatbox for jabber- and XMPP-contacts. You should already have a jabber/XMPP-account before setting up the addon. You can find more information at [jabber.org](http://www.jabber.org/).

You can use several servers to create an account:

1. Basics

At first you have to get the current version. You can either pull it from [Github](https://github.com) like so:

  $> cd /var/www/virtual/YOURSPACE/html/addon; git pull

Or you can download a tar archive here: [jappixmini.tgz](https://github.com/friendica/friendica-addons/blob/stable/jappixmini.tgz) (click at „view raw“).

Just unpack the file and rename the directory to „jappixmini“. Next, upload this directory and the .tgz-file into your addon directory of your friendica installation.

Now you can activate the addon globally on the admin pages. In the addon sidebar, you will find an entry of jappix now (where you can also find twitter, GNU Social and others). The following page shows the settings of this addon.

Activate the BOSH proxy.

2. Settings

Go to your user account settings next and choose the addon page. Scroll down until you find the Jappix Mini addon settings.

At first you have to activate the addon.

Now add your Jabber/XMPP name, the domain/server (without “http”; just “jappix.com”). For „Jabber BOSH Host“ you could use “https://bind.jappix.com/”. Note that you need another BOSH server if you do not use jappix.com for your XMPP account. You can find further information in the „Configuration Help“-section below this fields. At last you have enter your password (there are some more optional options, you can choose). Finish these steps with “send” to save the entries. Now, you should find the chatbox at the lower right corner of your browser window. If you want to add contacts manually, you can click “add contact”. === xmpp / Converse === * Addon: xmpp Alternative JavaScript web client that you can use instead of the JappixMini client.

  • Last modified: 2020-11-12 15:59