Cómo instalar Zublo en Docker - Gestor de suscripciones autohospedado en Docker

Zublo | Subscription Tracker | Docker

Zublo: Gestor de suscripciones autohospedado en Docker para controlar todos tus pagos recurrentes

Rastrear suscripciones. Recordatorios automáticos. Estadísticas de gastos. Integración IA. PocketBase + React. Self-hosted. Sin terceros. Control total.

¿Qué es Zublo?

Zublo es un gestor de suscripciones minimalista y open source diseñado para gente que quiere ver todos sus pagos recurrentes en un solo lugar sin confiar en apps comerciales. En lugar de tener suscripciones esparcidas (Spotify, Netflix, AWS, GitLab, etc) olvidadas en tarjeta de crédito, Zublo centraliza TODO — cuánto pagas, cuándo se renuevan, tendencias de gasto, y más.

Propuesta clave: Control total de datos. Self-hosted. Integración IA para análisis inteligente. Setup Docker que toma minutos, no fin de semana. Open source. Compact full-stack: React frontend + PocketBase backend (sin dependencias complejas).

Características principales: Dashboard de suscripciones con vista rápida (próximas renovaciones, costo total). Rastreo de pagos recurrentes (diarios, semanales, mensuales, anuales, etc). Recordatorios automáticos antes de renovación. Calendario de pagos. Estadísticas: gastos por mes/año, categorías. Integración IA: análisis de patrones de gasto, chat-powered workflows, soporte múltiples LLM (no vendor lock-in). API REST para integraciones. Multi-usuario. SQLite persistente. React + Vite frontend moderno. PocketBase backend (cero overhead). Docker-first setup. MIT license.

Para gente con muchas suscripciones: Deja de pagar servicios olvidados. Centraliza. Monitorea. Controla gastos. Sin intermediarios.

Características principales

Dashboard de suscripciones

Vista rápida de próximas renovaciones. Costo total mensual/anual. Estado de cada servicio.

Rastreador de pagos

Frecuencia flexible (diaria, semanal, mensual, anual, etc). Historial de pagos.

Recordatorios automáticos

Notificaciones antes de renovación. Email o in-app. Nunca olvides un pago.

Calendario de pagos

Visualiza cuándo se vence cada suscripción. Planifica cash flow.

Estadísticas detalladas

Gastos por mes, año, categoría. Tendencias. Forecast futuro.

Integración IA

Análisis automático de gastos. Chat-powered workflows. Múltiples LLM providers.

Multi-usuario

Familia o equipo. Cada usuario su view. Compartir o privado.

API REST

Integraciones custom. Automatización. Webhooks.

Ultra-compacto

Single binary + PocketBase. Cero dependencias complejas. Fácil mantener.

Open source MIT

Código abierto. Customizable. Sin vendor lock-in.

Requisitos del sistema

• Docker & Docker Compose
• 256 MB - 512 MB RAM (muy ligero)
• 500 MB - 1 GB espacio disco (PocketBase SQLite + datos)
• Puerto 9597 (o custom)
• PB_ENCRYPTION_KEY (para encriptación datos)
• Navegador moderno

Ultra-ligero: Perfect para Raspberry Pi, NAS, VPS barato. Footprint mínimo.

Instalación con Docker Compose

Paso 1: Crear docker-compose.yml

cat > docker-compose.yml << 'EOF' version: '3.8' services: zublo: image: ghcr.io/danielalves96/zublo:latest container_name: zublo restart: unless-stopped ports: - "9597:9597" environment: # Generar: openssl rand -hex 32 - PB_ENCRYPTION_KEY=replace-with-random-hex-key-here volumes: - zublo-data:/pb/pb_data volumes: zublo-data: EOF

Paso 2: Generar encryption key fuerte

openssl rand -hex 32 # Copia resultado y reemplaza en docker-compose.yml

Paso 3: Iniciar Zublo

docker compose up -d # Espera 5-10 segundos docker compose logs -f zublo

Acceder

http://localhost:9597 - Dashboard Zublo

Primer acceso

1. Abre http://localhost:9597
2. El primer usuario registrado se convierte en admin
3. Crea tu cuenta
4. ¡Listo para rastrear suscripciones!

Primeros pasos

1. Agregar primera suscripción

1. Dashboard → Add Subscription
2. Nombre: "Netflix", "Spotify", "AWS", etc
3. Costo: $12.99, €9.99, etc
4. Frecuencia: Monthly, Yearly, Quarterly, etc
5. Próxima renovación: fecha
6. Categoría (opcional): Entertainment, Software, etc
7. Save

2. Ver dashboard

1. Dashboard muestra: costo total/mes, próximas renovaciones
2. Lista de todas tus suscripciones
3. Estado de cada una

3. Configurar recordatorios

1. Settings → Notifications
2. Habilita recordatorios
3. Días antes de renovación (ej: 3 días)
4. Email o in-app

4. Ver estadísticas

1. Dashboard → Statistics
2. Gastos por mes/año
3. Desglose por categoría
4. Tendencias

5. Usar IA para análisis

1. Dashboard → AI Chat
2. Pregunta: "¿Cuáles son mis suscripciones más caras?"
3. IA analiza y sugiere optimizaciones
4. Integración con múltiples LLMs (OpenAI, Claude, etc)

6. Ver calendario

1. Dashboard → Calendar
2. Visualiza cuándo se vence cada suscripción
3. Planifica cash flow mensual

7. Agregar más usuarios

1. Settings → Users
2. Invita familia o compañeros
3. Multi-usuario setup

Casos de uso

• Profesionales con muchos servicios: AWS, GitHub, GitLab, Figma, Slack, Notion, etc. Controla gastos cloud.
• Suscriptores de entretenimiento: Netflix, Spotify, Disney+, etc. Nunca olvides cancelar.
• Familias: Rastrear suscripciones compartidas. Presupuesto familiar.
• Freelancers: Monitorear gastos deducibles. Impuestos.
• Equipos: Gestionar gastos de empresa. Control de suscripciones corporativas.

HTTPS con Caddy (producción)

Caddyfile

subs.tudominio.com { reverse_proxy localhost:9597 }

Acceso remoto seguro

https://subs.tudominio.com con HTTPS automático

Gestión y mantenimiento

Ver logs

docker compose logs -f zublo

Backup de datos

docker cp zublo:/pb/pb_data ./zublo-backup-$(date +%Y%m%d)

Reiniciar

docker compose restart zublo

Actualizar a versión más reciente

docker compose pull docker compose up -d

Monitorear consumo

docker stats zublo

Comparativa con alternativas

vs YNAB / Mint (SaaS)

Zublo gana: Self-hosted, foco en suscripciones, IA local. YNAB gana: Más features, comunidad, integración bancaria.

vs Spreadsheet (Excel)

Zublo gana: UI bonita, recordatorios automáticos, IA. Excel gana: Flexibility total.

vs Commercial trackers

Zublo gana: Gratis, open source, self-hosted, privacy. Commercial gana: Más features, soporte.

Mejor para: Gente con muchas suscripciones que quiere control total, sin SaaS, inteligencia IA, self-hosted. Setup Docker super simple.

---

Referencias oficiales

• GitHub Repository - danielalves96/zublo
• README & Documentation
• Architecture Guide
• GitHub Container Registry

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Sígueme en mis redes sociales

Telegram Discord YouTube GitHub Blog Twitter