System Configuration Changes
Important Notes
- 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.
- It is recommended to use either
mainsailorfluiddweb 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.
- 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 bootmust be modified by using a professional text editor to open theconfig.txtconfiguration file located in theFlyOS-Confremovable 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-configfolder. Inside this folder there is a file namedsys-config.conf.

- The
sys-config.conffile is a symbolic link to theconfig.txtconfiguration file located in theFlyOS-Confremovable disk.

-
Open the
sys-config.conffile, modify the required configuration items, thenSave->Closeand restart the system. -
Note: The format of configuration items in the
sys-config.conffile iskey=value. Do not change it tokey: value. -
After saving modifications, restart the system for the changes to take effect.
- Open the device's IP address in your browser, for example:
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 languageszh-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 followsClick to expandfly-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)500000250000 | 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 displayshdmi: HDMI interface displayfly-tft-v1: FLY-TFT V1 resistive touchscreenfly-tft-v2-r: FLY-TFT V2 resistive touchscreenfly-tft-v2-c: FLY-TFT V2 capacitive touchscreenfly-minipad-r: FLY-MiniPad resistive touchscreenfly-minipad-c: FLY-MiniPad capacitive touchscreen | Choose the screen type that matches your hardware |
rotate | 90 | 0: No rotation90: Rotate 90 degrees clockwise180: Rotate 180 degrees270: Rotate 270 degrees clockwise | Adjust the display orientation of the FLY-TFT touchscreen This setting does not affect HDMI displays |
klipper_screen | 0 | 0: Disable1: 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 | fluiddmainsail | Choose the web control interface for Klipper |
crowsnest | 0 | 0: Disable1: 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:
None of the content below ######### PLEASE DO NOT EDIT THE FOLLOWING ######### in the configuration file should be changed, otherwise it may cause the system to malfunction.