Apache Vysper

This project aims at delivering a server implementation of both the core and IM parts of the XMPP protocol (as specified in RFCs 3920 + 3921).

"Vysper" is pronounced like in "whisper".

XMPP is an open, secure and extensible instant messaging protocol which has evolved from Jabber. It provides interoperability features for communication with other XMPP and non-XMPP servers. It is used and supported by many IM applications, both client and server.

The protocol and its many extensions (called XEPs) are maintained by the XMPP Standards Foundation (XSF.

In addition to the basic protocol and many small extensions, Vysper currently comes with working implementations for Multi-User Chat (XEP-0045) [5] and Publish-Subscribe (XEP-0060) [6]

Building

You need Apache Maven 2, Maven 2.2.1 or later is recommended. Run mvn install and you should find a number of JAR files in different target/ folders. The different build artifacts are compiled in dist/.

Running

There are different ways to run Vysper

A ready-to-run setup is created by the build in dist/target/appassembler/ Under dist/target/appassembler/bin you'll find start scripts for Unix/Mac and Windows.

This makes use of the Spring-based server runtime. Main class is org.apache.vysper.spring.ServerMain and the bean configuration is located in server/core/src/main/config/spring-config.xml

There is a non-Spring runtime, too: org.apache.vysper.spring.ServerMain The source code shows how the different components are plugged together.

It can serve as a template for integrating Vysper in any other application. The class org.apache.vysper.xmpp.server.XMPPServer is built to make the server easily configurable and embeddable.

Configuration

Vysper uses SSL encryption per default. For this purpose, an TLS certificate is provided. It is highly recommended to create and use a self-generated certificate!

There is one preconfigured user ([email protected]). The password for this user is "CHOOSE A SECURE PASSWORD". Please change this password before starting!

Please note that the domain vysper.org is not running an XMPP server. If you go with the default setup and don't configure your own domain name, please note that you have to configure your Jabber clients to force the host name (for example the IP or localhost, depending on how you run it).