Configuration

System Configuration

Accessing the Control Panel

When fomeOS boots, it shows a splash screen for four seconds, if you want to access the control panel press any key, if don’t the kioks program will start as normal.
By default, the kiosk mode is set to “Website” and it will load the control panel. And also by default, you can access the control panel by opening a web browser and navigating to http://<kiosk's IP>:9090.
Control Panel

Login with the default credentials

As shown on Step 10: First Boot, in order to login to the control panel for first time, use the default credentials:
- Username: fomeos
- Password: fomeos
Control Panel

Changing the default password

The user fomeos runs the kiosk session and has administrative privileges.
It is really important to change the default password for security reasons.
fomeOS User Account

  1. Navigate to Accounts in the left sidebar

  2. Click the fomeos user

  3. Click on Set password to change the default password.

  4. Click on Set password to save the new password.

User Account Settings

Network Configuration

To configure an Ethernet interface:

1. Navigate to Networking in the left sidebar 1. Click on the interface name (e.g., ens18) 2. The interface details page shows:

  • Status: Current connection status

  • IP Address: IPv4 address

  • Carrier: Whether the interface is connected

  • General settings: Connection auto-connect option

Network Interface Details

View network interface status and configuration

  1. Click Edit next to IPv4

4. Choose Manual to set a static IP or Automatic for DHCP 4.1 - If using manual:

  • Enter Address: Static IP (e.g., 192.168.1.100/24)

  • Enter Gateway: Default gateway IP

  • Configure DNS: Add DNS servers

  • Set Search domains: For DNS resolution

  • Click Save to apply changes

IPv4 Network Configuration

WiFi Configuration

TBC

In order to configurate more advanced network settings like VPNs, bonding, VLAN, etc, please reach the Cockpit official documentation.

Display Rotation

Display Rotation Configuration

Rotate your display for portrait or landscape orientation:

  1. Go to Display Configuration in the Tools menu

  2. Select your display from the dropdown

  3. Choose rotation angle:

    • Normal (0°): Standard landscape

    • Left (90°): Rotated 90° counter-clockwise (portrait)

    • Inverted (180°): Upside down

    • Right (270°): Rotated 90° clockwise

  4. Click Apply Rotation to save

Kiosk Mode Configuration

By default, fomeOS comes with three kiosk modes: Website, Video, and Remote Desktop. You can switch between these modes from the control panel. Also, you can add your own custom mode by selecting Others and entering the command to run at startup.

Website Mode (Kiosk Browser)

Display a website in full-screen kiosk mode:

  1. In fomeOS Menu, select the Website mode

  2. Enter the Website (URL) field with:

    • Example: http://fomeos.com

    • Or any external URL

  3. Click Save to apply

  4. The system will launch Firefox in kiosk mode displaying the website

Website Mode Configuration

Video Mode (Media Player)

Play videos in a loop:

First you need to copy your video files to the /home/fomeos/Videos/ directory. You can do this by connecting a USB drive with the videos or by using a file transfer method like SCP or SFTP.
In order to copy a file from a USB:

  1. Click Storage

  2. Select the partition of the USB drive (e.g., sdb1)

  3. Click Mount and enter the path /media on Mount Point

  4. Mount clicking on Mount

  5. Go to File browser and navigate to the mounted USB drive (e.g., /media/)

  6. Copy the video files to the Videos folder in the home directory (e.g., /home/fomeos/Videos/)

To configure video playback: 1. Select the Video mode in fomeOS Menu 2. Enter Video name: The video filename (e.g., video.mp4) 3. Path: Videos are stored in /home/fomeos/Videos/ 4. Click Save 5. The system will play the video with loop and fullscreen options

Video Mode Configuration

Configure video file for continuous playback

Remote Desktop Mode (Remmina)

Connect to a remote desktop:

  1. Select Remote Desktop (Remmina) mode

  2. Enter connection details:

    • Server: Remote server address (e.g., server.example.com:3389)

    • Username: Remote user account

    • Password: Remote user password

  3. Click Save

  4. The system will open Remmina and connect to the remote desktop

  5. Note: RDP server certificate will be requested on first connection

Remote Desktop Configuration

Configure RDP connection settings for remote desktop access

Others Mode

Run custom commands:

  1. Select Others mode

  2. Enter Command: The executable to run

  3. Enter Args: Command-line arguments (flags and values)

  4. The preview shows the exact command that will be executed

  5. Click Save to apply

Others Mode Configuration

Configure custom commands to run at system startup