Botón de encendido y apagado para Raspberry Pi 2, 3, 4 y 5
La Raspberry Pi no tiene interruptor (salvo la Pi 5). Para apagarla, mucha gente la desenchufa. Es como sacar la tarjeta de memoria de la cámara mientras guarda una foto: casi siempre sale bien, hasta el día en que la foto, o la tarjeta, se estropea. Desenchufarla sin apagar el sistema puede corromper la tarjeta SD.
Un botón soluciona las dos cosas: apaga el sistema de forma ordenada y vuelve a encenderla sin tocar el cable.
La versión de 2018 de este artículo usaba un script en Python. Hoy basta con una línea de configuración, porque Raspberry Pi OS ya trae lo necesario.
Qué método usar según tu modelo
| Modelo | Qué usar |
|---|---|
| Raspberry Pi 2, 3, 4, Zero y Zero 2 | Pulsador en los pines 5 y 6 + dtoverlay=gpio-shutdown |
| Raspberry Pi 1 Model B revisión 1 | Lo mismo, pero con dtoverlay=gpio-shutdown,gpio_pin=1 |
| Raspberry Pi 5 y Raspberry Pi 500 | Su botón de encendido. Para uno externo, el conector J2 de la Pi 5 |
| Cualquiera, si quieres reiniciar con una pulsación corta | El script con gpiozero |
Cómo conectar el botón
Necesitas un pulsador normal (de los que solo cierran el circuito mientras los aprietas) y dos cables. Un cable va al pin 5, que es el GPIO3, y el otro al pin 6, que es GND (tierra).
En las placas clásicas y en las Zero, con la placa colocada de forma que el conector quede arriba, el pin 1 está en la esquina inferior izquierda; los impares van en la fila de abajo y los pares en la de arriba. Los pines 5 y 6 están uno encima del otro, en la tercera columna:
GPIO3), en ámbar, y el pin 6 (GND), justo encima. Así se ve en las placas clásicas y en las Zero. En los ordenadores de teclado (Raspberry Pi 400 y 500), el conector está girado 180° y los pines 1 y 40 vienen rotulados: la numeración es la misma, solo cambia hacia dónde mira.No necesitas resistencias: el GPIO3 ya lleva una resistencia pull-up en la placa. Es decir, el pin está siempre «arriba» (a 3,3 V) y, al apretar el botón, lo unes a tierra y baja. La Raspberry detecta ese cambio.
Activar el botón con gpio-shutdown
Raspberry Pi OS incluye un overlay llamado gpio-shutdown. Un overlay es un ajuste que se carga al arrancar y le explica al sistema qué hay conectado a los pines. Este en concreto convierte el pin en una tecla de apagado, como la de un portátil.
- Abre un terminal en la Raspberry.
- Añade la línea al final de
config.txt. - Reinicia.
printf '[all]\ndtoverlay=gpio-shutdown\n' | sudo tee -a /boot/firmware/config.txt
sudo reboot
El [all] no es decorativo: config.txt puede terminar en una sección que solo se aplica a ciertos modelos (por ejemplo, [cm5]). [all] hace que la línea siguiente valga para todos. Si prefieres editarlo a mano, sudo nano /boot/firmware/config.txt, añade las dos líneas al final y guarda con Ctrl + O y sal con Ctrl + X.
En sistemas antiguos, anteriores a Raspberry Pi OS Bookworm, el fichero está en /boot/config.txt.
Qué hace el botón
- Con la Raspberry encendida, una pulsación apaga el sistema de forma ordenada.
- Con la Raspberry apagada (pero enchufada), una pulsación la vuelve a arrancar.
Lo primero lo hace el overlay. Lo segundo es cosa del propio firmware de la Raspberry: cuando está parada, despierta si el GPIO3 se une a tierra. Por eso se usa justo ese pin.
Apagar no es desenchufar.
Si usas I2C
El GPIO3 es también la línea de reloj (SCL) del bus I2C, el que usan muchas pantallas y sensores. Si tienes algo conectado por I2C, puedes mover el botón a otro pin, por ejemplo el GPIO17 (pin 11):
[all]
dtoverlay=gpio-shutdown,gpio_pin=17
El precio: en otro pin el botón solo apaga. Encender desde el botón solo funciona con el GPIO3.
Raspberry Pi 5: ya trae botón
La Raspberry Pi 5 tiene un botón de encendido en la propia placa. No necesitas configurar nada:
| Situación | Qué hace |
|---|---|
| Raspberry Pi OS con escritorio, una pulsación | Abre un menú para apagar, reiniciar o cerrar sesión |
| Raspberry Pi OS con escritorio, dos pulsaciones seguidas | Apaga |
| Raspberry Pi OS Lite (sin escritorio), una pulsación | Apaga |
| Apagada pero enchufada, una pulsación | Arranca |
| Mantener pulsado | Apagado forzado (como quitar el cable; úsalo solo si se ha colgado) |
¿La tienes dentro de una caja y quieres el botón fuera? La placa tiene dos contactos marcados como J2, entre el conector de la batería del reloj y el borde. Si sueldas ahí un pulsador normalmente abierto, hace lo mismo que el botón de la placa.
En la Pi 5 no hace falta despertar con el GPIO3: su botón propio enciende la placa siempre.
Reiniciar con una pulsación corta
El script del artículo original (pi-shutdown, de gilyes) hacía dos cosas: pulsación corta, reiniciar; pulsación larga (3 segundos), apagar. El overlay solo apaga. Si quieres también reiniciar, necesitas un pequeño script.
Aquel script usa la librería RPi.GPIO. Hoy la documentación oficial de Raspberry Pi enseña a manejar los pines con gpiozero, que viene instalada en Raspberry Pi OS y es más sencilla. Esta es una versión actualizada que hace lo mismo.
Guarda esto en /usr/local/bin/boton-apagado.py:
#!/usr/bin/env python3
# Botón entre GPIO3 (pin 5) y GND (pin 6).
# Pulsación corta: reinicia. Mantenido 3 segundos: apaga.
from signal import pause
from subprocess import run
from gpiozero import Button
boton = Button(3, hold_time=3) # GPIO3 ya trae resistencia pull-up
mantenido = False
def al_mantener():
global mantenido
mantenido = True
run(["systemctl", "poweroff"])
def al_soltar():
global mantenido
if not mantenido:
run(["systemctl", "reboot"])
mantenido = False
boton.when_held = al_mantener
boton.when_released = al_soltar
pause()
Pruébalo a mano con sudo python3 /usr/local/bin/boton-apagado.py y aprieta el botón.
Que arranque solo
En el artículo original lo lanzaba con cron y @reboot. Funciona, pero si el script falla nadie lo vuelve a arrancar. Un servicio de systemd (el programa que arranca todo lo demás en Raspberry Pi OS) lo hace mejor: lo inicia en cada arranque y lo reinicia si se cae.
Crea /etc/systemd/system/boton-apagado.service:
[Unit]
Description=Botón de apagado y reinicio
[Service]
ExecStart=/usr/bin/python3 /usr/local/bin/boton-apagado.py
Restart=on-failure
[Install]
WantedBy=multi-user.target
Y actívalo:
sudo systemctl enable --now boton-apagado.service
Con systemctl status boton-apagado ves si está en marcha.
Apagar o reiniciar la Raspberry Pi desde el terminal (sin botón)
Si solo quieres apagarla bien y no te importa usar el teclado o SSH:
sudo poweroff
Cuando el sistema se haya detenido, ya puedes desenchufarla. Para reiniciarla en lugar de apagarla, el comando es sudo reboot.
Más proyectos con la Raspberry Pi
- Si tu Raspberry no arranca con un disco duro conectado: Alimentación para discos de 2.5’’ en la Raspberry Pi.
- Más electrónica: Esp8266 con tira led WS2812B.
Fuentes
Comprobado en noviembre de 2026:
- README de overlays del firmware de Raspberry Pi (versión del 21 de octubre de 2026):
gpio-shutdown, sus parámetros (gpio_pin,gpio_pull,debounce), botón entre los pines 5 y 6 y encendido con GPIO3; GPIO1 en la Pi 1 Model B rev 1. De aquí sale también la ruta antigua/boot/config.txt. - Documentación oficial de Raspberry Pi (fuente en GitHub, versión del 5 de noviembre de 2026): config.txt (ubicación en
/boot/firmware/y filtro[all]), conector GPIO (pin 5 = GPIO3 con pull-up de 1,8 kΩ, pin 6 = GND), botón de encendido de la Pi 5 y J2, configuración del bootloader (WAKE_ON_GPIO) y GPIO desde Python con gpiozero. - Script original: gilyes/pi-shutdown y su artículo.
Ejecutado: el script de gpiozero se ha probado con gpiozero 2.0.1 y Python 3.13 usando la simulación de pines de la librería (pulsación corta, larga y corta: reinicio, apagado y reinicio). El servicio se ha validado con systemd-analyze verify (systemd 259) y la línea de config.txt con tee sobre un fichero de prueba. No se ha probado en una Raspberry Pi física.