MAZI Portal

The MAZI Portal is the software interface of the MAZI toolkit and comprises of the User page and the Administration Panel.

  • User Page ( Through the User Page the user of the MAZI Zone is able to access the available applications, as well as useful statistics
  • Administration Panel ( Through the Administration Panel the admin of the MAZI Zone is able to make all the configurations of the MAZI node

After following all the above sections for setting up the networking components of the toolkit, you can install the MAZI Portal following the instructions of this section.

Install MAZI Portal

Install the following packages:

apt-get update
apt-get install build-essential git-core libsqlite3-dev ruby ruby-dev libmysqlclient-dev


For debian stretch (instead of jessie) replace in the command above “libmysqlclient-dev” with “default-libmysqlclient-dev”.

Also install the following gems:

gem install sinatra sequel sqlite3 rake thin rubyzip mysql --no-ri --no-rdoc

Make sure you have cloned the MAZI backend repository (MAZI backend).


Clone the repository

sudo su
cd /root
git clone

Prepare the database

cd portal
rake init
rake db:migrate

Create and enable the service for the portal

cp init/mazi-portal /etc/init.d/mazi-portal
chmod +x /etc/init.d/mazi-portal
update-rc.d mazi-portal enable

Create and enable the service for the data collection framework

cp init/mazi-rest /etc/init.d/mazi-rest
chmod +x /etc/init.d/mazi-rest
update-rc.d mazi-rest enable


Both services should be running

service mazi-portal start
service mazi-rest start


Since version 1.6.4 there is an update button in the Administration Panel. It is strongly recommended to use this update functionality, but if you still insist to update the Portal using the command line, you need to execute the following commands:

sudo su
cd /root/portal
git pull origin master
rake db:migrate
cp /etc/mazi/config.yml /etc/mazi/config.yml.bu
cp etc/config.yml /etc/mazi/config.yml
cd /root/back-end
git pull origin master
service mazi-portal restart

MAZI backend


You can reset the password of the MAZI Portal to 1234, using the MAZI backend script This way, the administrator can access again the MAZI Portal administration panel and change the admin password accordingly. Check more info here.

Examples of usage:

  • Reset the MAZI Portal’s admin password to 1234
sudo sh