Warning! Not everything described on this page is ready just yet. In the mean time, please visit the Gitter or the #uwave channel in the WE ♥ KPOP Slack for updates.

Installing üWave

This page describes how to install üWave from scratch using the üWave CLI. This is aimed at a production environment—for a development installation, check out the üWave Web Client documentation. If you run into trouble, try visiting the Gitter chat room!


To run üWave, you need a server with:

Ubuntu 16.04

On Ubuntu 16.04, the following commands will install everything we need:

echo "deb http://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.2.list
curl -sL https://deb.nodesource.com/setup_7.x | sudo -E bash -

sudo apt-get update
sudo apt-get install -y build-essential mongodb-org nodejs redis-server


We will use the pm2 tool to manage the üWave server process and logging, and we will use the üWave CLI to configure the server.

With npm do:

npm install --global pm2 u-wave-cli

Next, we will install the logrotate module for pm2, which automatically archives log files by date. That way log files don't grow to many hundreds of MBs.

pm2 install pm2-logrotate

Now we will start the configuration of the üWave server itself. The CLI will ask some questions about the necessary databases, API keys and administrator account credentials.

u-wave init