Raspberry Pi Install Instructions

Updated February 4, 2025

Updated Installation instructions for Raspbian devices

These installation instructions show how different browsers can be configured in Kiosk mode on various Raspberry Pi devices.

Chromium

The Default browser option, most similar to Google Chrome.

##########################################
# DEPENDENCIES
##########################################
sudo apt-get update && sudo apt-get upgrade -y
sudo apt-get install -y chromium-browser matchbox-window-manager xserver-xorg x11-xserver-utils unclutter


##########################################
# CREATE STARTUP SCRIPT
##########################################
nano /home/pi/startChromium.sh



##########################################
# STARTUP SCRIPT
##########################################

#!/bin/sh
# Disable screen blanking and power management
xset -dpms        # Disable Energy Star (DPMS) features
xset s off        # Disable screen saver
xset s noblank    # Prevent the screen from blanking

# Hide mouse cursor after 0.1 seconds of inactivity (optional)
unclutter -idle 0.1 -root &

# Start the lightweight window manager
matchbox-window-manager &

# Launch Chromium in fullscreen kiosk mode
chromium-browser --noerrdialogs --disable-infobars --kiosk https://app.meetingroom365.com/?key=YOURDISPLAYKEY



##########################################
# MAKE STARTUP SCRIPT EXECUTABLE ON BOOT
##########################################

sudo chmod +x /home/pi/startChromium.sh

sudo nano /etc/rc.local

# ----------------------
# Add BEFORE 'exit 0'
# ----------------------
FRAMEBUFFER=/dev/fb1 xinit /home/pi/startChromium.sh &

# Ensure rc.local is executable
sudo chmod +x /etc/rc.local



#####################
# OPTIONAL ENHANCEMENTS
#####################
sudo nano /boot/config.txt
# Add:
# consoleblank=0

sudo systemctl disable bluetooth
sudo systemctl disable triggerhappy
sudo systemctl disable avahi-daemon



#####################
# RESTART TO TEST
#####################
sudo reboot

KWeb

KWeb is a Minimal Kiosk Browser based on Webkit.

##########################################
# DEPENDENCIES
##########################################
sudo apt-get update && sudo apt-get upgrade -y
sudo apt-get install -y kweb matchbox-window-manager xserver-xorg x11-xserver-utils unclutter


##########################################
# CREATE STARTUP SCRIPT
##########################################
nano /home/pi/startKweb.sh



##########################################
# STARTUP SCRIPT
##########################################

#!/bin/sh
# Disable screen blanking and power management
xset -dpms        # Disable Energy Star (DPMS) features
xset s off        # Disable screen saver
xset s noblank    # Prevent the screen from blanking

# Hide mouse cursor after 0.1 seconds of inactivity (optional)
unclutter -idle 0.1 -root &

# Start the lightweight window manager
matchbox-window-manager &

# Launch Kweb in fullscreen kiosk mode
kweb -K https://app.meetingroom365.com/?key=YOURDISPLAYKEY



##########################################
# MAKE STARTUP SCRIPT EXECUTABLE ON BOOT
##########################################

sudo chmod +x /home/pi/startKweb.sh

sudo nano /etc/rc.local

# ----------------------
# Add BEFORE 'exit 0'
# ----------------------
FRAMEBUFFER=/dev/fb1 xinit /home/pi/startKweb.sh &

# Ensure rc.local is executable
sudo chmod +x /etc/rc.local



#####################
# OPTIONAL ENHANCEMENTS
#####################
sudo nano /boot/config.txt
# Add:
# consoleblank=0

sudo systemctl disable bluetooth
sudo systemctl disable triggerhappy
sudo systemctl disable avahi-daemon



#####################
# RESTART TO TEST
#####################
sudo reboot

Midori

A Lightweight browser option, requires more resources than Kweb (but uses the Blink engine, like Chromium), so may offer more compatibility for some applications.

##########################################
# DEPENDENCIES
##########################################
sudo apt-get update && sudo apt-get upgrade -y
sudo apt-get install -y midori matchbox-window-manager xserver-xorg x11-xserver-utils unclutter


##########################################
# CREATE STARTUP SCRIPT
##########################################
nano /home/pi/startMidori.sh



##########################################
# STARTUP SCRIPT (CHANGE DISPLAY KEY)
##########################################

#!/bin/sh
# Disable screen blanking and power management
xset -dpms        # Disable Energy Star (DPMS) features
xset s off        # Disable screen saver
xset s noblank    # Prevent the screen from blanking

# Hide mouse cursor after 0.1 seconds of inactivity (optional)
unclutter -idle 0.1 -root &

# Start the lightweight window manager
matchbox-window-manager &

# Launch Midori in fullscreen kiosk mode
midori -e Fullscreen -a https://app.meetingroom365.com/?key=YOURDISPLAYKEY



##########################################
# MAKE STARTUP SCRIPT EXECUTABLE ON BOOT
##########################################

sudo chmod +x /home/pi/startMidori.sh

sudo nano /etc/rc.local

# ----------------------
# Add BEFORE 'exit 0'
# ----------------------
FRAMEBUFFER=/dev/fb1 xinit /home/pi/startMidori.sh &

# Ensure rc.local is executable
sudo chmod +x /etc/rc.local



#####################
# OPTIONAL ENHANCEMENTS
#####################
sudo nano /boot/config.txt
# Add:
# consoleblank=0

sudo systemctl disable bluetooth
sudo systemctl disable triggerhappy
sudo systemctl disable avahi-daemon



#####################
# RESTART TO TEST
#####################
sudo reboot