Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


WAZIUP platform

The WAZIUP platform is an IoT Big Data platform. It allows to create IoT applications and deploy them both in the Cloud and in the local gateway.

For information and documentation:


To install the platform, first clone it:

git clone
cd WaziCloud

Then pull the images and run it:

sudo chmod 777 data/* -R
export PLATFORM_VER=latest
docker-compose pull
docker-compose build dashboard
docker-compose -f docker-compose.yml -f docker-compose-first-run.yml up

This will create the default users and configuration for Waziup. Once the boot up finished, you can then access Waziup platform on http://localhost:3000

To start the platform in the future, just type:

docker-compose up

You can now access the Waziup dashboard on http://localhost Keycloak is available at http://localhost:8080. Default login/password in Keycloak is admin/admin. You need to change it!


To get the source code for each submodules, you need to clone with --recursive:

# clone the WaziCloud with submodules
git clone --recursive
cd WaziCloud
git submodule update --remote --recursive
docker-compose build


You can run the test campain like this:


Or view the API documentation:

firefox localhost:800/docs


mysqldump is used to backup user database.

mysqldump -h -P 3306 -u root -proot_password --all-databases > /var/backups/mysqlbackups/`date +"%m-%d-%y"`

Restore the data:

mysql -u root -proot_password -h <  /var/backups/mysqlbackups/`date +"%m-%d-%y"`

mongodump is used to backup sensor data:

mongodump --host --port 27017 --out /var/backups/mongobackups/`date +"%m-%d-%y"`

This command restores it in the local instance:

mongorestore /var/backups/mongobackups/`date +"%m-%d-%y"`


To export the keycloak configuration, run:

docker-compose run --entrypoint "/opt/jboss/tools/ -b -Dkeycloak.migration.action=export -Dkeycloak.migration.provider=dir -Dkeycloak.migration.dir=/opt/jboss/keycloak/standalone/data/" keycloak
#Stop keycloak when start-up is finished
cd data/keycloak
mv master-realm.json master-users-0.json waziup-realm.json waziup-users-0.json ../../keycloak/imports

Rebuild Keycloak image:

docker-compose build keycloak
docker-compose push keycloak


Copyright Waziup consortium 2018.

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.