Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Setup Guides

Local installation

You will need to choose which way you want to install Mainsail on a Raspberry Pi:

  • MainsailOS recommended
    A prebuilt image for your Raspberry Pi. Preconfigured and requires the least amount of setup.
  • KIAUH - Klipper Installation And Update Helper
    A script toolbox to install and update Klipper, Moonraker and Mainsail. KIAUH contains additional features and is recommended for multi-printer setups.
  • Manual Setup
    The rocky road for the daring. For those who want to know how everything is set up manually.


You an also setup remote access without installing or configuring a web server.

You can test and review a hosted version of Mainsail at Please read the documentation for usage and configuration.