About | Download | FAQ | Changelog


In order to write the IMG file (extract it from the downloaded ZIP file, first) to the Raspberry (micro-)SD card (4GB minimum), Windows users can use Win32DiskImager, while Linux users can make use of dd and Mac OS X users should follow this guide. A SDHC class 10 card is highly recommended. Make use of a (micro-)SD to USB key adapter.

Please note that it is not rare that the latest build of Windows 10 (Creators Update) gives permission/write errors when dealing with USB keys. Don’t worry, it’s just Windows: retry until success.

Help with dd (run as root or with sudo) follows:

  • plug the SD card into your PC;
  • tail -f /var/log/messages or tail -f /var/log/syslog or fdisk -l for locating the assigned device file, for example: /dev/sdx (change for your case);
  • umount /dev/sdx1; umount /dev/sdx2
  • dd if=path/to/imageFile.img of=/dev/sdx bs=1M (dd always refers to the whole disk, so do not use /dev/sdx1 for example).

Once you have successfully written the IMG file to the SD, you have to plug the card into the R-Pi and restart.

Louis DeRobertis reports that some HDMI to VGA converters do not give enough power to the screen.

During everyday usage, if you intend to power the Pi off I strongly advide you to do via SSH or to schedule a cronjob which will turn off the Pi gracefully.


SSH LOGIN (donors’ version)

You can perform an SSH login using the following credentails.
Putty.exe or similar software is required for Windows users while of course *nix users will make use of the ssh client.

  • user: pi
  • password: live
  • then type: sudo -i for administrative rights

Raspberry IP address is always shown during the boot. Alternatively you can make use of network discovery apps for your smartphone or netdiscover tool for *nix systems to find it out.

When maintainance screen password is modified, SSH password will be changed accordingly. So, if you set a password for the admin interface, the new SSH password will be identical. This way you can protect both system settings change via browser (admin interface) and via SSH with one step.


Raspberry WebKiosk defaults to DHCP if network cable is plugged in. If you need to override this behaviour:

  • unplug the Ethernet cable and reboot;
  • network interfaces admin screen will appear;
  • change network settings as you wish; they will persist then across reboots.

For cleaning network configuration settings just in case, you can delete the config files in the /iwk folder via SSH or by inserting the SD card into a computer running Linux, or clear all the persistence settins via the admin interface.


Unlike Raspberry Digital Signage, Raspberry webKiosk does not come with an internal proxy by default, and this is a desiderd behaviour: this way it can perform (a little) faster.

In order to add an internal filtering HTTP proxy with a whitelist behaviour, use follow the steps.

1. Install tinyproxy via apt-get – and changed the config file to include:

FilterURLs On
FilterDefaultDeny Yes
Filter "/etc/tinyproxy/whitelist"

2. Create a whitelist with only the domains that you want the user to see;
3. Change the default error page at /usr/share/tinyproxy/default.html to do a 0 second redirect to;
4. Add proxy information to chromium at localhost:8888.

Many thanks to Louis DeRobertis.


The quickest way to adjust date and time according to your local time is to use ntpdate pointing an NTP server near you. For example: ntpdate ntp1.ien.it for Italy. SSH access required.
You can also set the time and date directly with the use of date -s command. SSH access required.

You can set your timezone with dpkg-reconfigure tzdata command. SSH access required of course.

1920 x 1080p

Modify /boot/config.txt file this way (thanks to Mark van der Linden, Brunner Armin and Guilherme Simões):

hdmi_mode=16 or hdmi_mode=82

Use mc -e /boot/config.txt via SSH or insert the SD card into a PC running Linux and use a common text editor.