Guide to Switching Klipper Versions

Applicable Conditions

This document applies only to devices using the FlyOS-FAST system.

Important Feature Change Notice

Please note: Switching to either the Kalico branch or the official original Klipper will cause the exclusive features of the FlyOS-FAST system, such as power failure recovery printing and USB drive printing, to completely fail. These features are deeply integrated with the FlyOS-FAST customized system and cannot be used in other Klipper versions.

If you rely on these features, please carefully consider whether to switch versions.

Before performing any version switch, please ensure you understand the operational risks. It is recommended to perform additional backups of important configuration files before proceeding.

General Step Instructions

The following operations all consist of three main phases:

1. Backup the current version
2. Pull and replace with the target version
3. Restart the service to take effect

If issues arise with the new version, you can quickly revert using the backup.

---

Installing the Kalico Branch

1. Backup Current Klipper

   mv /data/klipper /data/klipper_old

2. Pull the Kalico Version

   git clone https://github.com/KalicoCrew/kalico.git /data/klipper

   tip

   Due to network or server reasons, the pull process may be slow or fail. If you encounter problems, you can try repeating the command or checking your network connection.

3. Restart the Klipper Service

   sudo systemctl restart klipper

4. Demonstration

   • An interface similar to the following indicates a successful pull.
   

---

Installing Official Original Klipper

1. Backup Current Klipper

   mv /data/klipper /data/klipper_old

2. Pull the Official Version

   git clone https://github.com/Klipper3d/klipper.git /data/klipper

   tip

   Due to network or server reasons, the pull process may be slow or fail. If you encounter problems, you can try repeating the command or checking your network connection.

3. Restart the Klipper Service

   sudo systemctl restart klipper

---

Reverting to a Previous Version

If you encounter issues after switching, you can revert to the backed-up version at any time:

rm -rf /data/klipper

# Restore the backup
mv /data/klipper_old /data/klipper

# Restart the service
sudo systemctl restart klipper

Feature Recovery

After reverting to the original FlyOS-FAST system Klipper version, exclusive features such as power failure recovery printing and USB drive printing will be automatically restored.

caution

The revert operation will overwrite the current /data/klipper directory. Please ensure you no longer need to keep the current version's files.

Verifying the Version

After restarting the service, you can confirm whether the current running version has been successfully switched via the Klipper web interface or logs.