On this page

Sections 1-4:

Getting started 

Sections 5-6:

Software applications

Section 7:

Examples and inspirations

The MAZI toolkit

Everything you need to build your own MAZI Zone

Use the MAZI toolkit to make your own MAZI Zone. This section of the website provides a list of hardware and items to buy, links for downloading the toolkit image software and the application software, and instructions to put it all together. There are ideas for what to do with your own MAZI Zone. Once your zone is built, you need to let people know about it, so you will also find templates for posters and publicity materials.

Join the MAZI Toolkit email list for feedback and discussions

Your E-mail address:
Your Name (optional):

You may enter a privacy password below. This provides only mild security, but should prevent others from messing with your subscription. Do not use a valuable password as it will occasionally be emailed back to you in cleartext. If you choose not to enter a password, one will be automatically generated for you, and it will be sent to you once you've confirmed your subscription. You can always request a mail-back of your password when you edit your personal options.

Password choice:
Confirm Password:

Would you like to receive list mail batched in a daily digest? (You may choose NoMail after you join.)
No Yes


MicroSD card (over 8GB, over class 10 speed)
USB wireless adapter with external antenna (only for Raspberry Pi 2)


Optional for set up:

Portable USB battery for portable use
USB wireless adapter with external antenna (for dual mode)
Keyboard/display (for installation with raspbian image) 
Link to detailed notes on suggested products.


Additional optional elements for specific applications (under construction)

Containers for the Raspberry Pi kit
Input devices (cameras, microphones, hybridletter box)
Sensors – tested range of usb sensor or sensehat tools

Option A.

Use the ready-made MAZI toolkit image 

This is the recommended option for most people interested in deploying a MAZI zone. It should not take more than a few minutes to complete.


First download the latest MAZI toolkit Raspberry Pi image  (1GB zipped, 8GB uncompressed)
Check the MAZI toolkit’s version history https://github.com/mazi-project/guides/wiki/Version-History )


Copy the image to your microSD card 

Instructions follow for: 1. OS X   2. Linux  3.Windows 

1. For OS X

  1. Download and Install Etcher from https://etcher.io
  1. Open etcher and click Select Image to choose the mazi img file.
  2. Choose SD Card as Drive.


  1. Click Flash!

As soon as the process is finished mount the SD card on the Raspberry Pi and turn it on.

2. For Linux

Please note that the use of the dd tool can overwrite any partition of your machine. If you specify the wrong device in the instructions below, you could delete your primary Linux partition. Please be careful.

1.  Run:

df -h

To see what devices are currently mounted.

2.  Insert the SD card and run df -h again. The new device that has appeared is your SD card. The left column gives the device name of your SD card. It will be listed as something like /dev/mmcblk0p1 or /dev/sdd1. The last part (p1 or 1 respectively) is the partition number but you want to write to the whole SD card, not just one partition. You therefore need to remove that part from the name, getting, for example, /dev/mmcblk0 or /dev/sdd as the device name for the whole SD card.

3.  Now that you’ve noted what the device name is, you need to unmount it so that files can’t be read or written to the SD card while you are copying over the SD image

4.  Run:

umount /dev/sdd1

Replacing sdd1 with whatever your SD card’s device name is (including the partition number).

5.  In the terminal, write the image to the card with the command below, making sure you replace the input file if= argument with the path to your .img file, and the /dev/sdd in the output file of= argument with the right device name. This is very important, as you will lose all data on the hard drive if you provide the wrong device name. Make sure the device name is the name of the whole SD card as described above, not just a partition of it. For example, sdd, not sdds1 or sddp1, and mmcblk0, not mmcblk0p1

sudo dd bs=4M if=2016-05-27-raspbian-jessie.img of=/dev/sdd

6.  The dd command does not give any information of its progress and so may appear to have frozen.To see the progress of the copy operation you can run in another terminal

sudo pkill -USR1 -n -x dd


3. For Windows

Download Win32 application for flashing the SD card

  1. Select your device (SD card)


  1. Locate the downloaded disk image


  1. Click Write and wait for the write to be completed



Option B:  

Installation with Raspbian image

Raspbian is the Raspberry Pi Foundation’s official supported operating system. Find out more at the Raspberry Pi website.


This option is recommended only for developers, or technically advanced MAZI toolkit owners who want to learn about the MAZI technical approach, and possibly contribute to the toolkit development.


Extra equipment required: keyboard and display


Detailed guidelines on the MAZI Guides site.
(Scripts to facilitate the manual installation will be made available soon.)

1. Insert the microSD card into the slot of the Raspberry Pi.

2. Optional: Insert the USB wireless adapter with external antenna (if you have a Raspberry Pi 2 or wish to operate in dual mode without ethernet cable).

3. Power up your Raspberry Pi and wait about 1 min to let your MAZI Zone start.

4. Search for the SSID “mazizone” and connect to it. 

5. Use a web browser to visit http://portal.mazizone.eu it will normally popup automatically – this only works when you are connected to the MAZI Zone

6. If you see the MAZI Zone portal, your MAZI Zone installation was successful and you can start using the different available applications!

7. If you don’t see the MAZI Zone portal, please email us at info@mazizone.eu

As an administrator of your MAZI Zone you have access to a wide range of configuration options that will help you personalise your MAZI Zone.

To do this you should visit:  http://portal.mazizone.eu/admin/  This is only available if you are connected to your MAZI Zone.

The very first time, you will redirected to a special page that will guide you through three initial required tasks:

1) Set the administrator password. The default user name is: mazi_admin

2) Set the correct date/time. This is important for your MAZI Zone to work correctly.

3) Set the network name (SSID) of your MAZI zone, if you want to customise it. This is optional.


More detailed documentation for the various configuration options is available at: 


The following section tells you how to customise the applications on your MAZI Zone.
Every MAZI zone has a set of pre-installed FLOSS applications, like Etherpad and NextCloud, that will be accessible by those (and only those) connecting to your MAZI Zone. MAZI is developing also a specialized MAZI Zone application called mazi-board or Guestbook“.
You can either let the users of the MAZI Zone choose which applications they prefer using, or narrow down their choices to help create a critical mass of people using the same applications, in this page, when connected to your MAZI Zone: http://demo.mazizone.eu:4567/admin_application (the corresponding URL leads to the demo page in which admin actions are not recorded).
You can also try the currently installed applications on the public demo server: http://demo.mazizone.eu:4567/index (for Nextcloud the test account  is user: test pass: mazizone.
Detailed description and tips for each application are available in our GitHub repository: https://github.com/mazi-project/guides/wiki 


Please contact us at contact@mazizone.eu if you wish us to pre-install your favourite FLOSS application in future versions of the MAZI toolkit.

Promote your MAZI Zone.

Let people know that your MAZI Zone exists, and consider ways to demonstrate how to use and participate in interactive local services of this type. The MAZI toolkit includes three types of additional documentation to this endwhich is currently under construction in the following documents (feel free to add comments/suggestions).





This website uses cookies. You can manage or block these using your browser settings. more information

Cookies are small pieces of data, stored in text files, that are stored on your computer or other device when websites are loaded in a browser. They are widely used to ‘remember’ you and your preferences. The cookie settings on this website are set to "allow cookies" to give you the best browsing experience possible. If you continue to use this website without changing your cookie settings or you click "Accept" below then you are consenting to this.