System Configuration Changes

Important Notes

Must Read

• Settings in the configuration file will only take effect the first time the system starts after flashing.
• As the configuration process is relatively complicated, it is highly recommended to connect to the device via network and then configure through a browser.
• This tutorial only provides modifiable options.

Note

• It is recommended to use either mainsail or fluidd web interfaces for configuration changes.
• Please do not enable browser translation, as the system may fail to start after saving.
• It is better not to enter Chinese or special characters in the configuration file.
• Changes to the configuration file will take effect only after restarting the system.

dangerous

• Do not modify any content below ######### PLEASE DO NOT EDIT THE FOLLOWING ######### in the configuration file.

How to Modify the Configuration File

Modifying the Configuration File After Flashing

• Configuration options that only take effect on the first boot must be modified by using a professional text editor to open the config.txt configuration file located in the FlyOS-Conf removable disk immediately after flashing.

Online Configuration Modification After System Startup

• For general configuration options, you can modify them via the web configuration interface of the system and the changes will take effect after restarting the system.

  • Open the device's IP address in your browser, for example: 192.168.1.2/
  • In fluidd, uncheck the option as shown in the left image below -> Hide hidden files and folders.
  • In mainsail, check the option as shown in the right image below -> Show hidden files.
  • You will now see the .flyos-config folder. Inside this folder there is a file named sys-config.conf.
  
  • The sys-config.conf file is a symbolic link to the config.txt configuration file located in the FlyOS-Conf removable disk.
  

  • Open the sys-config.conf file, modify the required configuration items, then Save -> Close and restart the system.

  • Note: The format of configuration items in the sys-config.conf file is key=value. Do not change it to key: value.

  • After saving modifications, restart the system for the changes to take effect.

Configuration Options

🛠️ System Configuration Guide

Welcome to the system configuration guide! This guide will help you easily set up your device.

📶 Wireless Network Settings

These settings will take effect automatically on each boot

Configuration	Default	Options	Description
WIFI_SSID	Empty	Your WiFi name	After entering, it will automatically connect to this WiFi network on boot
WIFI_PASS	Empty	Your WiFi password	If the WiFi has a password, please enter it here

💡 Tip: Both fields need to be filled to successfully connect to WiFi

---

🖨️ Printer Basic Settings

✨ Important Note: These settings only take effect on first boot and cannot be changed afterward

Configuration	Default	Options	Description
language	zh-CN(Chinese)	Chinese, English, Japanese, German, etc. 18 languages zh-CN, zh-HK, en, de, cz, es, hu, ja, nl, pt, se, uk, da, fr, it, ko, pl, ru, tr	Set the display language of the web control interface
printer_name	Empty	Any name (e.g., "My 3D Printer")	Give your printer a name for easy identification

---

⚙️ System Basic Configuration

These settings will take effect automatically on each boot

Configuration	Default	Options	Description
board	fly-lite2.1	The value you can set is as follows Click to expand fly-lite2, fly-lite2.1, fly-minipad	Please do not set it to anything else, otherwise the system will not start
localtime	Asia/Shanghai	Time zones around the world	Set your time zone; the time will be automatically synchronized after connecting to the network
canbus_bitrate	1000000	1000000(Recommended) 500000 250000	Set the communication speed of CAN bus devices; usually keep the default

---

🖥️ Display Settings

The following settings will be applied automatically on each boot

Configuration	Default	Options	Description
screen	hdmi	none: Disable all screen displays hdmi: HDMI interface display fly-tft-v1: FLY-TFT V1 resistive touchscreen fly-tft-v2-r: FLY-TFT V2 resistive touchscreen fly-tft-v2-c: FLY-TFT V2 capacitive touchscreen fly-minipad-r: FLY-MiniPad resistive touchscreen fly-minipad-c: FLY-MiniPad capacitive touchscreen	Choose the screen type that matches your hardware
rotate	90	0: No rotation 90: Rotate 90 degrees clockwise 180: Rotate 180 degrees 270: Rotate 270 degrees clockwise	Adjust the display orientation of the FLY-TFT touchscreen This setting does not affect HDMI displays
klipper_screen	0	0: Disable 1: Enable	Whether to enable the KlipperScreen touch interface After enabling, you can operate the printer directly via the touchscreen

---

🔧 Klipper-related Settings

These settings will take effect automatically on each boot

Configuration	Default	Options	Description
klipper_webui	fluidd	fluidd mainsail	Choose the web control interface for Klipper
crowsnest	0	0: Disable 1: Enable	Whether to enable the camera monitoring feature

---

🖨️ Printer Type Selection

These settings will take effect automatically on each boot

Configuration	Default	Options	Description
printer	klipper	klipper, rrf	Choose the printer control system - klipper: Common 3D printer system - rrf: Another control system

⚠️ Important Notice

🛑 Do not modify the following content: In the configuration file, do not edit anything under ######### PLEASE DO NOT EDIT THE FOLLOWING #########, as doing so may cause the system to malfunction.