Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Mainsail

docs.mainsail.xyz

  • Free plan
  • Linux
  • Web
  • API
  • Self-hosted
7.8 Club score Visit docs.mainsail.xyz

What Mainsail is

Mainsail is a web interface for managing and monitoring 3D printers powered by Klipper firmware. It works with Moonraker, which provides the API, while Klipper controls the printer; both are required. One interface can manage multiple printers and show live temperatures, print progress, and printer state. Users can upload, organize, and edit G-Code and configuration files in a browser, run configurable macros, and use print history, temperature presets, and object exclusion during a print. Bed Mesh and G-Code Viewer tools support print diagnostics. Users can rearrange dashboard cards and navigation and customize themes with logos, backgrounds, and CSS. Mainsail also supports webcam monitoring, timelapses, relays, and supported smart power devices. Documented slicer integrations include Cura, IdeaMaker, OrcaSlicer, and PrusaSlicer. Setup options include MainsailOS, KIAUH, and manual installation; MainsailOS bundles Mainsail, Moonraker, Klipper, and dependencies. Mainsail is a free, open-source project. Its hosted demo is for exploration and requires Klipper and Moonraker already installed to connect to a printer.

Who it suits

Mainsail suits people managing Klipper-based 3D printers who want browser-based monitoring and controls, including users with multiple printers. It requires Klipper firmware and Moonraker rather than serving as a standalone printer-control system.

Good to know, and what to watch

  • One interface manages multiple printers
  • Browser-based G-Code and configuration file editing
  • Includes Bed Mesh and G-Code Viewer
  • Supports webcam monitoring and timelapses
  • Requires Klipper firmware and Moonraker
  • Hosted demo requires both components already installed
  • No cloud slicing or model repair

Mainsail

Free

Free plan

The verdict

Mainsail provides a configurable browser interface for Klipper printer management, with monitoring, file tools, and diagnostics. It is a fit when Klipper and Moonraker are part of the setup; support is community-based and responses may take longer depending on time zone.

What the maker publishes

Architecture
Mainsail is a front-end that works with Moonraker, which provides the API, and Klipper, which controls the printer. source
Cameras and power
Mainsail supports webcam monitoring, timelapses, and control of relays and supported smart power devices. source
Customization
Users can arrange dashboard cards and navigation, and customize themes with logos, backgrounds, and CSS. source
Customization
Users can rearrange dashboard cards and navigation, and customize themes with logos, backgrounds, and custom CSS. source
Deployment options
Installation options include MainsailOS, KIAUH, manual installation, and a hosted demo intended for testing and exploration. source
Files and macros
Users can upload, organize, and edit G-Code and configuration files in a browser, and run configurable macros with prompts and parameters. source
Files and macros
Users can manage G-code and configuration files in the browser and organize and run macros with prompts and parameters. source
Hosted demo limit
The hosted demo is intended for testing and exploration and requires Klipper and Moonraker to already be installed to connect to a printer. source
Installation
The recommended setup is MainsailOS, a prebuilt image that includes Mainsail, Moonraker, Klipper, and dependencies; KIAUH and manual installation are also documented. source
Installation requirements
Mainsail is the frontend and requires Klipper firmware and Moonraker, which acts as its API server, to work. source
Integrations
Mainsail supports slicer workflows and documents Cura, IdeaMaker, OrcaSlicer, and PrusaSlicer integrations. source
Live controls
The Moonraker-based interface provides real-time printer control and monitoring of temperatures, progress, and printer state. source
MainsailOS
MainsailOS is a prebuilt image for supported single-board computers that includes Mainsail, Moonraker, Klipper, Crowsnest, Sonar, and a timelapse plugin. source
Maintainers
Mainsail describes itself as an open-source project maintained by meteyou and a community. source
Multiple printers
One Mainsail interface can control and monitor multiple printers. source
Printer management
The interface can manage multiple printers and show live temperatures, print progress, and printer state. source
Print tools
Features include print history and statistics, bed mesh and G-code visualization, temperature presets, and object exclusion during a print. source
Privacy
The privacy page says Mainsail stores static files in browser storage, communicates directly with the printer through Moonraker, and has no telemetry or external data transfers. source
Privacy
The documentation says Mainsail runs locally in the browser, communicates directly with the printer through Moonraker, and does not use telemetry or transfer data externally. source
Product
Mainsail is a web interface for managing and controlling 3D printers powered by Klipper firmware. source
Purpose
Mainsail is a web interface for managing and controlling 3D printers powered by Klipper firmware. source
Slicer integrations
The documented supported slicers are Cura, IdeaMaker, OrcaSlicer, and PrusaSlicer; configuration enables direct G-Code uploads and other features. source
Support
Mainsail lists Discord as its primary community support channel and GitHub Discussions as an alternative; the crew says it works on the project voluntarily. source
Support
The project lists Discord as its primary community support channel, GitHub Discussions as an alternative, and Reddit as community-driven help that is not officially supported. source

Checked against the maker's pages on 9 Oct 2026.