How to configure Raspberry Pi as a Kiosk terminal

How to configure Raspberry Pi as a Kiosk terminal


This article will be describing the full procedure on how to configure Raspberry Pi 2 or 3 as an universal automatic terminal. In this scenario, we will be presenting the Kiosk functionality.

What will you do ?

      • Perform the micro SD formatting, followed by mounting and burning the Raspbian image file
      • Utilize the television as a power source for the Raspberry Pi through a cellphone USB cable
      • Turn off the screen sleep in the system GUI in 2 quick steps
      • Add default display initialization options in the user session environment
      • Define device’s automatized operation – both by Command Line and Graphical User Interfaces – using the Firefox browser and R-Kiosk addon

Demonstrative Video




  • SSH process
  • icedtea-7-plugin
  • vim (optional)

Execute all commands provided in this document preceded by the “sudo” preffix or logged as root (“sudo -i“)

1) Raspbian install preparations

Run SDFormatter, select the driver letter that points to your SD micro chip and just click “Format”


Formatting done, open Win32DiskImager, search for the Raspbian “.img” file and “Write” it to the SD unit


2) Raspberry Pi and Raspbian installation and configuration

Connect the Raspberry Pi to a TV which must have at least one HDMI and USB interfaces (micro USB to USB cable)


After Raspbian autoinstall is finished, access the terminal and activate the default network interfaces as well as the assignment method of the public/private IP address(es)

 sudo vim /etc/network/interfaces
 {LINE 9}
 auto lo eth0

 {LINE 12}
 iface eth0 inet dhcp

Save the file, exit the editor and restart the network service to apply the changes

 sudo /etc/init.d/networking restart

3) Automated Kiosk setup

Having successfully tested the internal and external network, update download repositories and get the Debian distros’ Firefox edition

 sudo apt-get update

 sudo apt-get install iceweasel icedtea-7-plugin

Open the configuration file pertaining to the GUI display manager and turn off the screen sleep

 sudo vim /etc/lightdm/lightdm.conf
 {LINE 122}
 xserver-command=X -s 0 -dpms

Declare the required variables in the session environment of the picked user(s)

 sudo vim /home/pi/.bashrc
 {LINES 114 AND 115}
 export DISPLAY=:0
 export XAUTHORITY=/home/pi/.Xauthority

Through the GUI, start the browser, activate IcedTea plugin and click the following link in order to install R-Kiosk addon


Back to CLI, edit the file responsible for automatic command/process submission upon boot (for the user(s) of your choice)

 sudo vim /home/pi/.config/lxsession/LXDE-pi/autostart

It’s possible to include authentication information within the domain address information syntax as follows

 {LINE 4}
 @firefox --display=:0


 @firefox --display=:0

Finally, restart the system

 sudo reboot

This time, as soon as the operating system is loaded, the application will be run based on what was added to the “autostart” file.

  • Kayleigh
    Posted at 21:46h, 22 February Reply

    Thanks lots for furnishing persons with remarkably memorable possiblity to learn content articles and blog posts from this website. It really is generally really enjoyable and also stuffed with a great time for me personally and my workplace colleagues to go to the blog to the minimum a few moments per week to go through the brand new things you have acquired. And abeutolsly, we are truly astounded concerning the excellent concepts served by you. Chosen a few suggestions with this posting are essentially one of the most impressive we’ve ever before had.

    • Ramiro Ferrão
      Posted at 09:09h, 23 February Reply

      Thank you so much for the compliments! It’s truly flattering to know this has such an impact on helping and orienting you in your work.

      Cheers and hope to see you guys in future posts. 😉

Post A Reply to Kayleigh Cancel Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.