Picture of Setting Up Ubuntu as a Kiosk Web Appliance
At work we have the frequent need for a machine that will allow students to access the internet without having full access to a computer.  To accomplish this task we previously resorted to creating AutoHotKey scripts on a Windows XP machine.  Many of the students and the staff who monitored these computers took issue with the computer's slow boot and running speed.  To cope with this we started to explore alternatives to Windows.  This is where we combined Ubuntu (a fast operating system) with Chromium-browser (one of the fastest browsers).  Now we have really old machines running as web kiosks that boot in 20 seconds or less and are very responsive to clicks, typing, and even flash videos and animations.

Follow the steps in this Instructable to set up Ubuntu, and Chromium if you haven't already.

Some potential uses for this type of system:
    * Web Kiosk
    * Information Booth
    * Subsonic Guest Interface
    * X10 House Control

Step 1: Add XScreensaver & Ubuntu Restricted Extras

Picture of Add XScreensaver & Ubuntu Restricted Extras
Fullscreen capture 742010 54736 PM.bmp
Fullscreen capture 742010 55341 PM.bmp
On our systems we found that even LCD monitors got burnt in after time.  They are not supposed to be able to do this, but they were.  To remedy this, we tried to get the default screensavers to come up.  They were not great at running from a script.  Instead the best option for this is to install the xscreensaver packages.  I like to do this from the command line so click Applications, highlight Accessories, and click Terminal.  From there enter the command "sudo apt-get install xscreensav* -y" without the quotation marks.  The asterisk at the end allows aptitude to install all of the packages that start with xscreensav, thus installing all the additional screensavers available.
If you will be using flash you will need to install the plugin for it.  The best way I've found to do this is similar to adding xscreensaver.  In the terminal window enter "sudo apt-get isntall ubuntu-restricted-extras -y".  Once this is done close the Terminal window.
1-40 of 187Next »
chuydb2 years ago
Made it back by runnig a terminal...then

sudo nano /etc/lightdm/lightdm.conf

and deleting the autologin user line.

How did you get to the terminal? CTRL-ALT-T doesn't work for me.

natrinicle (author)  newuser20141 year ago
ctrl+alt+t only works while in a window manager. ctrl+alt+f1 or ctrl+alt+f2 should take you to an alternate tty though.
natrinicle (author)  chuydb2 years ago
Excellent! Glad you figured it out. Thanks for posting the answer!

Thank you for the help, anyway you could make a youtube video guide trying to get it to work on Ubuntu 14.04 but does not boot up into chrome automatically.

natrinicle (author)  safejack15 hours ago
So you're wanting a video on how to install Ubuntu?
safejack12 days ago

Can Anyone please explain this code to me :

running ubuntu got everything working thank you the only two problems I have is :

1. Cant seem to fiqure out how to resize to fill the screen (could you please make a guide)

2. I would like to understand the code below.


xscreensaver -nosplash &

cat ~/.config/chromium/Local\ State | perl -pe "s/\"bottom.*/\"bottom\":
$(xrandr | grep \* | cut -d' ' -f4 | cut -d'x' -f2),/" >
~/.config/chromium/Local\ State

cat ~/.config/chromium/Local\ State | perl -pe "s/\"right.*/\"right\":
$(xrandr | grep \* | cut -d' ' -f4 | cut -d'x' -f1),/" >
~/.config/chromium/Local\ State

while true; do chromium-browser %u --start-maximized; sleep 5s; done

running ubuntu 14.04

Thank you in Advance

natrinicle (author)  safejack12 days ago
1. Chromium is a bit buggy to get fullscreen which is what that code was meant to work around. Likely they have patched it again so that these variables are ignored from the preferences file.

#!/bin/bash - Indicates that this file is a script that should be executed with bash

xscreensaver -nosplash & - http://explainshell.com/explain?cmd=xscreensaver+-nosplash+%26

cat ~/.config/chromium/Local\ State | perl -pe "s/\"bottom.*/\"bottom\":
$(xrandr | grep \* | cut -d' ' -f4 | cut -d'x' -f2),/" >
~/.config/chromium/Local\ State - http://explainshell.com/explain?cmd=cat+~%2F.config%2Fchromium%2FLocal%5C+State+%7C+perl+-pe+%22s%2F%5C%22bottom.*%2F%5C%22bottom%5C%22%3A++%24%28xrandr+%7C+grep+%5C*+%7C+cut+-d%27+%27+-f4+%7C+cut+-d%27x%27+-f2%29%2C%2F%22+%3E++~%2F.config%2Fchromium%2FLocal%5C+State

cat ~/.config/chromium/Local\ State | perl -pe "s/\"right.*/\"right\":
$(xrandr | grep \* | cut -d' ' -f4 | cut -d'x' -f1),/" >
~/.config/chromium/Local\ State - http://explainshell.com/explain?cmd=cat+~%2F.config%2Fchromium%2FLocal%5C+State+%7C+perl+-pe+%22s%2F%5C%22right.*%2F%5C%22right%5C%22%3A++%24%28xrandr+%7C+grep+%5C*+%7C+cut+-d%27+%27+-f4+%7C+cut+-d%27x%27+-f1%29%2C%2F%22+%3E++~%2F.config%2Fchromium%2FLocal%5C+State

while true; do chromium-browser %u --start-maximized; sleep 5s; done - http://explainshell.com/explain?cmd=while+true%3B+do+chromium-browser+%25u+--start-maximized%3B+sleep+5s%3B+done
newbiecomer9 months ago

When I make the kiosk.desktop and the chromeKiosk.sh files, I get an error in the terminal while trying to save. The error says that it cannot find the path and that it failed to save. But this doesn't happen when I open the files again. Is this normal for the first time?

Reason I ask is that when I get logged into my Kiosk Account, it just goes to the desktop and sits there. Doesn't open anything.

natrinicle (author)  newbiecomer9 months ago
Did you verify that the path exists? Try running ls adding a folder each time till you get to where those files are saved. e.g. "ls /usr" then "ls /usr/local" using the path for those files. Post the results and I'll help interpret them.
JavierC410 months ago


i have a wyse t50 with enhanced ubuntu linux and want to connect to a linux server. could you please help me in the configuration of t50 client?

thanks in advance.

natrinicle (author)  JavierC410 months ago

That is extremely out of scope. Having never worked with that terminal emulator before I would simply be Googling for the answer, same as you would.
IsaacN11 year ago

What am i doing wrong? I got 1 computer to work but the rest are not. I receive unable to launch x sessions. Please help.

Dnode IsaacN111 months ago

I had the same message. You have to make sure, that you have made your script executable, which was mentioned in the very last step.

$ sudo chmod 755 /usr/share/xsessions/chromeKiosk.sh

natrinicle (author)  IsaacN11 year ago
Looks like it's attempting to find a file "/usr/share/xsessions/chromekiosk.sh" but not finding it. In step 6, did you create both files or just the one?
flimik1 year ago

sorry =) repeat

how can i give a possibility to resize chromium?

natrinicle (author)  flimik1 year ago
You would need a windowing system loaded to resize Chromium on the fly. Otherwise, I used to edit the config files for this. Sounds like Google EOL'd those settings so I'm not certain at this point.
MichaelH21 year ago

I have successfully set this up on Ubuntu 12.04 on an All In One Dell PC, however, i am having an issue;

When chromium is launched from a script, multi-touch is disabled. If i use the switch --touch-devices=N (N being the device number of the touchscreen found typing "xinput list") i get touch-- sort of. If i do single clicks, fine. If I do two finger or more clicks, it breaks and touch no longer works.

natrinicle (author)  MichaelH21 year ago
Hrmm, sounds like some kind of a touch driver may need to be loaded for the multi-touch to work. I'd get in contact with Dell or see if you can find anything online about getting that particular model's multi-touch working in Ubuntu.
BjornE11 year ago

I want to make a panel PC that controls a PLC trough a webinterface (fixed IP),
i imagine this works great for this. but what happens when power goes out?

can i make it reboot in to this kiosk mode?
and if i clone the SD drives that it runs on, is there a easy way to change the IP addres when clients have a different IP range?
eg: 192.168.0.x instead of 192.168.1.x

Great tutorial!



natrinicle (author)  BjornE11 year ago
Rebooting into kiosk mode works automatically if you follow the instructions. You can edit the /etc/network/interfaces file on the sdcard before installing it in the new computer.

The IP addres of the kiosk itself would be DHCP,
I meant the IP addres in the browser, at one client the PLC would be (fixed IP), and other client would be

Thank you for your help :-D

natrinicle (author)  BjornE11 year ago

Oh, I see! Sorry for the confusion. I would recommend using the /etc/hosts file and setting a hostname that you would use in Chromium. For instance http://plcinterface/... with the hosts file containing: plcinterface www.plcinterface etc...

lowbrr1 year ago

Sooo, I set this up on Ubuntu 14.04, and I got it working, but there's a problem.

I don't know how to exit the kiosk mode and log in to a different account. I can access the terminal through some of the methods detailed below, but I don't have Sudo access because the Kiosk account is a basic user, and that's as far as I know how to get.

Any and all help is appreciated.

You can also hit ALT-F4 to quit Chrome(ium) and return to the Kiosk user's desktop, then switch users.

natrinicle (author)  MichaelH21 year ago
Alt+F4 shouldn't return you to the desktop if you set up the .desktop config files per my Instructable. It should kill Chromium, wait a few seconds, then relaunch it.
natrinicle (author)  lowbrr1 year ago
You can use ctrl+alt+F1 or ctrl+alt+F2 to switch to a terminal login. From there, login with a user that has access to sudo.
breinicke1 year ago

I've had the system set up for a couple weeks and have casually been interacting with it in my spare time, ensuring it is locked down. I then realized there is a glaringly obvious way bypassing the full screen locked down nature.
Is there a way to edit the right click menu? With a simple mouse wheel click, or a right click "open link in new Window"/"New Tab" selection, a simple and commonly known technique gives the user a URL bar and full reign of the settings menu, etc.

natrinicle (author)  breinicke1 year ago
When I tested this years ago, it didn't give you the URL bar or settings menu from a new tab page. If you follow the part of setting it so that Chrome's settings are read only, you shouldn't need to worry as closing the browser/reopening it should reset the state.
breinicke1 year ago

I made it but am having a small issue. I used a P4. Ubuntu 14 ran, but was sluggish so I used lubuntu instead and it behaves much snappier. and works short of one thing glitch:
When it loads into kiosk mode, it has narrow strip across the bottom where the toolbar would be in the normal desktop mode and it shows whatever the wallpaper is set as in that strip.
Any ideas on how to get rid of this strip?

If related, on Step 5 where you said to edit the Local State file, I did not find the Top or Left line to enter zero. I had to use leafpad as an editor in LXDE and even did a file search for left and top with no results.
Did this go away in recent Chrome versions?

natrinicle (author)  breinicke1 year ago

It does look like they removed this file in recent versions. Not sure if they just moved it or renamed it or if they got rid of it altogether. The strip across the bottom is likely something to do with this file missing (I was getting similar things with Chrome before I edited that).

Thank you very much.

natrinicle (author)  breinicke1 year ago

It does look like they removed this file in recent versions. Not sure if they just moved it or renamed it or if they got rid of it altogether. The strip across the bottom is likely something to do with this file missing (I was getting similar things with Chrome before I edited that).

stejk111 year ago

Super tutorial and it's exactly what I am looking for.

Just one thing though... I need to use Firefox browser rather than Chromium as I will be using a touch screen and for some reason Chromium doesn't work very well for me.

I'm just stuck at step 7 and 8 and how to launch Firefox rather than Chromium. Can you help?


natrinicle (author)  stejk111 year ago

I'm not certain where you would set Firefox's dimensions as I haven't really dug into it, but you would want to change /usr/share/xsessions/kiosk.desktop's Exec line to point to the Firefox executable. You can find where this is by running "which firefox". Then you will want to remove/change both lines that start with cat in /usr/share/xsessions/chromeKiosk.sh and change chromium-browser to firefox as well.

nhburgess1 year ago

Great tutorial.

Suppose I would like to deploy this on multiple machines. Could I have a script that runs and makes all of these changes at once? Or can I copy and paste some files/folders?

Any help would be appreciated.


natrinicle (author)  nhburgess1 year ago

Thanks :)

I have been considering re-working this tutorial so that it could be scriptable but have been too busy with work lately and this has taken a back burner. Will look into it again here soon. Also, you could always build up one machine, clone the drive, and then log in and change the IP/hostname for each of the machines.

Great tutorial! One question, though. I set this up on 14.04 and have it working, but I can't back to the sign in screen. The login process doesn't pause anywhere to hit ESC or anything else to stop the auto login. I need to make some adjustments.

Any ideas?

natrinicle (author)  newuser20141 year ago
ctrl+alt+f1 or ctrl+alt+f2 should take you back to a terminal window. From there you should be able to edit and make adjustments to the various configurations.
sitoto1 year ago

Great instructable. I was successful in installing and configuring everything and I can boot in Kiosk Mode. My question is; is there anything else i need to install as a receiver? in order to make the touch screen working, because now my touch screen mouse is just bouncing around and not clicking anything.

1-40 of 187Next »