Mainsail

Self-Hosted

Open-source web interface for Klipper-powered 3D printer control

Overview

Mainsail is a modern, lightweight web interface tailored for 3D printers running Klipper firmware. It enables real-time monitoring of print progress, temperature, and status, plus g-code management and remote print control. Deployable on single-board computers like Raspberry Pi, it integrates seamlessly with Klipper’s advanced features (input shaping, pressure advance) and supports multi-printer setups. Its responsive design works on desktop and mobile, making remote print management easy without cloud dependency.

Self-Hosting Resources

Find Official Image on Docker Hub View Source & Docs

Below is a reference structure for docker-compose.yml. ⚠️ Do NOT run blindly. Replace placeholders with official values.

docker-compose.template.yml TEMPLATE


version: '3'
services:
  mainsail:
    image: <OFFICIAL_IMAGE_NAME>:latest
    container_name: mainsail
    ports:
      - "8080:<APP_INTERNAL_PORT>"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

Key Features

Real-time 3D printer monitoring (temp, progress, status)
G-code management & remote print control
Webcam streaming & multi-printer support

Frequently Asked Questions

? Is Mainsail hard to install?

Mainsail has a simplified installation via scripts like KIAUH, which automates setup on Raspberry Pi or similar SBCs. It requires Klipper firmware pre-installed, but official docs and community guides provide step-by-step instructions for configuration.

? Is it a good alternative to OctoPrint for Klipper users?

Yes—Mainsail is optimized for Klipper, offering faster performance and deeper integration with Klipper’s features than OctoPrint. It’s a lighter, more modern alternative tailored specifically for Klipper-powered printers.

? Is Mainsail completely free?

Yes, Mainsail is 100% open source (GPLv3 license) and free to use. There are no paid tiers or subscription fees—you can self-host it on your own hardware without any costs.

Top Alternatives

Prusa Connect Search Google

Ultimaker Cura Connect Search Google

Tool Info

Pricing Free/Open Source

Category Manufacturing

Platform Self-Hosted

Pros

⊕ Privacy-focused (no cloud dependency)
⊕ Lightweight & mobile-responsive interface
⊕ Deep integration with Klipper’s advanced features

Cons

⊖ Requires Klipper firmware (not compatible with Marlin directly)
⊖ Technical setup (needs Raspberry Pi/Klipper configuration)
⊖ Niche use case (limited to 3D printing)
⊖ Key Features