System Configuration Modification

Must Read

• The settings in the part of the configuration file will only take effect after the first system startup after burning.
• Therefore, please modify the configuration file config.txt in the removable disk FlyOS-Conf after burning, and then insert the card into the board to start the system.

Note

• Try not to use the built-in Notepad of Windows system to edit the configuration file; you can use VSCode or other professional text editors.
• Avoid entering Chinese or special characters in the configuration file.
• After modifying the configuration file, you need to restart the system for it 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

Modifying 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 When the System is Running

• If it is an ordinary 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 as shown on the left in the figure -> "Filter and hide files and folders".
  • For Mainsail, check as shown on the right in the figure -> "Show hidden files".
  • At this point, the .flyos-config folder can be seen; enter this folder to have the sys-config.conf file.
  • The sys-config.conf file is a symbolic link of the configuration file config.txt in the removable disk FlyOS-Conf.
  
  • Open the sys-config.conf file, make the necessary modifications to the configuration items, 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 modification, restart the system for it 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 in, the system will automatically prioritize connecting to this WIFI when starting up
WIFI_PASS	empty	Leave blank if no password	WIFI password; if filled in, use the password to connect to WIFI

---

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 level state of the shutdown button 1: Triggered by low level 0: Triggered by high level
shutdown_pin	none	PA21, PA4...	Set the trigger pin of the shutdown button, default none disables it
spidev	spidev0.0 spidev1.0	spidev0.0, spidev0.1, spidev1.0, spidev1.1	Set the SPIDEV ports to be enabled; separate multiple ones with spaces
localtime	Asia/Shanghai	World Time Zone Table	Set the default time zone of the system; 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 port	Serial port for moon2uart, valid when moon2uart=1
m2u_baud	115200	Valid baud rate	Baud rate for moon2uart, valid when moon2uart=1
klipper_webui	fluidd	fluidd, mainsail	Set the default front-end UI for Klipper Does not affect the one-click switching function online 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 path	Set the firmware to be burned at 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.