Desplegar ChirpStack

Requisitos del host

• Sistema de 64 bits actualizado y hora sincronizada.
• Al menos 2 GB de RAM para laboratorio; más margen para varias sedes y retención de datos.
• Docker Engine y el complemento Docker Compose instalados desde su repositorio oficial.
• Puertos definidos: web 8080, MQTT 1883/8883 y los backends elegidos; no exponerlos indiscriminadamente.
• Destino de copias fuera del mismo disco y responsable de restauración.

./scripts/central-preflight.sh
docker --version
docker compose version
sudo systemctl status docker --no-pager

Arrancar el ejemplo oficial

git clone https://github.com/chirpstack/chirpstack-docker.git
cd chirpstack-docker
git log -1 --oneline
docker compose config
docker compose pull
docker compose up -d

docker compose ps
docker compose logs --tail=100 chirpstack
curl -I http://127.0.0.1:8080

Comprobar EU868 de extremo a extremo

• La configuración de región de ChirpStack incluye eu868.
• MQTT Forwarder utiliza topic_prefix=eu868.
• El concentrador está configurado para canales EU868.
• Los perfiles de dispositivos futuros usarán EU868 y parámetros regionales compatibles.

grep -ER "enabled_regions|topic_prefix|eu868" -n configuration/ docker-compose.yml

Pasar de piloto a plataforma común

1. 1
   Crear un entorno de laboratorio

   No migres directamente la sede que ya funciona.

2. 2
   Asegurar el transporte

   Usa VPN o MQTT TLS con credenciales distintas por gateway.

3. 3
   Crear tenants y roles

   Una sede no debe administrar recursos de otra.

4. 4
   Registrar un gateway de prueba

   Comprueba uplink, downlink y recuperación tras pérdida de red.

5. 5
   Ensayar copia y restauración

   La plataforma no se considera lista hasta recuperar PostgreSQL y configuración.

6. 6
   Migrar una sola sede

   Mantén un plan de reversión hacia el piloto local.