89 lines
3.8 KiB
Text
89 lines
3.8 KiB
Text
|
---
|
|||
|
|
description: Install Butter Operating System (OS) on an SD card for Raspberry Pi
|
|||
|
|
sidebar_position: 3
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Install Butter
|
|||
|
|
|
|||
|
|
You will need:
|
|||
|
|
|
|||
|
|
* Desktop computer
|
|||
|
|
* Internet Connection
|
|||
|
|
* Butter Box
|
|||
|
|
|
|||
|
|
### Download the Butter OS for Raspberry Pi
|
|||
|
|
|
|||
|
|
Make sure the file size matches the size listed on the website. Sometimes browsers do not complete the download, which can result in a corrupted file.
|
|||
|
|
|
|||
|
|
[https://www.dropbox.com/scl/fo/helpqh3q2oj7ti2ia038m/h?dl=0.&rlkey=cswt4w4zksiuj3eb1oca48yw0](https://www.dropbox.com/scl/fo/helpqh3q2oj7ti2ia038m/h?dl=0.&rlkey=cswt4w4zksiuj3eb1oca48yw0)
|
|||
|
|
|
|||
|
|
:::info
|
|||
|
|
Always choose the Latest Version of the file.
|
|||
|
|
:::
|
|||
|
|
|
|||
|
|
### Plug the micro SD card into your computer
|
|||
|
|
|
|||
|
|
To plug the micro SD card into your computer, you may need an adapter to do this:
|
|||
|
|
|
|||
|
|
<div align="center"><figure><img src="/img/docs/image (1).png" alt="" width="375"/><figcaption><p>Example adapter (USB-C to Micro SD)</p></figcaption></figure></div>
|
|||
|
|
|
|||
|
|
:::info
|
|||
|
|
You don't need to connect the box to the computer.
|
|||
|
|
:::
|
|||
|
|
|
|||
|
|
### Run Raspberry Pi Imager
|
|||
|
|
|
|||
|
|
Once you have your micro SD card plugged into your computer that has an internet connection, run Raspberry Pi Imager from a desktop computer. It will walk you through the steps to install the Butter operating system on the micro SD card.
|
|||
|
|
|
|||
|
|
If you don't have Raspberry Pi Imager, you can download it here: [https://www.raspberrypi.com/software/](https://www.raspberrypi.com/software/)
|
|||
|
|
|
|||
|
|
### Choose device > **Raspberry Pi Zero 2 W**
|
|||
|
|
|
|||
|
|
Once the Raspberry Pi Image starts, you will be prompt to select your Raspberry Pi device.
|
|||
|
|
|
|||
|
|
<figure><img src="/img/docs/Screenshot 2026-02-24 at 9.56.27 AM.png" alt=""/><figcaption><p>Select Raspberry Pi Zero 2 W (or the device you have if it's not the standard box from Butter HQ)</p></figcaption></figure>
|
|||
|
|
|
|||
|
|
### Choose Operating System > Use Custom
|
|||
|
|
|
|||
|
|
* On the OS tab, select **Use custom** and upload the custom Butter OS .img file. Confirm that you have **unzipped the file** before using it.
|
|||
|
|
|
|||
|
|
<figure><img src="/img/docs/Screenshot 2026-02-24 at 9.57.31 AM.png" alt=""/><figcaption><p>Select Use Custom. You will upload the custom .img file that you downloaded from Dropbox.</p></figcaption></figure>
|
|||
|
|
|
|||
|
|
### Choose Storage > Select Micro SD Card
|
|||
|
|
|
|||
|
|
* From the **Storage** tab, select the **Micro SD Card.**
|
|||
|
|
|
|||
|
|
<figure><img src="/img/docs/Screenshot 2026-02-24 at 1.27.37 PM.png" alt=""/><figcaption><p>Select the Micro SD Card.</p></figcaption></figure>
|
|||
|
|
|
|||
|
|
Your screen will look similar to this after all selections:
|
|||
|
|
|
|||
|
|
<figure><img src="/img/docs/Screenshot 2026-02-24 at 1.27.43 PM.png" alt=""/><figcaption><p>Final screen after selections.</p></figcaption></figure>
|
|||
|
|
|
|||
|
|
You may be prompt with _"Doing this will erase all data from selected external storage"_ and “_do you want to apply settings”_, click then on _“no clear settings”_.
|
|||
|
|
|
|||
|
|
After that select _"write"_ and begin writing process to the Micro SD card.
|
|||
|
|
|
|||
|
|
### Remove From Computer and Insert Micro SD Card into the Raspberry Pi (Butter Box)
|
|||
|
|
|
|||
|
|
Once you're done, remove the Micro SD card. Insert the Micro SD card into the Raspberry Pi (Butter Box) not powered on.
|
|||
|
|
|
|||
|
|
### Go to Quick Start
|
|||
|
|
|
|||
|
|
Plug the Raspberry Pi (Butter Box) into power. Wait a few moments and connect to the Butter Box Portal. Go to the [Quick Start](../../quick-start) section for more details.
|
|||
|
|
|
|||
|
|
**If you are building an extended box, continue in the next section: Extend Your Box.**
|
|||
|
|
|
|||
|
|
[extend-your-box.md](extend-your-box)
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
### Troubleshooting
|
|||
|
|
|
|||
|
|
If you see an error stating that the input file is not a valid disk image, check the file you downloaded.
|
|||
|
|
|
|||
|
|
Make sure the file size matches the size listed on the website. Sometimes browsers do not complete the download, which can result in a corrupted file.
|
|||
|
|
|
|||
|
|
Also confirm that you have **unzipped the file** before using it.
|
|||
|
|
|
|||
|
|
<figure><img src="/img/docs/Screenshot 2026-02-24 at 1.28.37 PM.png" alt=""/><figcaption></figcaption></figure>
|