Link Search Menu Expand Document

This method is cross-platform and works with Windows, Linux and MacOS
Raspberry Pi Imager appearance may vary depending on the host OS.

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 and install the latest Raspberry Pi Imager (v1.7.1).

Flashing MainsailOS

  • When opening Raspberry Pi Imager you will be presented with the following:

screenshot-imager-launched

  • Select “CHOOSE OS”, and a pop-up will open as illustrated below.
  • Scroll down to “Other specific-purpose OS”

screenshot-imager-choose-specific

  • Select “3D printing”

screenshot-imager-3d-printing

  • Choose your prefered 3D printing OS (Mainsail for sure)

screenshot-imager-os-mainsail screenshot-imager-os-mainsail-choosen

  • After that is done click “STORAGE” and select your desired SD card.

screenshot-imager-choose-storage

  • For example:

screenshot-imager-choose-storage2

  • Hostname, Wi-Fi, language and numerous other settings can now be scrolled through and preconfigured in a setup menu, opened by clicking on the little cogwheel in the right corner.

Please enable SSH! Otherwise, you were’nt able to connect via SSH.

screenshot-imager-cogwheel

  • Optional: Setup your preferred hostname

If you change the hostname, the URL will be changed accordingly.
As shown in the screenshot below your URL will be http://mainsail.local

screenshot-imager-setup-ssh

  • Change your password, this step is highly recommended!

Please don’t change the username!
At this stage MainsailOS Setup relies on the user “pi”.
We will change that in the future.

screenshot-imager-setup-username

  • If you want to use WiFi instead a wired connection,
    please configure your WiFi accordingly.

screenshot-imager-setup-wifi

  • The last step manages your Timezone and Keyboard Layout
    (Keyboard Layout may affect your language in some cases)

screenshot-imager-setup-timezone

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

screenshot-imager-write

screenshot-imager-warning

  • Imager will take some time to write the image to the SD card.
    When it finished the transfer to your SD Card, it will verify your Image.

screenshot-imager-writing

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

screenshot-imager-write-finished

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


< tool selection next step >