NOTE: Please be aware this documentation isn't necessary in step with the current code. Consider contributing by updating it with your findings!

Wave in a Box is delivered as a Java application. Installation comprises installing the server code and (optionally) configuring federation with XMPP.

Server installation

Getting Java

Ensure you have Java 8 installed before attempting to install Wave in a Box

From release package

Apache Wave releases can soon be downloaded from the release repository, and are packaged for UNIX and Windows systems.


$ wget
$ tar -jxf apache-wave-bin-0.4.tar.gz
$ cd apache-wave-bin-0.4.0-incubating


From source package

Should you want to build from source please use Java 7 for now, as changes in the latest JDK broke the build of this release.


$ wget
$ tar -jxf apache-wave-src-0.4.tar.gz
$ cd apache-wave-src-0.4.0-incubating

$ ant

You can find the most up-to-date (but possibly unstable) sourcecode at or git://

Running the server

Run the server with

$ ./

Running the webclient

Once you have followed the instructions on this page about how to get the server running you should be able to reach the web client by going to: http://localhost:9898 when running locally or by contacting port 9898 on the machine running the server

Further steps

This will get you as far as having a basic Wave server for testing and playing, but other steps should or could be taken:

  • Using SSL certificates
  • Using MongoDB as data store
  • Use Federation to contact with other Wave servers
  • Enable Wave Extensions

You can find the most up-to-date documentation at or git://


  • No labels


  1. I think the RC10 release requires jdk 1.7. 

    1. Hm. Tested and working with both Oracle + OpenJDK Java 8, just building needs Java 7.

      (only kicked the tires, though)