Skip to main content

Guide to Switching Klipper Versions

Applicable Conditions

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

Important Feature Change Notice

Please note: Whether switching to the Kalico branch or the official original Klipper, the power-loss resume printing, USB printing, and other exclusive functions of the FlyOS-FAST system will completely stop working. These functions are deeply integrated with the FlyOS-FAST customized system and cannot be used with other Klipper versions.

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

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

General Steps Description​

The following operations all include three main phases:

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

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

Installing the Kalico Branch​

  1. Backup the 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 even fail. If you encounter issues, try repeating the command or check your network connection.

  3. Restart the Klipper service

    sudo systemctl restart klipper

  4. Demonstration

    • A similar interface indicates a successful pull
    Loading...

Installing the Official Original Klipper​

  1. Backup the 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 even fail. If you encounter issues, try repeating the command or check your network connection.

  3. Restart the Klipper service

    sudo systemctl restart klipper

Restoring to a Previous Version​

If you encounter issues after switching, you can revert to the backup 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 restoring to the original FlyOS-FAST system Klipper version, the power-loss resume printing, USB printing, and other exclusive functions will automatically recover.

Warning

The restore operation will overwrite the current /data/klipper directory. Please ensure you no longer need to retain the current version files.

Verifying the Version​

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

Loading...