Nivel inicial8 min de lectura · Publicado el

Botón de encendido y apagado para Raspberry Pi 2, 3, 4 y 5

Botón de encendido para Raspberry Pi: desenchufarla mientras escribe la microSD la corrompe; un pulsador en los pines 5 y 6 la apaga en orden. Apagar no es desenchufarrubentejera.com DESENCHUFARcorrompe la SDpines 5 y 6BOTÓNapaga en orden
Desenchufar la Pi con el piloto encendido es sacar la tarjeta a medio escribir: puede corromper la microSD. El botón entre el pin 5 (GPIO3) y el pin 6 (GND) la apaga en orden y, si está apagada, la enciende.

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:

Esquema del conector GPIO de la Raspberry Pi con los 12 primeros pines: el pulsador une el pin 5 (GPIO3), en la fila de abajo, con el pin 6 (GND), justo encima. El pin 1 es el cuadrado de la esquina inferior izquierda
El pulsador va entre el pin 5 (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.

  1. Abre un terminal en la Raspberry.
  2. Añade la línea al final de config.txt.
  3. 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

Fuentes

Comprobado en noviembre de 2026:

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.