Raspberry Pi Chromium Kiosk

A Raspberry Pi kiosk that boots straight into Chromium kiosk mode,
with a web-based admin panel to change the kiosk URL remotely.

Documentation

Create an issue

---

A Raspberry Pi kiosk setup that boots straight into Chromium in kiosk mode, plus a web-based admin panel (accessible by IP in a browser from any device on the network) that lets you change the kiosk URL remotely.

Setup (Raspberry Pi OS Lite)

Note: Follow the full setup guide here: https://daniel-gia.github.io/raspberry-pi-chromium-kiosk/getting-started/

1. Install Raspberry Pi OS Lite (using the official Raspberry Pi imaging tool)

2. Run this single command on your Raspberry Pi to install everything:

curl -sSL https://raw.githubusercontent.com/Daniel-Gia/raspberry-pi-chromium-kiosk/main/setup/install.sh | sudo bash -s -- <username> <password>

Replace <username> and <password> with your desired admin panel credentials.

3. Once finished, reboot your Pi:

sudo reboot

After reboot:

• The kiosk browser should start automatically on the Pi.
• The admin panel runs via Docker Compose (using host networking).

How to changing the kiosk URL

• You can open the admin panel from any device on the same network by visiting the Pi’s IP address in a browser:
  • http://<pi-ip>
  • Example: http://192.168.1.50

How to contribute

• Start with reading first steps
• Setup the environment and make a fork - read here
• Understand how to test changes on your pi locally - read here
• How to build the admin panel docker image (used in production) - See admin-panel/README.md.

License

Licensed under the Apache License 2.0 (Apache-2.0). See LICENSE and NOTICE.

---

If this project helps you, please consider starring the repo. Contributions (issues, fixes, docs improvements) are welcome.