raspberry pi

Boot Raspberry PI into Chromium (Chrome Browser) Kiosk!


Simple… but good golly it took a lot of searching to track it down:

I muddle through the instructions found here (but watch out, they wont work):


Install the software…

The are a couple of reasons that post wont work.  Here are some modified instructions that do:

  • Install needed software through apt-get:
sudo apt-get install -y x11-xserver-utils unclutter
  • Create/edit the file located here:
  • NOTE: Some later installs of Raspbian now move the file here:

So that the file has this in it:

@lxpanel --profile LXDE-pi
@pcmanfm --desktop --profile LXDE-pi
#@xscreensaver -no-splash
@xset s off
@xset -dpms
@xset s noblank
@sed -i 's/"exited_cleanly": false/"exited_cleanly": true/' ~/.config/chromium/Default/Preferences
@chromium-browser --incognito --noerrdialogs --kiosk bloggerbrothers.com

Note the bolded portion is the URL.  It contains the location the browser will start at.

Now reboot your pi and boom!  You should be looking at BloggerBrothers.com in full browser mode.



Get rid of that pesky mouse pointer!

The last thing to do to polish this thing off is to remove the mouse pointer when its not in use.  There is a handy program called unclutter:

sudo apt-get install unclutter

Then add this call to your autostart file:

@unclutter -idle 0.1 -root

Poof!  The mouse pointer is hidden.

The whole file now looks like:

@lxpanel --profile LXDE-pi
@pcmanfm --desktop --profile LXDE-pi
#@xscreensaver -no-splash
@xset s off
@xset -dpms
@xset s noblank
@sed -i 's/"exited_cleanly": false/"exited_cleanly": true/' ~/.config/chromium/Default/Preferences
@chromium-browser --incognito --noerrdialogs --kiosk bloggerbrothers.com
@unclutter -idle 0.1 -root

Combine this with the article on mounting a net disk to make an UBER picture frame: Mount a Network Share at Boot on your Raspberry PI 3

Breaking out of Kiosk!!!

I was recently asked how to get OUT of the browser once the PI is in this mode.

This is actually pretty hard.  Kiosk Mode for the browser was intended to lock the device as a browser.  The GUI or desktop is blocked.  So you’ll have to go in with SSH…

SSH’ing in…

If you only have one pi on your network, and you haven’t changed its hostname then this will likely get you on:

ssh pi@raspberry.local

If you have changed the hostname – then replace “raspberry” in the above command with the appropriate hostname.

If you are not working on a MAC or another Raspberry PI, and you can’t see the host through mDNS (the thing that enables “.local” to be found.) Then you’ll have to consult your router… typically at “” to see the “Attached Devices” and see if you can locate the pi’s IP address.  Then:

ssh pi@ipaddresshere

Where “ipaddresshere” would be replaced with something like:

Remove the auto-boot to Kiosk:

So to get it out of this mode, you’ll have to modify that same file:


And comment out the part about the browser by placing a “#” in front of it:

#@chromium-browser --incognito --noerrdialogs --kiosk bloggerbrothers.com

Then reboot your pi:

sudo reboot

It will now boot without starting up the browser.  Tweak your settings, then remove the “#” symbol when you are ready to have it become a kiosk again on next reboot.

If it isn’t on the net AND you are locked into browser, then we’ll have to get you in via the serial console… article on that later. 🙂


7 thoughts on “Boot Raspberry PI into Chromium (Chrome Browser) Kiosk!

    1. That’s up to you! This is what I’ve put on my pis:

      It just boots a web page into full screen. For me, I built a simple-ish page that lets my family see photos from our NAS.

      Here is the code that runs my webpage.

      Also check out my article on how to mount a local NAS. Which makes it so you can just have GooglePhotos show up locally on your pi.

      The picture server is probably the greatest single thing I’ve built on the pi. The whole family loves re-seeing past events.

      Liked by 1 person

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

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