Install Butter

Install Butter Operating System (OS) on an SD card for Raspberry Pi

You will need:

  • Desktop computer

  • Internet Connection

  • Butter Box

1

Download the Butter OS for Raspberry Pi

Always choose the Latest Version of the file

2

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:

Example adapter (USB-C to Micro SD)

You don't need to connect the box to the computer.

3

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/

4

Choose device > Raspberry Pi Zero 2 W

Once the Raspberry Pi Image starts, you will be prompt with the screens below.

  • Click on Choose Device

Select Choose device
  • Select Raspberry Pi Zero 2 W If you have a different Raspberry Pi device than the standard recommendation for a Butter Box, choose it instead.

Select Raspberry Pi Zero 2 W (or the device you have if it's not the standard box from Butter HQ)
5

Choose Operating System > Use Custom

  • Click on Choose OS back in the main view

  • Select Use custom and upload the custom .img file that you've downloaded from Dropbox

Select Use Custom. You will upload the custom .img file that you downloaded from Dropbox.
6

Choose Storage > Select Micro SD Card

  • Click on Choose Storage back in the main view

  • Select the Micro SD Card

Select the Micro SD Card.

Your screen will look similar to this after all selections:

Final screen after selections.

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.

7

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.

8

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 section for more details.

If you are building an extended box, continue in the next section: Extend Your Box.

Extend Your Box

Last updated