DX Monitor — Instalación en Raspberry Pi

Esta guía explica cómo instalar DX Monitor en una Raspberry Pi usando Docker. No es necesario copiar código fuente — la imagen está publicada en Docker Hub y el sistema quedará funcionando con unos pocos comandos.

Requisitos previos

Raspberry Pi 3B+, 4 o 5 con Raspberry Pi OS (32 o 64 bits) o Ubuntu Server para Pi
Conexión a internet
Terminal abierto — desde el escritorio: Menú → Accesorios → Terminal, o conectado por SSH desde otro ordenador

⚠ Para uso 24/7 se recomienda Raspberry Pi OS Lite (sin escritorio) — consume menos memoria y CPU. La instalación es idéntica.

1 Actualizar el sistema

Abre el terminal y ejecuta:

sudo apt update && sudo apt upgrade -y

2 Instalar Docker

Raspberry Pi OS no incluye Docker por defecto. Usa el script oficial:

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

Añade tu usuario al grupo docker para no necesitar sudo en cada comando:

sudo usermod -aG docker $USER

Cierra el terminal y vuelve a abrirlo para que el cambio surta efecto. Verifica la instalación:

docker --version

3 Verificar Docker Compose

docker compose version

Si el comando no existe:

sudo apt install docker-compose-plugin -y

4 Obtener el docker-compose.yml

Abre el navegador y ve al repositorio de Docker Hub:

🐳 hub.docker.com/r/ea3tb/dx-monitor

En la descripción encontrarás el bloque docker-compose.yml. Cópialo.

Vuelve al terminal, crea la carpeta del proyecto y abre el editor:

mkdir -p ~/dx-monitor
cd ~/dx-monitor
nano docker-compose.yml

Pega el contenido con Ctrl+Shift+V, guarda con Ctrl+O → Enter, y cierra con Ctrl+X.

5 Arrancar el contenedor

Docker descargará automáticamente la imagen desde Docker Hub y arrancará el contenedor. La primera vez puede tardar unos minutos:

docker compose up -d

Verifica que está corriendo:

docker compose ps

6 Acceder al dashboard

Desde cualquier navegador en tu red local:

http://<IP_DE_LA_PI>:8765

Para saber la IP de tu Raspberry Pi:

hostname -I

Al entrar por primera vez todos los campos estarán vacíos. Rellena la configuración desde el dashboard: indicativo, locator, directorio XML, cluster y Telegram.

Comandos habituales

# Ver logs en tiempo real
docker logs -f dx_monitor_docker

# Parar el contenedor
docker compose down

# Arrancar el contenedor
docker compose up -d

# Actualizar a la última versión
docker compose pull && docker compose up -d

Opcional — Portainer (gestión visual)

Portainer es una interfaz web para gestionar Docker desde el navegador: ver logs, reiniciar contenedores, monitorizar CPU y memoria, sin necesidad de usar el terminal.

docker volume create portainer_data

docker run -d \
  -p 9000:9000 \
  --name portainer \
  --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data \
  portainer/portainer-ce:latest

Abre el navegador y ve a:

http://<IP_DE_LA_PI>:9000

Crea un usuario administrador en la primera visita. Desde ahí puedes gestionar todos tus contenedores Docker incluyendo DX Monitor.