The latest articles on DEV Community by Manuel Gorospe (@manuel_gorospe_6dd0d00430). https://dev.to/manuel_gorospe_6dd0d00430 https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F2798021%2Fee4662fc-0163-40a3-aab0-1e78a55d7ce7.png https://dev.to/manuel_gorospe_6dd0d00430 en Manuel Gorospe Mon, 03 Feb 2025 14:28:13 +0000 https://dev.to/manuel_gorospe_6dd0d00430/kiosk-mode-on-gnome-using-openkiosk-3lb9 https://dev.to/manuel_gorospe_6dd0d00430/kiosk-mode-on-gnome-using-openkiosk-3lb9 <h2> How to Set Up OpenKiosk with GNOME and Auto-Start on Login </h2> <h2> System Details </h2> <ul> <li> <strong>GNOME Shell:</strong> 40.10</li> <li> <strong>OS:</strong> Rocky Linux release 9.5</li> </ul> <p>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.</p> <h2> 🔹 Step 1: Install GNOME Extensions </h2> <p>To improve the kiosk experience, I installed two extensions:</p> <ol> <li> <strong>Disable Gestures</strong> – Prevents unintended touchpad gestures</li> <li> <strong>No Overview</strong> – Disables automatic workspace overview</li> </ol> <p>URLs</p> <p><a href="https://extensions.gnome.org/extension/4049/disable-gestures-2021/" rel="noopener noreferrer">disable-gestures URL</a></p> <p><a href="https://extensions.gnome.org/extension/4099/no-overview/" rel="noopener noreferrer">No-overview URL</a></p> <p>Install them using the following commands:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code><span class="c"># Install and enable Disable Gestures extension</span> gnome-extensions <span class="nb">install </span>disable-gestures-2021@verycrazydog.gmail.com gnome-extensions <span class="nb">enable </span>disable-gestures-2021@verycrazydog.gmail.com <span class="c"># Install and enable No Overview extension</span> gnome-extensions <span class="nb">install </span>no-overview@fthx gnome-extensions <span class="nb">enable </span>no-overview@fthx </code></pre> </div> <h2> 🔹 Step 2: Install OpenKiosk </h2> <p>Download and install OpenKiosk from:<br> 🔗 <a href="https://openkiosk.mozdevgroup.com/" rel="noopener noreferrer">OpenKiosk Download</a></p> <p>Once installed, modify the configuration file:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code><span class="nb">sudo </span>nano /usr/lib/OpenKiosk/openkiosk.cfg </code></pre> </div> <p>Update settings as needed (e.g., set the homepage, enable fullscreen, etc.).</p> <h2> 🔹 Step 3: Auto-Start OpenKiosk on Login </h2> <p>To ensure OpenKiosk launches automatically, create a startup entry:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code><span class="nb">mkdir</span> <span class="nt">-p</span> ~/.config/autostart nano ~/.config/autostart/openkiosk.desktop </code></pre> </div> <p>Paste the following content:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight ini"><code><span class="nn">[Desktop Entry]</span> <span class="py">Type</span><span class="p">=</span><span class="s">Application</span> <span class="py">Name</span><span class="p">=</span><span class="s">OpenKiosk</span> <span class="py">Exec</span><span class="p">=</span><span class="s">bash -c "export MOZ_ENABLE_WAYLAND=1 &amp;&amp; export DISPLAY=:0 &amp;&amp; /usr/bin/OpenKiosk --safe-mode"</span> </code></pre> </div> <p>Save and exit.</p> <h3> MOZ_ENABLE_WAYLAND=1 </h3> <p>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.</p> <h2> 🔹 Step 4: Reboot and Test </h2> <p>Restart your system to apply the changes:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>reboot </code></pre> </div> <p>After logging in, OpenKiosk should launch automatically in kiosk mode. 🎉</p> <p>Let me know if you have any improvements or suggestions! 🚀</p>