Migrating from Klipper¶

Note

Any add-on modules you are using will need to be reinstalled after switching to Kalico. This includes things like Beacon support, led-effect, etc.

Any data in ~/printer_data such as printer configs and macros will be unaffected, THOUGH do back up just in case.

Option 1. Manually clone the repository¶

If desired, make a backup copy of your existing Klipper installation by running:

mv ~/klipper ~/klipper_old

Then clone the Kalico repo and restart the klipper service:

git clone https://github.com/KalicoCrew/kalico.git ~/klipper
sudo systemctl restart klipper

Option 2. Using KIAUH¶

For users that are not comfortable using Git directly, KIAUH v6 is able to use custom repositories.

To do this, add the Kalico repo to KIAUH's custom repository config with the following steps:

Setup kalico as repository in KIAUH - cd ~/kiauh - cp default.kiauh.cfg kiauh.cfg - nano kiauh.cfg - add https://github.com/KalicoCrew/kalico, main for the main branch
or https://github.com/KalicoCrew/kalico, bleeding-edge-v2 for the bleeding edge branch

CTRL-X to save and exit

Select Kalico in KIAUH

From the KIAUH menu select:

[S] Settings
1) Switch Klipper source repository

Select Kalico from the list

Option 3. Adding a git-remote to the existing installation¶

Can switch back to mainline klipper at any time via a git checkout upstream_main

cd ~/klipper
git remote add kalico https://github.com/KalicoCrew/kalico.git
git checkout -b upstream-main origin/master
git branch -D master
git fetch kalico main
git checkout -b main kalico/main
sudo systemctl restart klipper
sudo systemctl restart moonraker