# ④Install Happy Hare

## **Install Happy Hare**

{% hint style="success" %}

#### Disclaimer:

Please note that the following content on this page is based on the SIBOOR VORON 2.4 AUG kit and is provided for reference purposes only. The text, images, and other materials are sourced from the Happy Hare Wiki, but some pages have been significantly condensed and simplified.

If you are not using this specific machine kit, to avoid incorrect operations or missing important information, you may visit the complete tutorial at <https://github.com/moggieuk/Happy-Hare/wiki>.
{% endhint %}

### ※**Clone the Happy Hare Repo**

Log in to SSH and execute the following command to clone the Happy Hare software onto your printer's Pi

```
cd ~
git clone https://github.com/moggieuk/Happy-Hare.git
```

Use the following `cd` command to change to the Happy Hare directory:

```
cd Happy-Hare
```

### ※**Run the installer**

Send the following command to run the Happy Hare program.

```
./install.sh -i
```

### ※Create a basic Klipper configuration.

After sending the command, an interactive installer will be launched to set some initial parameters and configure the pins for the EBB MMB board. You can confirm your selections by entering the corresponding number or typing "y" or "n," then pressing Enter. The following content is primarily aimed at users of SIBOOR VORON 2.4 and Trident 3D printers; if you are using other devices, you can modify the settings according to your specific needs.

{% stepper %}
{% step %}
**What type of MMU are you running?**

* [ ] 1）ERCF v1.1 (inc TripleDecky, Springy, Binky mods)
* [x] <mark style="color:blue;">2）ERCF v2.0</mark>
* [ ] 3）Tradrack v1.0
* [ ] 4）Other (or just want starter config files) MMU Type? (1-4)?&#x20;

<mark style="color:blue;">Enter</mark><mark style="color:blue;">**`2`**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">and press Enter to confirm.</mark>
{% endstep %}

{% step %}
**How many gates (selectors) do you have?**

The SIBOOR ERCF V2 KIT is the 8-channel version. Enter **8** and press Enter to confirm.
{% endstep %}

{% step %}
**Select mcu board type used to control MMU**

* [ ] 1）BTT MMB v1.0 (with CANbus)
* [x] <mark style="color:blue;">2）BTT MMB v1.1 (with CANbus)</mark>
* [ ] 3）Fysetc Burrows ERB v1
* [ ] 4）Fysetc Burrows ERB v2
* [ ] 5）Standard EASY-BRD (with SAMD21)
* [ ] 6）EASY-BRD with RP2040
* [ ] 7）Mellow EASY-BRD v1.x (with CANbus)
* [ ] 8）Mellow EASY-BRD v2.x (with CANbus)
* [ ] 9）Not in list / Unknown&#x20;

<mark style="color:blue;">The SIBOOR ERCF V2 KIT uses the BTT MMB V1.1 board.</mark>

<mark style="color:blue;">Enter</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**`2`**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">and press Enter to confirm.</mark>
{% endstep %}

{% step %}
**Touch selector operation using TMC Stallguard? This allows for additional selector recovery ste ps but is difficult to tune Not recommend if you are new to MMU/Happy Hare & MCU must have DIAG output for steppers. Can co nfigure later Enable selector touch operation (y/n)?**&#x20;

<mark style="color:blue;">※It is not recommended for beginners to enable this.</mark>

<mark style="color:blue;">Enter</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**`n`**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">and press Enter to confirm.</mark>
{% endstep %}

{% step %}
**Would you like to have neopixel LEDs setup now for your MMU? Enable LED support? (y/n)? Enable LED support? (y/n)?**&#x20;

<mark style="color:blue;">※是的，SIBOOR ERCF V2 KIT包含LED，</mark>

<mark style="color:blue;">Enter</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**`y`**</mark><mark style="color:blue;">and press Enter to confirm.</mark>
{% endstep %}

{% step %}
**Which servo are you using?**

* [ ] 1）MG-90S
* [ ] 2）Savox SH0255MG
* [x] <mark style="color:blue;">3）GDW DS041MG</mark>
* [ ] 4）Not listed / Other Servo? (1-4)? 3

<mark style="color:blue;">※SIBOOR ERCF V2 KIT包含GDW DS041MG舵机，</mark>

<mark style="color:blue;">Enter</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**`3`**</mark><mark style="color:blue;">and press Enter to confirm.</mark>
{% endstep %}

{% step %}
**Clog detection? This uses the MMU encoder movement to detect clogs and can call your filament runout logic Enable clog detection (y/n)?**&#x20;

<mark style="color:blue;">※The SIBOOR ERCF V2 KIT uses encoders to check for stalls.</mark>

<mark style="color:blue;">Enter</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**`y`**</mark><mark style="color:blue;">and press Enter to confirm.</mark>

**Would you like MMU to automatically adjust clog detection length (recommended)? Automatic (y/n)?**&#x20;

<mark style="color:blue;">※Enable automatic adjustment of the jam detection length, as it helps with troubleshooting.</mark>

<mark style="color:blue;">Enter</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**`y`**</mark><mark style="color:blue;">and press Enter to confirm.</mark>
{% endstep %}

{% step %}
EndlessSpool? This uses filament runout detection to automate switching to new spool without interruption Enable EndlessSpool (y/n)?&#x20;

<mark style="color:blue;">※The purpose of this feature is to automatically switch to a new spool of filament when the current one runs out, ensuring uninterrupted printing.</mark>

<mark style="color:blue;">Enter</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**`y`**</mark><mark style="color:blue;">and press Enter to confirm</mark>.
{% endstep %}

{% step %}
**Finally, would you like me to include all the MMU config files into your printer.cfg file Add include? (y/n)?**&#x20;

<mark style="color:blue;">※Yes, all newly added conf</mark>i<mark style="color:blue;">guration files must be referenced in the</mark> <mark style="color:blue;"></mark><mark style="color:blue;">`printer.cfg`</mark><mark style="color:blue;">.</mark>

<mark style="color:blue;">Enter</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**`y`**</mark><mark style="color:blue;">and press Enter to confirm.</mark>

**Would you like to include Mini 12864 menu configuration extension for MMU Include menu (y/n)?**

<mark style="color:blue;">※We do not use the MINI 12864 display. (You can also choose according to your actual situation.)</mark>

<mark style="color:blue;">Enter</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**`n`**</mark><mark style="color:blue;">and press Enter to confirm.</mark>

**Would you like to include subset of the legacy ERCF\_ command set compatibility module Include legacy ERCF command set (not recommended) (y/n)?**&#x20;

<mark style="color:blue;">※Using the old command set may lead to compatibility issues, so it is recommended not to use it.</mark>

<mark style="color:blue;">Enter</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**`n`**</mark><mark style="color:blue;">and press Enter to confirm.</mark>

**Would you like to include the default pause/resume macros supplied with Happy Hare Include client\_macros.cfg (y/n)?**&#x20;

<mark style="color:blue;">※After installing the ERCF V2, the pause and resume macros need to be modified. Using the macros provided by Happy Hare is a good idea.</mark>

<mark style="color:blue;">Enter</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**`y`**</mark><mark style="color:blue;">and press Enter to confirm.</mark>

**Addons: Would you like to include the EREC filament cutter macro (requires EREC servo installation) Include mmu\_erec\_cutter.cfg (y/n)?**&#x20;

<mark style="color:blue;">Enter</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**`n`**</mark><mark style="color:blue;">and press Enter to confirm.</mark>

**Addons: Would you like to include the Blobifier purge system (requires Blobifier servo installation) Include blobifier.cfg (y/n)?**&#x20;

<mark style="color:blue;">※The SIBOOR ERCF V2 KIT does not include the Blobifier purge system.</mark>

<mark style="color:blue;">Enter</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**`n`**</mark><mark style="color:blue;">and press Enter to confirm.</mark>
{% endstep %}
{% endstepper %}

From here, Happy Hare will install itself based on the options you selected. You should receive a nice little report indicating that Happy Hare is ready:

<figure><img src="/files/BVIxsIql5NiOvTNjXkqW" alt=""><figcaption></figcaption></figure>

Once successfully run, you will install the summary configuration file. Happy Hare creates a file hierarchy in the Klipper configuration directory. To view the layout and purpose of each file, please refer to the configuration reference.

Now that you have installed Happy Hare on your printer, it feels great, doesn't it?


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.siboor.com/siboor-ercf-v2/the-build/4install-happy-hare.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.