10-platforms/homelab/platform-40/BACKUP-RESTORE.md

BACKUP-RESTORE

Alcance

Este documento cubre la capa documental y técnica versionada de platform-40 dentro de Gitea.

No cubre por sí solo:

• backup real de volúmenes Docker
• dumps de PostgreSQL
• backup de MinIO
• backup de Grafana
• backup de Portainer
• backup de Mosquitto
• restore completo extremo a extremo ya probado

Qué debe quedar versionado aquí

• documentación de servicios
• rutas clave
• puertos y criterios de acceso
• advertencias críticas
• comandos de operación
• referencias a docker-compose.yml saneados

Qué no debe guardarse aquí

• credenciales
• secretos
• .env reales
• dumps de base de datos
• backups binarios
• exports sin sanear

Advertencia crítica principal

Nunca usar en /srv/platform:

docker-compose down -v

porque elimina volúmenes persistentes de:

• Grafana
• MinIO
• Portainer
• Mosquitto

Procedimiento mínimo de backup lógico

1. verificar que la documentación de plataforma está actualizada
2. verificar que los docker-compose.yml saneados están versionados cuando proceda
3. verificar que las rutas clave siguen siendo correctas
4. no asumir que un servicio está sano solo porque el puerto escucha

Procedimiento mínimo de restore lógico

1. revisar docs/arquitectura.md

2. revisar docs/servicios.md

3. revisar docs/rutas-clave.md

4. validar los stacks:

   • /srv/platform
   • /srv/chirpstack
   • /srv/verticals

5. restaurar con extremo cuidado los servicios persistentes

6. nunca destruir volúmenes sin backup previo

Validación mínima

• README.md presente
• docs/arquitectura.md presente
• docs/servicios.md presente
• docs/rutas-clave.md presente
• ops/operacion-diaria.md presente