XMPP Web

Lightweight web chat client for XMPP server.

Table of contents

• Key features
• Installation
  • Ansible
  • Archive
  • Docker image
  • Build from source
• Upgrade
  • Archive
  • Docker image
• Configuration
• Contributing
• Credits
• License

Key features

• Connect to an XMPP server with WebSocket,
• Chat and groupchat (MUC as defined in XEP-0045),
• Retrieve contacts (roster) and bookmarked rooms (XEP-0048),
• Send and receive files over HTTP (XEP-0066, XEP-0363),
• Handle password protected room,
• Display and send chat state notifications: is composing, is paused (XEP-0085),
• Format messages: bold, italic, striked, link and code inline/block (XEP-0393),
• Pick emoji,
• Room creation and configuration,
• Apply message moderation (XEP-0425),
• Display and edit vCard information (in particular the user avatar, XEP-0054),
• PWA (Progressive Web App) creating user experiences similar to native applications on desktop and mobile devices,
• Lightweight (600 KB gzipped at the first loading and then less than 10 KB)
• Guest access /guest?join={jid} (joining a MUC anonymously as described in RFC 4505)

Installation

There are 4 different ways to install XMPP Web:

• using Docker image (easiest, strongly recommended),
• using release archive,
• build from source code (latest code but hardest).
• from provided Ansible role (not maintained),

Ansible

Long time ago, we provided an Ansible role. It had not been updated since 2020 and nobody used it, it is not maintained anymore. You can still use it but it will not set all the relevant configuration in local.js.

Archive

You can download latest .tar.gz archive, unpack files in web directory and configure:

• download latest release,
• unarchive,
• set files owner (example: www-data with Apache),
• create Apache virtual host,
• configure local.js.

wget https://github.com/nioc/xmpp-web/releases/latest/download/xmpp-web-0.9.7.tar.gz \
  -O /var/tmp/xmpp-web.tar.gz \
  && cd /var/www \
  && tar -xvzf /var/tmp/xmpp-web.tar.gz \
  && chown www-data /var/www/xmpp-web/ -R

Docker image

On each release, we also build a Docker image which is the latest stable Nginx (Alpine variant in order to keep lightweight) serving the generated assets. Configuration in local.js is set up according to environment variables (names and meanings are explained in configuration section).

This can be used:

• as standalone service:

  docker run -it -p 80:80 --rm \
  -e XMPP_WS=https://domain-xmpp.ltd:5281/xmpp-websocket \
  -e APP_DEFAULT_DOMAIN=domain-xmpp.ltd \
  --name xmpp-web-1 nioc/xmpp-web

• in a docker-compose.yml file:

  version: "3.4"
  services:
  xmpp-web:
    image: nioc/xmpp-web:latest
    ports:
      - "80:80"
    environment: 
      - XMPP_WS=https://domain-xmpp.ltd:5281/xmpp-websocket
      - APP_DEFAULT_DOMAIN=domain-xmpp.ltd

Build from source

If you want the latest code without waiting for the next release, you can clone this repo, build assets and copy dist files in web directory:

git clone https://github.com/nioc/xmpp-web.git xmpp-web
cd xmpp-web
npm ci
npm run build
nano dist/local.js
mv dist /var/www/xmpp-web
chown www-data /var/www/xmpp-web/ -R

Upgrade

Archive

Use the same method as installation or use the update.sh script. After that, do not forget to edit local.js.

Docker image

Use docker pull nioc/xmpp-web:latest and check if there is some new environment variables to set.

Configuration

Contributing

If you have a suggestion for a feature you think would enhance this product, please submit a feature request. Pull requests are welcomed (please create feature request for discussing it before), see contributing.

Credits

• Nioc - Initial work

See also the list of contributors to this project.

This project is powered by the following components:

• xmpp.js (ISC)
• Vue.js (MIT)
• Pinia (MIT)
• Vue Router (MIT)
• Day.js (MIT)
• Bulma (MIT)
• Oruga (MIT)
• Fork Awesome (SIL OFL 1.1)

License

This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for details