Installing Instant WebKiosk/EDS on Raspberry Pi

A Raspberry Pi in a case

I am writing this to keep a record of the steps I took to install Instant WebKiosk/EDS, alias Easy Digital Signage flavour on a Raspberry Pi

Instant WebKiosk/EDS, alias Easy Digital Signage flavour is from

A Raspberry Pi in a case
Cased Raspberry Pi

The Raspberry Pi version, at the time of writing, is no longer supported but the creator will send it to you in return for a donation to the main software

What is Instant WebKiosk?

From Instant WebKiosk is a free and refined “live” (no installation required) browser-only (only the browser interface will show up) operating system based on Linux Debian and designed for use in web kiosks, multi-user “web workstations” (cafès, offices, schools, hotels) and digital signage deployments.

Instant WebKiosk/EDS
Instant WebKiosk/EDS

It makes use of Google Chromium as Internet browser and it features audio support, video files support, Adobe Flash support, PDF and images viewing, office files and compressed files support; it features full “i18n” (internationalization) including CJ input methods and a very useful on-screen virtual keyboard for touch devices.

Instant WebKiosk protects your privacy even if it’s fully customizable: users can change its settings (or install “apps” from the Chrome Web Store) but, thanks to its “live” nature and design, after a reset the operating system presents itself with the default settings and users’ private informations are completely destroyed.

Instant WebKiosk boots form USB flash devices (in order to write the downloaded IWK ISO file to a USB stick, Windows users can use Win32DiskImager, while Linux users can make use of dd) and supports the same hardware that default Debian Linux distributions do – no less… no more.

Supported file types in detail: Instant WebKiosk can read txt, html, xml, gif, jpeg, png, psd, mpeg, mp3, mp4, avi, wmv, wma, asf, mov, 3gp, ogg, ogm, mkv, rm, wav, dts, aac, flc, flv, midi, pdf, csv, doc, xls, ppt, rtf, odt, ods, odp, and zip files. All known unsupported file types are filtered.

Installation Instant WebKiosk

My Installation started on a Windows 7 PC.

Download the Raspberry Pi version of the software. It comeas as ZIP. Unzip the zip and you will get a .ISO file.

Normal practice for creating boot disks for Raspberry Pi is to use Win32DiskImager to burn an IMG file to a SD Card.

You can find our more about Win32DiskImager here:

  1. Rename iwk-rpi.devel_6.iso to iwk-rpi.devel_6.img
  2. Start Win32DiskImager and select the .img file above.
  3. Burn to SD Card
  4. Prepare your Raspberry PI. Put in a mouse and keyboard, a wired network lead (you cannot use wifi to start with) a monitor and your SD Card. Then apply power.
  5. During the boot, your PI will first update itself from the raspberry pi website, then about 5 minutes later will connect to Binary Emotions (the creator of Instant WebKiosk).
  6. Next step is to change the default page.
  7. Working out what IP address it has picked up by DHCP is a bit of trial and error.
  8. Browse to the IP that you’ve found. A webpage will allow to you set the home url and whether or not to display a keyboard on screen.

    Instant WebKiosk Configuration page
    Instant WebKiosk Configuration page
  9. Click “Set digital signage mode ON” and the device will reboot.
  10. You can also SSH to the PI to set it up. username: pi  password: live
  11. If you want to edit some of the “under the hood” settings, open /var/www/index.php.
  12. You’ll need to install a text editor
  13. apt-get install vim


After a week of using the software I find it excellent. It’s pretty much rock solid in operation (occasionally the startup fails but once it’s running it’s never failed).

Raspberry Pi VESA Mount

Raspberry Pi mounted on back on monitor using VESA plate
Raspberry Pi mounted on monitor using VESA plate

On my setup, I am powering the Pi from a USB socket on the back of the Samsung TV I have, so it’s really neat from a wiring point of view. I’ve also found the standard VESA fittings on a TV can be used to mount the Raspberry Pi securely. Just use some long M4 screws and a VESA plate (like this one: VESA Adaptor Plate). There are a number of different Pi cases available which might affect the fitting, so for reference, this is the case used:

*UPDATE 13 June 2013*

As the comment mentions, the creator of WebKiosk/EDS for Raspberry Pi has released a new public version. Both free and ‘donor’ (paid) versions are available.

The new version (paid option) offers these features;

  • no screensaver or screen blanking active on system;
  • optional browser full reset after specified user inactivity;
  • optional force web content reloading after specified time;
  • automatic system shut down at scheduled hour;
  • screen resolution settings;
  • admin password (with password management), which protects the modify of the operating system settings at boot in the admin interface;
  • SSH remote management (root password = admin password);
  • customizable HTTP proxy settings.

I’ve upgraded to the new version and so here is my updated guide.

  1. Follow steps 1-4 above
  2. Once the updating was done, I was presented with a Network Settings screen using the built in browser. This allows you to reset DHCP, set a static IP address or connect to Wi-fi.
  3. On my install, it said failed to connect my wired network and my wifi. Eventually I tried clicking the back button on the browser and lo and behold it had in fact connected fine.
  4. The next screen presents you with the options on what url to display and various relating settings such as refresh time, auto-shutdown. A Settings tab allows you to set your locality.


One thought on “Installing Instant WebKiosk/EDS on Raspberry Pi”

Comments are closed.