DEV Community

Manuel Gorospe
Manuel Gorospe

Posted on

Kiosk Mode on GNOME using OpenKiosk

How to Set Up OpenKiosk with GNOME and Auto-Start on Login

System Details

  • GNOME Shell: 40.10
  • OS: Rocky Linux release 9.5

I needed to run OpenKiosk in kiosk mode on GNOME and have it start automatically on login. Here’s the setup I used, including some useful GNOME extensions.


πŸ”Ή Step 1: Install GNOME Extensions

To improve the kiosk experience, I installed two extensions:

  1. Disable Gestures – Prevents unintended touchpad gestures
  2. No Overview – Disables automatic workspace overview

URLs

disable-gestures URL

No-overview URL

Install them using the following commands:

# Install and enable Disable Gestures extension
gnome-extensions install disable-gestures-2021@verycrazydog.gmail.com  
gnome-extensions enable disable-gestures-2021@verycrazydog.gmail.com  

# Install and enable No Overview extension
gnome-extensions install no-overview@fthx  
gnome-extensions enable no-overview@fthx  
Enter fullscreen mode Exit fullscreen mode

πŸ”Ή Step 2: Install OpenKiosk

Download and install OpenKiosk from:
πŸ”— OpenKiosk Download

Once installed, modify the configuration file:

sudo nano /usr/lib/OpenKiosk/openkiosk.cfg
Enter fullscreen mode Exit fullscreen mode

Update settings as needed (e.g., set the homepage, enable fullscreen, etc.).


πŸ”Ή Step 3: Auto-Start OpenKiosk on Login

To ensure OpenKiosk launches automatically, create a startup entry:

mkdir -p ~/.config/autostart
nano ~/.config/autostart/openkiosk.desktop
Enter fullscreen mode Exit fullscreen mode

Paste the following content:

[Desktop Entry]
Type=Application
Name=OpenKiosk
Exec=bash -c "export MOZ_ENABLE_WAYLAND=1 && export DISPLAY=:0 && /usr/bin/OpenKiosk --safe-mode"
Enter fullscreen mode Exit fullscreen mode

Save and exit.

MOZ_ENABLE_WAYLAND=1

If your system is using X11 or if you're unsure which display server is being used, specify Wayland manually. This ensures Firefox-based applications like OpenKiosk use the correct display protocol.


πŸ”Ή Step 4: Reboot and Test

Restart your system to apply the changes:

reboot
Enter fullscreen mode Exit fullscreen mode

After logging in, OpenKiosk should launch automatically in kiosk mode. πŸŽ‰

Let me know if you have any improvements or suggestions! πŸš€

Top comments (2)

Collapse
 
briantuduri profile image
Brian Tuduri

good job

Collapse
 
who_who_8dd7c8658c2b7f553 profile image
who who

Worked as intended, very much thank you Manuel