Menu Close
Settings Close

Language and Page Formatting Options

Chapter 3. Restricting the session to a single application

You can start the GNOME session in single-application mode, also known as kiosk mode. In this session, GNOME displays only a full-screen window of the application that you have selected.

3.1. Single-application mode

Single-application mode is a modified GNOME session that reconfigures the Mutter window manager into an interactive kiosk. This session locks down certain behavior to make the standard desktop more restrictive. The user can interact only with a single application selected by the administrator.

You can set up single-application mode in a number of fields, from communication to entertainment or education, and use it as a self-serve machine, an event manager, a registration point, and so on.

The single-application mode configuration is available from the gnome-session-kiosk-session package.

3.2. Enabling single-application mode

This procedure installs and enables single-application mode, which restricts the GNOME session to a single application.


  1. Install the gnome-session-kiosk-session package:

    # dnf install gnome-session-kiosk-session
  2. As the user that will open the single-application session, create the /home/user/.local/bin/redhat-kiosk file:

    [user]$ mkdir -p ~/.local/bin
    [user]$ touch ~/.local/bin/redhat-kiosk
  3. Edit the /home/user/.local/bin/redhat-kiosk file and enter the executable name of the application that you want to launch in single-application mode.

    For example, to launch the Firefox browser in single-application mode, enter the following content:

    while true; do
        firefox --kiosk

    The while true loop ensures that the application restarts if it terminates for any reason.

  4. Make the file executable:

    [user]$ chmod +x ~/.local/bin/redhat-kiosk
  5. If you created the file or its containing directories as a different user than the single-application user, such as root, ensure that the file has the correct permissions:

    # chown -R user:group ~user/.local
  6. At the GNOME login screen, select the Kiosk session from the cogwheel button menu and log in as the single-application user.