Open an HTML page when starting Raspberry Pi OS with Chromium Browser in full screen (kiosk mode)

autostart chromium startup rapsberry pi os
Table of Contents

The Chromium browser installed by default on Raspberry Pi OS allows like all internet browsers to open a web page in full screen. Kiosk mode is used to display a Node-RED Dashboard, the interface of a home automation server such as Jeedom, Domoticz, Home Assistant. Combined with a touch screen, you can easily control your home automation accessories from any room in the house.


To control home automation accessories, it is best to run the home automation software on a NAS or on another Raspberry Pi.

Benefits of kiosk mode

You can, of course, just press the F11 key to bring up the browser in full screen. However, you have to do it manually every time after launching the browser. By running the browser in Kiosk mode, the application will automatically launch in full screen. Users cannot bring it back to normal window by pressing F11 key.

When you run browsers in Kiosk mode,

  • User cannot see desktop or operating system details
  • The X (close) button  is hidden
  • The F11 key is disabled
  • Menu bars, toolbars are not visible
  • The status bar at the bottom is not visible
  • Right click context menu does not work
  • Destination links are not visible when hovering over links

Check that Chromium is installed

Open a Terminal and run this command to verify that Chromium is correctly installed on the system (this is the case by default).

chromium-browser --version
 --disable-quic --enable-tcp-fast-open --ppapi-flash-path=/usr/lib/chromium-browser/ --ppapi-flash-args=enable_stagevideo_auto=0 --ppapi-flash-version=
Chromium 78.0.3904.108 Built on Raspbian , running on Raspbian 10

If Chromium is not installed, run the following command to do so

sudo apt-get install --no-install-recommends chromium-browser

Minimum configuration on Raspberry Pi OS Lite

To be able to start Chromium, the X11 graphics rendering engine must be installed. If you are using the Desktop version of Raspberry Pi OS, you can skip to the next paragraph.

The Lite version is the minimum version without a graphical interface suitable for servers or the Raspberry Pi Zero WH.

Note. You will install the X11 graphical environment on your distribution. The performance of your installation decreases you. It is possible to choose not to start X11.

Run the following command

sudo apt-get install --no-install-recommends xserver-xorg x11-xserver-utils xinit

At the end of the installation, launch X11 by executing the command


Test Chromium startup in Kiosk mode

Run the following command, replacing the blog’s internet address with the web page you are interested in, for example Domoticz at http://localhost:8080/#/Dashboard

/usr/bin/chromium-browser --kiosk

Here is the test performed with a Waveshare 1024 x 600 pixel touchscreen.

Read Also
Test Waveshare 7 inch 1024×600 pixel LCD touch screen with acrylic holder for Raspberry Pi

autostart chromium kiosk rapberry pi os web page startup

Open a web page automatically when starting Raspberry Pi OS

To launch Chromium automatically and open a Web page, all you have to do is modify the autostart file on the LXDE desktop. Start by opening the configuration file

sudo nano /etc/xdg/lxsession/LXDE-pi/autostart

Then add the following commands without forgetting to modify the page to load at startup

@lxpanel --profile LXDE-pi
@pcmanfm --desktop --profile LXDE-pi
@xscreensaver -no-splash
/usr/bin/chromium-browser --kiosk  --disable-restore-session-state http://localhost:8080/#/Dashboard

Here, we start the Domoticz Dashboard

Read Also
Domoticz. Installation and configuration on Raspberry Pi 4

Save with the key combination Ctrl + X then Y.

Wait until the WiFi connection is available before launching Chromium

If the connection to the WiFi network is not yet established, you may get a white screen at startup. To avoid this, you only need to modify a few boot parameters using the raspi-config utility .

sudo raspbi-config

Go to the Boot Options menu

3 boot option raspberry pi os

Activer l’option B2 Wait for Network at Boot

b2 wait for network at boot raspberry pi

Open the B1 Desktop / CLI option and choose the B4 Desktop Autologin Desktop GUI option which will automatically launch the graphical desktop without asking for the pi user password .

b4 desktop autologin raspberry pi

To restart

Raspberry Pi OS restarts and automatically opens the Domoticz Dashboard.

chromium kiosk autostartup domoticz jeedom dashboard raspberry pi os

Tips and Frequently Asked Questions

Here are some tips and frequently asked questions

How to exit kiosk mode (full screen)

Function key F11 is disabled in Kiosk mode. You must use the Alt + F4 key combination to exit full screen mode.

Can we access the Raspberry Pi with VNC in full screen mode?

Yes, absolutely, you can use VNC to use the RPi remotely from another computer connected on the same network. The displayed screen will be perfectly identical. To exit kiosk mode, use the Alt + F4 key combination .

Can we access the dashboard of a home automation server such as Domoticz or Home Assistant?

Yes, absolutely. You just have to indicate the address of the Dashboard in the autostart file of LXDE

Disable automatic start

Just comment out with the # character the chromium-browser command like this

# /usr/bin/chromium-browser --kiosk --disable-restore-session-state http://localhost:8080/#/Dashboard

Can we use a virtual keyboard?

There is a virtual keyboard called Matchbox. The problem is that it remains permanently in the foreground unlike the virtual Windows keyboard which is displayed only when the cursor is placed in an input field.

To install lMatchbox

sudo apt install matchbox-keyboard


2020/11/04 First publication of the article

Version française

Click to rate this post!
[Total: 4 Average: 5]

Thanks for your reading

Did you like this project ? Don't miss any more projects by subscribing to our weekly newsletter!

Are you having a problem with this topic?

Maybe someone has already found the solution, visit the forum before asking your question
  1. onyl first time it worked, now I cant start “startx” … it goes into black screen and when I reboot and login with correct pass it returns me back to login “without showing me the label for wrong password”

  2. Would be great to know how to open a second page on the second screen!
    Thank you!!!

  3. Hi @christophe. I want to load a webpage from within the raspberry pi program (thingsboard) but the thingsboard software takes some time to load and render the webpage after boot and therefore the chromium webpage remains blank. How do I add a delay to execute the command /usr/bin/chromium-browser –kiosk –disable-restore-session-state http://localhost:8080/xxxxxx or perhaps add a refresh command to the chromium page after some time?

  4. Hi1 There is a typo in one of the last command lines

    sudo raspbi-config

    should be

    sudo raspi-config

Leave a Reply

Read more
DIY Projects
DIY Projects
%d bloggers like this: