# Mainsail

Mainsail is a lightweight, responsive web interface for Klipper that lets self-hosted 3D printer owners monitor, control, and manage printers from a browser. It is open source and self-hosted, installable on Unraid and Umbrel.

Canonical page: https://ourlocalhost.com/app/3008/mainsail

## Description

Mainsail is a lightweight, responsive web interface for Klipper that lets self-hosted 3D printer owners monitor, control, and manage printers from a browser. It supports printer farms and offers an intuitive dashboard for viewing job status, adjusting settings, and troubleshooting.

## Platform availability

Available on 3 of 10 platforms: Unraid, Umbrel, Any server.

## Health score

68/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 21 days ago)
- Popular: 67 (2,248 GitHub stars)
- Easy to install: 55 (3 install platforms, install notes, Docker image)
- Security check: 20 (1 serious finding, 3 minor, CI, tests)

## Security check

1 serious finding: Uses dompurify 3.4.16, which has a known critical vulnerability.
Automated checks on commit d8688d5, 23 Oct 2026. Not an audit.

## Links

- Unraid: https://ca.unraid.net/apps/mainsail-0phcxzu0sp4c1q?q=mainsail
- Umbrel: https://apps.umbrel.com/app/mainsail
- Official website: http://my.mainsail.xyz
- GitHub: https://github.com/mainsail-crew/mainsail
- Documentation: https://docs.mainsail.xyz

## Common questions

### How can I move from a terminal to a Mainsail or Klipper GUI?

The thread suggests using a tablet, or connecting a touchscreen display to the Pi and installing KlipperScreen.

### Why might Mainsail become unreachable after a router reset?

The previous IP may no longer be valid after the reset. Check whether the printer or host got a new IP before assuming Mainsail is down.

### What Spoolman logging issue have Mainsail users reported?

Users report that the Spoolman control in the UI can log filament to the filament selected in the UI instead of the filament for the current print. In one report it pointed to a print from one or two jobs earlier.

### Does Mainsail troubleshooting cover Klipper firmware or printer hardware?

No. The troubleshooting guide focuses on problems inside the Mainsail web interface rather than underlying Klipper firmware or printer hardware issues.

---
Source: Our Local Host (https://ourlocalhost.com/app/3008/mainsail), the self-hosted and open-source app directory.
