{"id":395,"date":"2025-01-29T22:31:21","date_gmt":"2025-01-29T22:31:21","guid":{"rendered":"https:\/\/www.aran.cat\/wp\/?p=395"},"modified":"2025-01-30T21:21:56","modified_gmt":"2025-01-30T21:21:56","slug":"debian-fullscreen-gui-kiosk","status":"publish","type":"post","link":"https:\/\/www.aran.cat\/wp\/?p=395","title":{"rendered":"Debian Fullscreen GUI Kiosk"},"content":{"rendered":"\n

Debian Fullscreen GUI Kiosk – Will Haley<\/a><\/h1>\n\n\n\n

Aug 3, 2017Updated 

This article was last edited over 3 years ago. Information here may no longer be accurate. Please proceed with caution, and feel free to contact me<\/a>.<\/h2>\n\n\n\n

These instructions are helpful if you would like to create a computer kiosk. The instructions are designed to run Chromium (the open-source version of Google\u2019s Chrome browser), but can be adapted to run any GUI program in a kiosk\/fullscreen mode.<\/p>\n\n\n\n

This guide was last tested against Debian 9.4 (Stretch) GNU\/Linux.<\/p>\n\n\n\n

Note that this guide is not intended to create a perfectly secure system, and may be vulnerable to tampering by knowledgable users.<\/strong><\/p>\n\n\n\n

Create a user on the system for the kiosk. In my case, the user is named kiosk-user<\/code>.<\/p>\n\n\n\n

useradd -m kiosk-user\n<\/code><\/pre>\n\n\n\n
Update the package list.<\/p>\n\n\n\n
apt-get update\n<\/code><\/pre>\n\n\n\n
Install required packages.<\/p>\n\n\n\n
apt-get install \\\n    sudo \\\n    xorg \\\n    chromium \\\n    openbox \\\n    lightdm\n<\/code><\/pre>\n\n\n\n
Edit the lightdm config script at \/etc\/lightdm\/lightdm.conf<\/code> to enable autologin.<\/p>\n\n\n\n
That file needs to only contain this content for autologin to work.<\/p>\n\n\n\n
[SeatDefaults]\nautologin-user=kiosk-user\nuser-session=openbox\n<\/code><\/pre>\n\n\n\n
Reboot to verify autologin works. You should now be logged in as kiosk-user<\/code> automatically.<\/p>\n\n\n\n
Create the openbox config directory for kiosk-user<\/code> if it does not exist.<\/p>\n\n\n\n
mkdir -p $HOME\/.config\/openbox\n<\/code><\/pre>\n\n\n\n
Create a script at $HOME\/.config\/openbox\/autostart<\/code> for the kiosk-user<\/code>. This script will be run at login.<\/p>\n\n\n\n
chromium \\\n    --no-first-run \\\n    --disable \\\n    --disable-translate \\\n    --disable-infobars \\\n    --disable-suggestions-service \\\n    --disable-save-password-bubble \\\n    --start-maximized \\\n    --kiosk \"http:\/\/www.google.com<\/a>\" &\n<\/code><\/pre>\n\n\n\n
The &<\/code> at the end is required for every<\/em> command in the autostart<\/code> script.<\/p>\n\n\n\n
Reboot, and you should see the machine automatically login and run chromium in kiosk mode.<\/p>\n\n\n\n
Citations<\/h1>\n\n\n\n