System Configuration Modification

Important Tips

Must Read

• The settings in the part of the configuration file will only take effect after the first system startup following a burn-in.
• This tutorial provides only modifiable options.

Note

• Try to use the mainsail or fluidd web pages for configuration modification.
• Do not open web page translation, as the system may fail to start after saving.
• Avoid entering Chinese or special characters in the configuration file.
• After modifying the configuration file, the system needs to be restarted for changes to take effect.

dangerous

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

How to Modify the Configuration File

Modify the Configuration File After Burning

• The configuration items that are only effective on the first startup must be modified by using a professional text editor to open the configuration file config.txt in the removable disk FlyOS-Conf after burning.

Online Configuration Modification While the System is Running

• If it is a regular configuration item, modifications made through the system web configuration page will take effect after restarting the system.

  • Open the device IP address in the browser, for example: http://192.168.1.2/
  • For fluidd, uncheck -> and select Hide hidden files and folders as shown in the left figure.
  • For mainsail, check -> and select Show hidden files as shown in the right figure.
  • At this point, you can see the .flyos-config folder. Enter this folder to find the sys-config.conf file.
  • The sys-config.conf file is a soft link to the configuration file config.txt in the removable disk FlyOS-Conf.
  
  • Open the sys-config.conf file, make the necessary modifications, save and close it.
  
  • Note: The format of the configuration items in the sys-config.conf file is key=value, do not change it to key: value.
  • After saving the changes, restart the system for them to take effect.

Configuration Items

Wireless Network Configuration

• The following configuration items will take effect every time the system starts.

Configuration Item	Default Value	Usable Values	Description
WIFI_SSID	Empty	Any WIFI name	WIFI name; if filled, the system will prioritize connecting to this WIFI at startup
WIFI_PASS	Empty	Leave blank if no password	WIFI password; if filled, the system will connect to WIFI with a password

---

Printer Default Configuration

tip

• The following configuration items will only take effect on the first startup.

Configuration Item	Default Value	Usable Values	Description
language	zh-CN	Click to expand detailed content zh-CN, zh-HK, en, de, cz, es, hu, ja, nl, pt, se, uk, da, fr, it, ko, pl, ru, tr	Set the default language for fluidd and mainsail during the first startup
printer_name	Empty	Any string	Set the default printer name for fluidd and mainsail during the first startup

---

System Configuration

• The following configuration items will take effect every time the system starts.

Configuration Item	Default Value	Usable Values	Description
console	serial	serial, both	This configuration item should not be modified; only serial is valid
board	H5: fly-pi-v2 H3: fly-lite2.1	Click to expand H5 series fly-pi, fly-pi-v2, fly-gemini-v1, fly-gemini-v2, fly-gemini-v3, fly-c8 Click to expand H3 series fly-lite2, fly-lite2.1, fly-minipad	Mainboard model, mainly used for automatic firmware burning, etc.
shutdown_pin_state	1	0, 1	Set the voltage level state of the power-off button 1: Low level trigger 0: High level trigger
shutdown_pin	none	PA21, PA4...	Set the trigger pin of the power-off button; default none disables it
spidev	spidev0.0 spidev1.0	spidev0.0, spidev0.1, spidev1.0, spidev1.1	Set the SPI port to enable To enable multiple ports, separate them with spaces
localtime	Asia/Shanghai	World Time Zone Table	Set the system's default time zone; the system will automatically adjust the time after connecting to the network
canbus_bitrate	1000000	1000000, 500000, 250000	Set the default rate for all CAN devices in the system; default is 1M

---

Printer Type Configuration

• The following configuration items will take effect every time the system starts.

Configuration Item	Default Value	Usable Values	Description
printer	klipper	klipper, rrf	Configure which service to start the system klipper: klipper, moonraker, etc. rrf: RRF DSF, DWC, etc.

Display Configuration

• The following configuration items will take effect every time the system starts.

Configuration Item	Default Value	Usable Values	Description
screen	hdmi	Click to expand H5 series none, hdmi, fly-tft-v1, fly-tft-v2-r, fly-tft-v2-c Click to expand H3 series none, hdmi, fly-tft-v1, fly-minipad-r, fly-minipad-c, fly-tft-v2-r, fly-tft-v2-c	Set the screen; none turns off all displays
rotate	90	0, 90, 180, 270	Set the rotation angle of FLY-TFT; invalid for HDMI

---

Klipper Related Configuration

• The following configuration items will take effect every time the system starts.

Configuration Item	Default Value	Usable Values	Description
klipper_screen	0	0, 1	Set whether to enable KlipperScreen 1: Enable 0: Disable Valid when printer=klipper
moon2uart	0	0, 1	Set whether to enable moon2uart 1: Enable 0: Disable Valid when printer=klipper
m2u_port	/dev/ttyS1	Valid serial ports	Serial port for moon2uart, valid when moon2uart=1
m2u_baud	115200	Valid baud rates	Baud rate for moon2uart, valid when moon2uart=1
klipper_webui	fluidd	fluidd, mainsail	Set the default Klipper front-end UI Does not affect the online one-click switching function Valid when printer=klipper

---

RRF Related Configuration

• The following configuration items will take effect every time the system starts.

Configuration Item	Default Value	Usable Values	Description
rrf2uart	0	0, 1	Temporarily invalid; functionality will be provided in future versions

---

Other Settings

• The following configuration items will take effect every time the system starts.

Configuration Item	Default Value	Usable Values	Description
crowsnest	0	0, 1	Set whether to enable Crowsnest 1: Enable 0: Disable Valid for both Klipper and RRF modes

tip

• The following configuration items will only take effect on the first startup.

Configuration Item	Default Value	Usable Values	Description
firmware	Empty	Valid firmware file paths	Set the firmware to automatically burn on startup; currently only valid for C8 and Gemini-V3

---

dangerous

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