# Creality Nebula Smart Kit Setup Guide For Creality Nebula Smart Kit. Adds Klipper capabilities to compatible printers. ## Requirements - Creality Nebula Smart Kit - Compatible Creality printer ## Steps ### Step 1: Readying Nebula Smart Kit ## Before You Start: Custom Firmware **This printer requires custom firmware to work with SimplyPrint.** We know that sounds technical — and it is one of the more involved setups — but we've worked hard to make it as straightforward as possible. **Why is custom firmware needed?** Some printer manufacturers don't provide an easy way for platforms like SimplyPrint to communicate with their printers. The community has developed alternative firmware that unlocks these capabilities. **Is this safe?** Yes. The firmware we guide you through: - Is developed and tested by active communities - Can typically be removed to restore your original firmware - Preserves your printer's core functionality In most cases, you can always roll back to stock firmware or factory reset your printer if needed. **A note about warranty** Some manufacturers may consider custom firmware a warranty modification. The risk is low — to date, we haven't had a single known case of a SimplyPrint user damaging their printer or being denied warranty repair because of this setup. That said, it's ultimately your choice to proceed. **Estimated time:** 15–30 minutes **We'll guide you through every step.** ### You'll Also Use SSH This setup requires SSH — a way to send text commands to your printer from your computer. We know it sounds technical, and we wish we could avoid it, but unfortunately the printer's design leaves us no other option. The good news: it's simpler than it sounds. You'll just copy and paste a few commands we provide — no coding required. **New to SSH?** No problem! We have a beginner-friendly guide: [SSH: What is it and how to use it](https://help.simplyprint.io/en/article/ssh-what-is-it-and-how-to-use-it-1pb1aq0/) ### Set up Klipper and SimplyPrint on the Creality Nebula Smart Kit In this guide we will go through: 1. Download and install the rooted firmware 2. Find your Nebula's IP address 3. Connect via SSH and run the installer 4. Install Klipper, Moonraker, and SimplyPrint 5. Enable camera settings 6. Access your web interface --- ### 1. Download and install the rooted firmware 1. Download the latest `NEBULA_ota_img_V6.*.img` file from the latest release on GitHub. 2. Transfer the `.img` file to the USB stick that came with your Nebula. 3. Insert the USB stick into the Nebula. 4. On the Nebula screen, press the **"Upgrade"** button when the firmware upgrade pop-up appears. 5. Wait for the installation to finish. The Nebula will reboot automatically when complete. --- ### 2. Find your Nebula's IP address 1. On the touchscreen, navigate to **"Settings"** → **"Network"**. 2. Note down the IP address shown on the network screen (e.g. `192.168.0.42`). --- ### 3. Connect via SSH and run the installer 1. Open a terminal or SSH client on your computer. 2. Connect to the Nebula using SSH with the IP address you noted: ```bash ssh root@[IP_ADDRESS] ``` For example; `ssh root@192.168.0.152` 3. When prompted for a password, enter: `creality` - don't get confused by the password not showing up while you type it; that's normal 4. Once connected, run the Creality Helper Script: ```bash ./installer.sh ``` --- ### 4. Install Klipper, Moonraker, and SimplyPrint 1. When the script menu appears, choose **"1) [Install] Menu"**. 2. Install the following components in order: - **1) Moonraker and Nginx** - **2) Fluidd (port 4408)** or **3) Mainsail (port 4409)** - choose your preferred interface (not sure which to pick? We recommend **Mainsail**) - **5) Klipper Gcode Shell Command** - **10) Nebula Camera Settings Control** - **11) USB Camera Support** - **17) SimplyPrint** 3. Wait for each installation to complete before proceeding to the next. --- ### 5. Enable camera settings 1. Return to the main menu of the Creality Helper Script. 2. Navigate to **"5) [Tools] Menu"**. 3. Choose **"3) Enable camera settings in Moonraker"**. --- ### 6. Access your web interface 1. Open a web browser on your computer. 2. Navigate to `http://[YOUR_IP]:[PORT]`, where: - `[YOUR_IP]` is the IP address you noted earlier - `[PORT]` is `4408` for Fluidd or `4409` for Mainsail 3. For example: `http://192.168.0.42:4409` --- And that's it! Your Nebula Smart Kit is now running Klipper with SimplyPrint. > ℹ️ **Factory reset option:** If you need to perform a factory reset, you can add an empty file named factory_reset (no file extension) to the USB stick, then turn off the Nebula, insert the USB stick, and turn it back on. **Warning:** This will permanently delete all user-installed software and custom configurations. Only Wi-Fi settings, printer identity, and essential system files will be preserved. For more details, see the [GitHub repository](https://github.com/SimplyPrint/printer-nebula-firmware#factory-resetting). ### Step 2: Set up Your printer runs Klipper firmware with a web interface (Mainsail or Fluidd). Here's how to connect it to SimplyPrint. #### Find Your Printer's IP Address You need to access your printer's web interface using its IP address (looks like `192.168.1.XXX`). **How to find it:** - **Printer's touchscreen:** Check Settings → Network or WiFi section (location varies by printer) - **Router admin page:** Look for connected devices and find your printer's name - **Network scanner app:** Use an app like "Fing" on your phone to scan your network - **mDNS hostname:** Some printers respond to hostnames like `http://mainsail.local` or `http://fluidd.local` Once you have the IP, type it in any web browser: `http://192.168.1.XXX` You'll see your printer's web interface - either **Mainsail** (dark theme, sidebar on left) or **Fluidd** (lighter theme, gear icon for settings). **Note:** Some printers run their interface on a specific port (e.g., `http://192.168.1.XXX:4408`). If the default doesn't work, check your printer's documentation. --- #### Add `[simplyprint]` to Your Configuration **If you use Mainsail:** 1. Click **Machine** in the left sidebar 2. Under **Config Files**, click `moonraker.conf` - NOTE: If you have a custom config file or one called `moonraker.generated.config`, edit that instead 3. Add this to the bottom of the file (with an empty line above): ``` [simplyprint] ``` 4. Click **Save & Restart** **If you use Fluidd:** 1. Click the **gear icon** (Configuration) 2. Under **Configuration Files**, click `moonraker.conf` - NOTE: If you have a custom config file or one called `moonraker.generated.config`, edit that instead 3. Add this to the bottom of the file (with an empty line above): ``` [simplyprint] ``` 4. Click **Save & Restart** --- #### Link Your Printer to SimplyPrint After saving and restarting, your printer should appear automatically in SimplyPrint! 1. Go to [SimplyPrint.io](https://simplyprint.io) and log in 2. Click **Add Printer** 3. Check **Pending Printers** - your printer will likely appear there automatically 4. Click to add it and you're done! 🎉 **If your printer doesn't appear in Pending Printers:** This can happen if you're not on the same network as your printer (different outgoing IP). In this case, use the setup code: 1. In your printer's web interface, click the **bell icon** (🔔) in the top bar 2. Find the "SimplyPrint Setup Request" notification 3. Copy the setup code and paste it in SimplyPrint under **Add Printer** **Still having trouble?** See our troubleshooting guide: [Printer in setup isn't detected / can't find setup code](https://help.simplyprint.io/en/article/printer-in-setup-isnt-detected-cant-find-setup-code-3jyftm/). This also helps if you can't find Mainsail/Fluidd or the web interface isn't working.