---
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

Para conectar la tarjeta micro SD a tu computadora, es posible que necesites
un adaptador:

<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
No es necesario conectar la caja al ordenador.
:::

### Ejecutar Raspberry Pi Imager 

Una vez que hayas conectado tu tarjeta micro SD a tu ordenador con conexión
a internet, ejecuta Raspberry Pi Imager desde un ordenador de sobremesa. El
programa te guiará a través de los pasos necesarios para instalar el sistema
operativo Mantequilla en la tarjeta micro SD.

Si no tienes Raspberry Pi Imager, puedes descargarlo aquí:
[https://www.raspberrypi.com/software/](https://www.raspberrypi.com/software/)

### Selecciona el dispositivo que tienes> Raspberry Pi Zero 2 W o Raspberry Pi 4

Una vez que se inicie la imagen de Raspberry Pi, se le pedirá que seleccione
su dispositivo Raspberry Pi.

<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>

### Seleccione Sistema operativo > Usar personalizado

* En la pestaña SO, selecciona **Usar personalizado** y carga el archivo
  .img personalizado de Mantequilla OS. Confirma que has **descomprimido el
  archivo** antes de usarlo.

<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>

### Selecciona Almacenamiento > Seleccione Tarjeta Micro SD

* En la pestaña **Almacenamiento**, seleccione la **Tarjeta Micro SD.**

<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>

Tu pantalla se verá similar a esta después de realizar todas las
selecciones:

<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>

Es posible que aparezca el mensaje "Al hacer esto se borrarán todos los
datos del almacenamiento externo seleccionado" y "¿Deseas aplicar la
configuración?", haz clic en "No borrar la configuración".

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>
