Legacy — Docker Compose / Portainer¶
Estado actual (pre-migración): los servicios que hoy corren con Docker Compose gestionados desde Portainer. Una página por servicio en esta sección.
Toda la información de la migración vive aquí a propósito: el roadmap, el runbook y este índice. Al terminar la migración se borra la sección
legacy/completa (solo quedará retirar los pocos enlaces cruzados que apuntan aquí).
Qué es¶
Antes de migrar a k3s, los servicios corren como stacks de Portainer que
referencian el repositorio Git gorkarevilla/portainer-compose. Cada carpeta
con un docker-compose.yml es un stack independiente.
Hosts¶
| Host | IP | Rol |
|---|---|---|
lebron |
192.168.1.2 |
Portainer + casi todo el stack (26 servicios) |
steph |
192.168.1.4 |
~~web gorkarevilla.com y mirenygorka~~ → Vercel, parada (sep 2026) |
- Los agentes (Telegraf y Alloy) corren en
lebron(~~y ensteph~~, ya parada). - Las cámaras RTSP viven en la VLAN
192.168.50.x. El nuevo cluster k3s usará la red192.168.20.x.
Stacks de Portainer¶
| Stack | Servicios | Host |
|---|---|---|
common |
Telegraf, Alloy | lebron (+ ~~steph~~, parada) |
homeassistant |
Home Assistant, MariaDB, ESPHome, Mosquitto, Zigbee2MQTT | lebron |
ai |
Open WebUI, n8n (Redis, Postgres, worker, runner) | lebron |
books |
Audiobookshelf, Kavita | lebron |
backup |
Duplicati | lebron |
monitoring |
InfluxDB, Grafana, Loki, Uptime Kuma, Prometheus, Frigate | lebron |
network |
Nginx Proxy Manager, Pi-hole, Cloudflared, Netboot.xyz | lebron |
utils |
~~Heimdall~~ (retirado → Homepage), Shlink, Grocy | lebron |
~~gorkarevilla-com~~ |
gorkarevilla.com (nginx) | ~~steph~~ → Vercel |
~~mirenygorka~~ |
mirenygorka (prod + dev) | ~~steph~~ → Vercel (prod); dev retirado |
Despliegue¶
- Portainer importa cada stack desde Git (la carpeta = nombre del stack).
- Los secretos y variables de entorno se gestionan en la UI de Portainer (no se commitean). Por eso aquí no se documentan credenciales.
- Renovate autoactualiza las imágenes (minor/patch).
Mapa de migración¶
| Servicio | Fase | Destino en k3s |
|---|---|---|
| Telegraf | Fase 1 | kube-prometheus-stack + Alloy |
| Alloy | Fase 1 | Alloy en el cluster |
| Portainer | Fase 1 | Argo CD |
| Nginx Proxy Manager | Fase 1 | Traefik + Gateway API |
| Pi-hole | Fase 1 | MetalLB |
| ~~Heimdall~~ | Fase 1 | ~~deployment + PVC~~ → Homepage (retirado 2026-09-27) |
| Duplicati | Fase 1 | Longhorn + S3 |
| Grocy | Fase 2 | deployment + PVC |
| Uptime Kuma | Fase 1/2 | deployment + PVC |
| Open WebUI | Fase 3 | deployment + PVC |
| n8n | Fase 3 | Postgres CloudNativePG + workers |
| InfluxDB | Fase 3 | InfluxDB en el cluster |
| Grafana | Fase 3 | kube-prometheus-stack + dashboards |
| Loki | Fase 3 | Loki con almacenamiento persistente |
| Prometheus | Fase 3 | kube-prometheus-stack |
| Shlink | Fase 3 | CloudNativePG |
| MariaDB | Fase 3/4 | CloudNativePG |
| Home Assistant | Fase 4 | hardware + estado |
| Zigbee2MQTT | Fase 4 | USB → kawhi |
| Frigate | Fase 4 | iGPU → kyrie |
| ESPHome | Fase 4 | ligado a HA |
| Mosquitto | Fase 4 | broker MQTT en el cluster |
| Cloudflared | Fase 1 | Terraform (Cloudflare IaC) + cliente en el cluster |
| Audiobookshelf | Fase 2 | PVC media/config |
| Kavita | Fase 2 | PVC media/config |
| Netboot.xyz | Fase 2 | MetalLB (TFTP) |
| ~~gorkarevilla.com~~ | ✅ Migrado | Vercel (sep 2026) |
| ~~mirenygorka~~ | ✅ Migrado | Vercel (prod, sep 2026); dev retirado |
Servicios ya migrados: Heimdall (Fase 1, 2026-09-07; retirado 2026-09-27 → Homepage), gorkarevilla.com y mirenygorka → Vercel (sep 2026), lo que deja
stephapagada.Las fases y el plan completo están en el roadmap de migración; el procedimiento paso a paso para migrar un servicio está en migrar-servicio.md.