How to Install Moonraker + Fluidd/Mainsail on Creality 3D Printers Moonraker provides the API that lets a web interface communicate with Klipper. Fluidd and Mainsail are web interfaces that use Moonraker to control the printer. This guide covers installing them on supported Creality printers through Creality Helper Script. If you do not already have Creality Helper Script installed, start with How to Install Creality Helper Script on Creality 3D Printers first. ## What you are installing The relationship between the components is: ```text

Klipper ↑ Moonraker ↑ Fluidd / Mainsail

- Root access enabled
- SSH access to the printer
- Creality Helper Script installed
- The printer connected to your local network If you need to set up root and SSH access, follow the first article before continuing. ## Install Moonraker SSH into your printer using the same credentials and IP address you used when installing Creality Helper Script. Start the Helper Script: ```bash
sh /usr/data/helper-script/helper.sh
``` Select the **Moonraker** installation option and follow the prompts. The Helper Script handles the printer-specific installation and service configuration. Let the script complete before installing the web interface. ## Install Fluidd or Mainsail After Moonraker is installed, return to the Helper Script and select the web interface you want. ### Fluidd Fluidd is a lightweight interface designed specifically around Klipper and Moonraker. Choose the Fluidd installation option in the Helper Script if you want Fluidd. ### Mainsail Mainsail is another full-featured Klipper interface built around Moonraker. Choose the Mainsail installation option instead if you prefer its interface and workflow. You do **not** need both. ## Remove the Creality web interface If your goal is to replace the stock Creality web interface completely, use the Helper Script option for removing/restoring the **Creality Web Interface** after your replacement interface is installed and working. Do not remove the stock interface until you have confirmed that Moonraker and your chosen web interface work correctly. This gives you a working way back if something went wrong during installation. ## Open the new interface Once installation is complete, open a browser on a computer or phone connected to the same network as the printer. Use the printer's IP address to access the installed interface. For example: ```text
http://192.168.1.100
``` Replace the example IP with your printer's actual address. If you installed Fluidd, you should see the Fluidd interface. If you installed Mainsail, you should see Mainsail. ## Verify Moonraker The web interface should be able to connect to Moonraker automatically after the Helper Script installation. If the interface reports that Moonraker is unavailable, SSH into the printer and check the Moonraker service and its logs using the service-management tools provided by your firmware and Helper Script installation. The exact service layout can change between Creality firmware versions, so use the Helper Script's current documentation when troubleshooting service startup. ## Fluidd vs Mainsail Both interfaces provide the core functions you need for Klipper, including: - Uploading and managing G-code
- Starting and stopping prints
- Monitoring temperatures
- Viewing printer status
- Managing macros
- Accessing Klipper configuration
- Monitoring Moonraker-connected devices The main difference is the interface and workflow. Try both if you are unsure which one you prefer. You can install one, use it for a while, and switch later through the Helper Script. ## Recommended setup For a normal rooted Creality printer, my recommended setup is: ```text
Creality firmware ↓
Klipper ↓
Moonraker ↓
Fluidd OR Mainsail
``` I would also install **M600 Support** through Creality Helper Script if you want slicer-controlled filament changes. For additional features, return to the Helper Script later rather than installing every available modification at once. ## Going back to the Creality interface If you want to restore the stock Creality web interface, use the corresponding restore option in Creality Helper Script. The Helper Script is the preferred place to manage these changes because it knows the printer-specific paths and service configuration. ## Summary If you already have Creality Helper Script installed, the process is straightforward: 1. SSH into the printer.
2. Run the Helper Script.
3. Install Moonraker.
4. Install either Fluidd or Mainsail.
5. Confirm that the new web interface works.
6. Optionally remove the stock Creality web interface.
7. Add M600 Support and any other Helper Script features you actually need. If you do **not** have Creality Helper Script installed yet, start with **[How to Install Creality Helper Script on Creality 3D Printers](/posts/how-to-install-creality-helper-script-on-creality-3d-printers)**.