> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.simplyprint.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Why is my Klipper-powered printer offline?

# Why is my Klipper-powered printer offline?

This guide helps troubleshoot why your Klipper-based printer shows offline in SimplyPrint.

## How SimplyPrint connects

SimplyPrint connects through **Moonraker** - not Klipper directly.

```
SimplyPrint ←→ Moonraker ←→ Klipper ←→ Printer
```

Mainsail and Fluidd also talk to Moonraker. If they can control your printer, Moonraker is working.

---

## Start here: Where is the problem?

### Step 1: Can you access Mainsail or Fluidd?

Open your printer's web interface in a browser.

- **Can't access it?** → Your printer or Moonraker has issues - not a SimplyPrint problem
- **Can access it and printer works?** → Continue to Step 2

### Step 2: Is `[simplyprint]` in moonraker.conf?

In Mainsail or Fluidd, open the config editor and check `moonraker.conf` for:

```ini
[simplyprint]
```

- **Missing?** → [Add the SimplyPrint component](#2-1-add-simplyprint-to-moonrakerconf)
- **It's there?** → Continue to Step 3

### Step 3: Check moonraker.log for errors

Download `moonraker.log` from Mainsail/Fluidd and search for "simplyprint".

**Mainsail:** Machine > Logs > moonraker.log (download icon)

**Fluidd:** Settings > Logs > moonraker.log

- **See SimplyPrint errors?** → [Check common errors](#2-3-common-errors-in-logs)
- **No errors but still offline?** → [Check network](#2-4-network-issues)

---

## Quick reference

| Symptom | Likely cause | Solution |
|---------|--------------|----------|
| Printer never connected | `[simplyprint]` missing | [Add to moonraker.conf](#2-1-add-simplyprint-to-moonrakerconf) |
| Was working, now offline | Moonraker restarted or config changed | [Restart Moonraker](#2-2-restart-moonraker) |
| "Klippy not connected" in Mainsail/Fluidd | Klipper issue (not SimplyPrint) | Fix Klipper first |
| Offline after power outage | Services didn't start | [Restart services](#2-after-a-power-outage) |
| SimplyPrint errors in logs | Various | [Check common errors](#2-3-common-errors-in-logs) |

---

## 1. Add `[simplyprint]` to moonraker.conf

### Using Mainsail or Fluidd

1. Open config editor
2. Open `moonraker.conf`
3. Add this line anywhere:
   ```ini
   [simplyprint]
   ```
4. Save
5. Restart Moonraker

> **Note:** That's all you need - just `[simplyprint]` with nothing else. The component is built into Moonraker.

### Component doesn't work?

Your Moonraker may be outdated. Update using the update manager in Mainsail/Fluidd.

---

## 2. Restart Moonraker

> **First:** Try restarting Moonraker - this fixes many connection issues.

Many issues are fixed by restarting after config changes.

**Mainsail:** Power icon (top right) > Restart Moonraker

**Fluidd:** Settings > Services > Restart Moonraker

> Make sure you saved config changes before restarting.

---

## 3. Common errors in logs

Download `moonraker.log` and search for "simplyprint":

| Error | Meaning | Fix |
|-------|---------|-----|
| "Connection failed" | Can't reach SimplyPrint servers | Check internet connection |
| "Klippy Host not connected" | Klipper isn't running | Fix Klipper first |
| "Authorization error" | Moonraker blocking connection | Check `[authorization]` in moonraker.conf |
| No SimplyPrint entries | Component not loaded | Add `[simplyprint]` and restart |

---

## 4. Network issues

### Internet connection

Your printer needs internet for SimplyPrint. If Mainsail/Fluidd works but SimplyPrint doesn't, check connectivity.

### WiFi stability

Unstable WiFi causes random disconnections:
- Try Ethernet instead
- Move closer to router
- Check for interference

### Firewall

SimplyPrint connects outbound - no ports need opening. But make sure outbound connections aren't blocked.

---

## After a power outage

Services may not have started correctly.

1. Check if you can access the web interface
2. If yes, restart Moonraker from interface
3. If not, wait a few minutes for boot to complete

---

## Advanced: SSH troubleshooting

If you have SSH access:

**Check if Moonraker is running:**
```bash
systemctl status moonraker
```

**Restart services:**
```bash
sudo systemctl restart moonraker
```

**View logs:**
```bash
tail -100 ~/printer_data/logs/moonraker.log
```

---

## Getting help

### Gather this first

1. Download `moonraker.log` from Mainsail/Fluidd
2. Copy `moonraker.conf` (remove sensitive info)
3. Screenshot of offline printer in SimplyPrint
4. What you've tried

### Support

- **SimplyPrint Discord:** [simplyprint.io/discord](https://simplyprint.io/discord)
- **Klipper Discord:** For Klipper-specific issues

---

> Something unclear or missing in this guide? Let us know on [Discord](https://simplyprint.io/discord).

---

## Related articles

- [Webcam not detected for Klipper printer](https://help.simplyprint.io/en/article/webcam-not-detected-in-simplyprint-for-klipper-based-printer-mainsail-fluidd-moonraker-mewdfx/)
- [Multiple printers on 1 Raspberry Pi](https://help.simplyprint.io/en/article/multiple-printers-on-1-raspberry-pi-or-other-device-with-simplyprint-octoprint-or-klipper-multi-printer-setup-1yhicgv/)