Link Search Menu Expand Document

This method is cross-platform and works with Windows, Linux and MacOS

We strongly recommend you use a premium SD card from a reputable manufacturer such as Sandisk, Kingston or Samsung, using an “A1” (or better) grade SD card.

Low end cards will often fail quickly when used in this application.

FLASHING WILL DESTROY ALL DATA ON YOUR SD CARD AND CANNOT BE REVERSED


Preparation

  • Download the latest MainsailOS release (don’t unpack the zip; you don’t need to).
  • Download and install the latest Raspberry Pi Imager (aka. rpi-imager).

Flashing MainsailOS

Raspberry Pi Imager appearance may vary depending on the host OS.

  • When opening rpi-imager you will be presented with the following:

screenshot-imager-launched

  • Select “CHOOSE OS”, and a popup will open as illustrated below. Select “Use custom” and navigate to the MainsailOS zip you downloaded.

screenshot-imager-popup screenshot-imager-os-selected

  • Click on “STORAGE” and select your desired SD card.

screenshot-imager-sd-card-selection

  • Hostname, wi-fi, language and numerous other settings can now be scrolled through and pre-configured in a hidden setup menu, opened by pressing:
CTRL+SHIFT+X

As a bare minimumm setup SSH and a network connection (unless wired) at this point, especially if performing a ‘headless’ installation.

screenshot-imager-rpi-preconfig1

screenshot-imager-rpi-preconfig2

  • With all desired options preconfigured, click on “WRITE” and accept the warning.

screenshot-imager-warning

  • Imager will take some time to write the disc image to the SD card. When it’s finished, click continue.

screenshot-imager-write-finished

Select the “CONTINUE” button and unmount (safely remove) your newly flashed MainsailOS SD card.

You are now ready to move on to the first boot of MainsailOS.


< tool selection next step >