Guía Definitiva: Convierte tu Raspberry Pi 5 en un Centro Domótico y de Entretenimiento

Si tienes una Raspberry Pi 5 y quieres sacarle el máximo partido, estás en el lugar correcto. En este tutorial paso a paso, aprenderás a montar un cerebro para tu casa inteligente (Home Assistant) y tu propio «Netflix» personal (Jellyfin), todo corriendo en la misma placa de forma fluida.

Requisitos Previos
Antes de empezar, asegúrate de contar con lo siguiente:

Raspberry Pi 5 (recomendable la versión de 4GB u 8GB de RAM).

Fuente de alimentación oficial USB-C de 27W.

Tarjeta MicroSD (mínimo 32GB) o un disco SSD NVMe con su adaptador (muy recomendado para mayor velocidad y durabilidad).

Cable de red Ethernet (para máxima estabilidad).

Un ordenador adicional para configurar la tarjeta SD.

Paso 1: Instalar el Sistema Operativo
Para que nuestra Raspberry Pi destine todos sus recursos a nuestros servidores, instalaremos una versión sin entorno gráfico.

Descarga e instala Raspberry Pi Imager en tu ordenador.

Abre el programa y en «Elegir Dispositivo», selecciona Raspberry Pi 5.

En «Elegir SO», ve a Raspberry Pi OS (Other) y selecciona Raspberry Pi OS Lite (64-bit).

En «Elegir Almacenamiento», selecciona tu tarjeta MicroSD o disco SSD.

Haz clic en «Siguiente» y luego en «Editar Ajustes» (el icono del engranaje).

Configura un nombre de host (ej. miserver), activa el SSH, elige un nombre de usuario y contraseña, y configura tu zona horaria.

Guarda los ajustes y haz clic en «Escribir».

Paso 2: Conexión y Preparación
Una vez que la tarjeta esté lista, insértala en tu Raspberry Pi 5, conecta el cable de red y enciéndela.

Abre la terminal de tu ordenador (Símbolo del sistema en Windows o Terminal en Mac/Linux) y conéctate a tu Raspberry Pi mediante SSH:

Bash
ssh tu_usuario@miserver.local
Actualiza los paquetes del sistema introduciendo estos comandos:

Bash
sudo apt update
sudo apt upgrade -y
Paso 3: Instalar Docker y Docker Compose
Docker es la magia que nos permitirá correr Home Assistant y Jellyfin al mismo tiempo sin que entren en conflicto.

Ejecuta el script oficial de instalación de Docker:

Bash
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
Añade tu usuario al grupo de Docker para no tener que usar sudo todo el tiempo:

Bash
sudo usermod -aG docker $USER
Cierra la sesión SSH (exit) y vuelve a entrar para que los cambios surtan efecto.

Paso 4: Crear el Archivo de Configuración Mágico
Docker Compose nos permite definir todos nuestros servicios en un solo archivo de texto. Vamos a crear una carpeta para nuestro servidor y generar ese archivo.

Bash
mkdir miservidor
cd miservidor
nano docker-compose.yml
Pega el siguiente código en el editor que se acaba de abrir. Este código descargará e iniciará Home Assistant y Jellyfin:

YAML
version: ‘3.8’

services:
homeassistant:
container_name: homeassistant
image: «ghcr.io/home-assistant/home-assistant:stable»
volumes:
– ./ha_config:/config
– /etc/localtime:/etc/localtime:ro
– /run/dbus:/run/dbus:ro
restart: unless-stopped
privileged: true
network_mode: host

jellyfin:
container_name: jellyfin
image: lscr.io/linuxserver/jellyfin:latest
environment:
– PUID=1000
– PGID=1000
– TZ=Europe/Madrid # Cambia esto por tu zona horaria
volumes:
– ./jellyfin_config:/config
– /ruta/a/tus/peliculas:/data/movies # Cambia esto por la ruta de tu disco duro
– /ruta/a/tus/series:/data/tvshows # Cambia esto por la ruta de tu disco duro
ports:
– 8096:8096
restart: unless-stopped
Guarda el archivo pulsando Ctrl + O, presiona Enter, y sal con Ctrl + X.

Paso 5: ¡A Desplegar!
Ahora solo queda dar la orden para que Docker descargue y ponga en marcha todo. Dentro de la carpeta miservidor, ejecuta:

Bash
docker compose up -d
Verás que empieza a descargar las «imágenes» de ambos programas. Dependiendo de tu conexión a internet, esto puede tardar unos minutos.

Paso 6: Acceder a tus Plataformas
¡Felicidades! Ya tienes tu servidor funcionando. Solo necesitas abrir un navegador web en cualquier ordenador o móvil conectado a tu misma red WiFi y acceder a través de la dirección IP de tu Raspberry Pi:

Para Home Assistant: Escribe http://IP_DE_TU_RASPBERRY:8123. Aquí podrás crear tu cuenta inicial y empezar a vincular tus luces, enchufes y sensores inteligentes.

Para Jellyfin: Escribe http://IP_DE_TU_RASPBERRY:8096. Sigue el asistente de configuración para crear tu biblioteca multimedia apuntando a las carpetas donde tengas guardados tus archivos.

¡Disfruta de tu nuevo centro de control y entretenimiento todo en uno!