1.7 KiB
1.7 KiB
| layout | title | parent | nav_order | has_children | permalink |
|---|---|---|---|---|---|
| default | MainsailOS | Setup Guides | 1 | false | /setup/mainsail-os |
Installing Mainsail with MainsailOS
The recommended way to install Mainsail on a Raspberry Pi is to use MainsailOS, a pre-packaged disk image. If you are building a custom configuration, you may need to skip these instructions and install Mainsail manually.
- Download the latest mainsailOS Release
- Unzip the .img file from your download.
- Use BalenaEtcher to write the .img on to an 8GB, or larger SDcard. THIS WILL DESTROY ALL DATA ON YOUR CARD.
note: It is a good idea to use a premium SDcard from a reputable manufacturer such as Sandisk, Kingston or Samsung. Low end cards will often fail quickly when used in this application
- If you will be using wifi, edit the file
mainsailos-wpa-supplicant.txtwith your Wifi information. If you are having trouble seeing this file on the sdcard, try removing it and re-inserting it into your card reader. - Make sure that your MCU(s) is connected to your pi, If you will be using wired networking, also make sure your ethernet cable is connected.
- Insert the SDcard into your Pi, and power on the Pi.
- Find your pi on the network, and ssh into it, (Using PuTTY on Windows or the terminal on MacOS)
- If your network supports bonjour, the pi should show up as
mainsailos.local - If your network automatically assigns DNS hostnames, it may simply show up as
mainsailos - Failing these two options, you may need to check your router's DHCP server, and find out what IP address as been assigned to the device.
- If your network supports bonjour, the pi should show up as