---
description: 'Instala el sistema operativo Mantequilla (SO) en una tarjeta SD para Raspberry Pi'
sidebar_position: 3
---

# Instalar la Caja Mantequilla

Necesitas:

* Una computadora
* Conexion de Internet
* Una Caja Mantequilla

### Descarga el Sistema Operativo Mantequilla  para Raspberry Pi. 

Asegúrate de que el tamaño del archivo coincida con el que aparece en el
sitio web. En ocasiones, los navegadores no completan la descarga, lo que
puede provocar que el archivo se corrompa.

[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
Elije siempre la última versión del archivo. 
:::

### Inserta la tarjeta micro SD en tu ordenador

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.

Asegúrate de que el tamaño del archivo coincida con el que aparece en el
sitio web. En ocasiones, los navegadores no completan la descarga, lo que
puede provocar que el archivo se corrompa.

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>