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://:9090``. .. figure:: /_static/images/configuration/start.png :alt: Control Panel :width: 100% 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 .. figure:: /_static/images/installation/10.jpg :alt: Control Panel :width: 100% 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. .. figure:: /_static/images/configuration/accounts1.png :alt: fomeOS User Account :width: 100% 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. .. figure:: /_static/images/configuration/accounts2.png :alt: User Account Settings :width: 100% 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 .. figure:: /_static/images/configuration/net1.png :alt: Network Interface Details :width: 100% View network interface status and configuration 3. 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 .. figure:: /_static/images/configuration/net2.png :alt: IPv4 Network Configuration :width: 100% WiFi Configuration ~~~~~~~~~~~~~~~~ TBC In order to configurate more advanced network settings like VPNs, bonding, VLAN, etc, please reach the Cockpit official `documentation `_. Display Rotation ~~~~~~~~~~~~~~~~ .. figure:: /_static/images/configuration/rotate1.png :alt: Display Rotation Configuration :width: 100% 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 .. figure:: /_static/images/configuration/web1.png :alt: Website Mode Configuration :width: 100% 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 .. figure:: /_static/images/configuration/video1.png :alt: Video Mode Configuration :width: 100% 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 .. figure:: /_static/images/configuration/rdp1.png :alt: Remote Desktop Configuration :width: 100% 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 .. figure:: /_static/images/configuration/other1.png :alt: Others Mode Configuration :width: 100% Configure custom commands to run at system startup