Browser in kiosk mode (current eLux versions)

For kiosk mode, the Builtin Browser is used. In kiosk mode, the browser is started in full-screen mode and with limited user rights. The user cannot open other windows and cannot exit the browser. Note that the Builtin Browser if defined as a browser application is not run in kiosk mode even if address and navigation bar are hidden.

Firefox could be run in kiosk mode up to version ESR 52.8. Mozilla supports kiosk mode again starting with version 71.0, but without configuration options. For further information, see Kiosk mode for Firefox.

Defining Builtin Browser in kiosk mode1

  1. For the relevant devices, open Advanced device configuration > Advanced file entries and define the following entry:

    File /setup/terminal.ini
    Section Layout
    Entry KioskMode
    Value 2

    For further information, see Advanced file entries.

    This parameter enables the kiosk mode for the browser application.

  2. Create a text file named kioskmode.ini and add the section header [Browser1].

  3. Below, enter the relevant parameters:2

    Parameter Description
    Url=<URL of startup page> Web page (URL) that opens after the browser is started
    Homepage=<URL of homepage> Web page (URL) that opens when users click Home
    SaveFirstLink=true|false If true, the first URL loaded when coming from the startup page will be saved as the new startup page.
    Navbar=true|false The navigation bar will be shown.
    NavbarPrint=true|false The Print button will be shown on the navigation bar
    NavbarForward=true|false The Forward button will be shown on the navigation bar
    NavbarBackward=true|false The Backward button will be shown on the navigation bar
    NavbarHome=true|false The Home button will be shown on the navigation bar
    NavbarUrl=true|false The address bar will be shown
    NavbarRefresh=true|false The Refresh button will be shown on the navigation bar
    Favorite=true|false If true, the object is marked as a favorite.
    FriendlyName=<Anzeigename> Display name for the user

  4. Transfer the kioskmode.ini file to the devices to /setup/kioskmode.ini. To do so, use the Scout feature Files configured for transfer. For further information, see Files configured for transfer.

The terminal.ini entry along with the kioskmode.ini file on the device will cause the Builtin-Browser to open in kiosk mode after system start-up. The configured functions are available to the user. No applications other than the browser can be started.

For correct use of the kiosk mode, we recommend that you restrict the user rights for the device as required.

Defining different web pages for devices/OUs

If you want your devices to start with different browser startup pages (Url) or have different home pages (Homepage), you can parameterize the web pages using environment variables. Carry out the steps described above with the following differences:

  1. In the kioskmode.ini, in the [Browser1] section, for the first and/or second value, set a variable. Example:
    Url=$URL1
    Homepage=$URL2

  2. Define the varables used in the kioskmode.ini as environment variables for the relevant devices (Advanced device configuration). Example:
    URL1=https://www.unicon.com
    URL2=https://myelux.com

    For further information, see Environment variables.