lightweight xmpp server library
Last updated 5 years ago by chris-rock .
Apache 2 · Original npm · Tarball · package.json
$ cnpm install radiowave 
SYNC missed versions from official npm registry.


Radiowave is a lightweight XMPP server that is made for the web:

  • easy deployment
  • simple configuration via JSON
  • fast
  • rest api



# Start PostgresSQL
docker run --name radiowave-pg -e POSTGRES_PASSWORD=mysecretpassword -d postgres

# Start Radiowave
docker build -t radiowave .
docker run --name radiowave --link radiowave-pg:pg -d -p 5222:5222 -p 5280:5280 -p 9031:9031 -p 9030:9030 -p 8080:8080 radiowave

# detect ip if you are using boot2docker via `boot2docker ip`

# Debug Docker container
docker exec -it radiowave /bin/bash

By default three users are configured:

    "type": "simple",
    "testusers": true,
    "users": [{
        "user": "romeo",
        "password": "romeo"
    }, {
        "user": "mercutio",
        "password": "mercutio"
    }, {
        "user": "benvolio",
        "password": "benvolio"

Configure Adium

Adium Config Adium Config

Manual Installation

Prepare your server:

# debian
apt-get install libicu-dev

# mac (optional)
brew install icu4c
ln -s /usr/local/Cellar/icu4c/<VERSION>/bin/icu-config /usr/local/bin/icu-config
ln -s /usr/local/Cellar/icu4c/<VERSION>/include/* /usr/local/include

Adapt the settings/default.json to your needs. If you do not install a specific database, Radiowave will fallback to SQLite.

npm install -g radiowave
foreman start

Register as service

foreman export upstart /etc/init
service radiowave start

Features & Roadmap

✔ supported, ✘ not supported by Radiowave (yet)

Reference Description Supported
Core XMPP specifications
RFC-3920 Extensible Messaging and Presence Protocol (XMPP): Core XMPP Core mechanisms and routing
RFC-3921 XMPP: Instant Messaging and Presence XMPP IM and presence (✔)
RFC-6120 XMPP: Core RFC-3920 update
RFC-6121 XMPP: Instant Messaging and Presence RFC-3920 update (✔)
RFC-6122 XMPP: Address Format Format for user and services addresses
XMPP Server compliance
XEP-0212: XMPP Basic Server 2008 Compliance Specification
XEP-0216: XMPP Intermediate IM Server 2008 Compliance Specification
XEP-0243: XMPP Server Compliance 2009 Compliance Specification
XEP-0270: XMPP Compliance Suites 2010 Compliance Specification
XEP-0302: XMPP Compliance Suites 2012 Compliance Specification
XMPP Core Server Extensions
XEP-0030: Service Discovery Discover features and capabilities of server
XEP-0115: Entity Capabilities
XMPP Advanced Server Extensions
XEP-0045: Multi-User Chat Chat conferences with multiple users (✔)
XEP-0054: vcard-temp Business cards storage
XEP-0060: Publish-Subscribe Publish and subscribe over xmpp (✔)
XEP-0114: Jabber Component Protocol Server-side components
XEP-0124: BOSH BOSH HTTP Binding
XEP-0163: Personal Eventing Protocol user location, modd or activity
XEP-0191: Blocking Command Communication blocking
XEP-0198: Stream Management Stream commands
XEP-0206: XMPP Over BOSH Connect over HTTP with long-polling
XMPP Extensions
XEP-0004: Data Forms XML Forms for queries and responses
XEP-0092: Software Version Discover software release
XEP-0199: XMPP Ping Ping Pong for XMPP
XEP-0203: Delayed Delivery Offline messaging
DRAFT: Websocket Connect over HTTP with websockets
XEP-0307:Unique Room Names for Multi-User Chat Create unique room names
XMPP Security
XEP-0077: In-band Registration For account creators
XEP-0158: CAPTCHA Forms Prevent bots
XEP-0205: Best Practices to Discourage Denial of Service Attacks Prevent denial of service attacks


REST api

Radiowave ships with a REST api. To determine the own JID:

curl -s --user romeo:romeo | jq '.'
  "user": ""

Create a new MUC room via Rest API:

$ curl -s --user romeo:romeo | jq '.'

$ curl -s -X POST --user romeo:romeo --data  '{"name" : "romeo"}' http://localhost:8080/api/user/rooms --header "Content-Type:application/json" | jq '.'
  "id": 1,
  "name": "romeo",
  "updatedAt": "2015-05-01T13:33:41.000Z",
  "createdAt": "2015-05-01T13:33:41.000Z"

$ curl -s --user romeo:romeo | jq '.'
    "id": 1,
    "name": "romeo",
    "subject": null,
    "description": null,
    "createdAt": "2015-05-01T13:33:41.000Z",
    "updatedAt": "2015-05-01T13:33:41.000Z",
    "members": [
        "jid": "",
        "RoomMember": {
          "nickname": "",
          "role": "moderator",
          "affiliation": "owner",
          "state": "accepted",
          "createdAt": "2015-05-01 13:33:41.000 +00:00",
          "updatedAt": "2015-05-01 13:33:41.000 +00:00",
          "UserId": 1,
          "RoomId": 1


Radiowave uses sequelize as database abstractions layer. While it provides support for PostgreSQL, MySQL, MariaDB, SQLite and MSSQL, Radiowave is only tested on SQLite and PostgresSQL.

Radioware make heavy use of SQL transactions to ensure no data is corrupted. Since SQLite is not optimized for handling many parallel connection, I recommend to use PostgresSQL for production. Change the configuration file accordingly:

"storage": {
    "dialect" : "postgres",
    "native": true,
    "user": "postgres",
    "password" : "supersecretpassword",
    "database": "radiowave",
    "host": "localhost",
    "port": 5432


Radiowave uses bunyan as logger framework. To format the json output pipe the content to bunyan.

$ node bin/radiowave settings/default.json |bunyan

[2015-05-01T13:31:25.029Z] DEBUG: radiowave/35782 on Load file: /Users/chris/Development/xrocket/xrocketd/settings/default.json (widget_type=radiowave)
[2015-05-01T13:31:25.047Z] DEBUG: radiowave/35782 on Environment: development (widget_type=radiowave)
[2015-05-01T13:31:25.048Z] DEBUG: radiowave/35782 on port: 5222 (widget_type=radiowave)
[2015-05-01T13:31:25.048Z] DEBUG: radiowave/35782 on port: 5280 (widget_type=radiowave)
[2015-05-01T13:31:25.048Z] DEBUG: radiowave/35782 on port: 5281 (widget_type=radiowave)
[2015-05-01T13:31:25.048Z] DEBUG: radiowave/35782 on port: 8889 (widget_type=radiowave)
[2015-05-01T13:31:25.048Z] DEBUG: radiowave/35782 on port: 8080 (widget_type=radiowave)
[2015-05-01T13:31:25.049Z] DEBUG: radiowave/35782 on load storage module (widget_type=radiowave)
[2015-05-01T13:31:25.050Z] DEBUG: radiowave/35782 on initialize (widget_type=storage)
[2015-05-01T13:31:25.234Z] DEBUG: radiowave/35782 on load connection manger (widget_type=radiowave)
[2015-05-01T13:31:25.241Z] DEBUG: radiowave/35782 on load xmpp components (widget_type=radiowave)
[2015-05-01T13:31:25.241Z] DEBUG: radiowave/35782 on Configure domain: (widget_type=radiowave)
[2015-05-01T13:31:25.245Z]  INFO: radiowave/35782 on load components Core (widget_type=radiowave)
[2015-05-01T13:31:25.246Z] DEBUG: radiowave/35782 on load core modules (widget_type=core)
[2015-05-01T13:31:25.247Z]  INFO: radiowave/35782 on load RFC 3921: Roaster (widget_type=roaster)
[2015-05-01T13:31:25.247Z] DEBUG: radiowave/35782 on load module: RFC 3921: Roaster (widget_type=xcomponent)
[2015-05-01T13:31:25.248Z]  INFO: radiowave/35782 on load XEP-0016: Privacy Lists (widget_type=privacylist)
[2015-05-01T13:31:25.248Z] DEBUG: radiowave/35782 on load module: XEP-0016: Privacy Lists (widget_type=xcomponent)
[2015-05-01T13:31:25.248Z]  INFO: radiowave/35782 on load XEP-0030: Service Discovery (widget_type=disco)



Copyright 2013 - 2015 Christoph Hartmann

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Current Tags

  • 0.7.0                                ...           latest (5 years ago)

1 Versions

  • 0.7.0                                ...           5 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (25)
Dev Dependencies (11)
Dependents (0)

Copyright 2014 - 2016 © |