Cómo instalar BudgetBoard en Docker - Aplicación de finanzas personales autohospedada en Docke

BudgetBoard | Personal Finance | Docker

BudgetBoard: Aplicación de finanzas personales open source autohospedada en Docker

Reemplaza Mint con una alternativa privada. Presupuestos, seguimiento de gastos, importación CSV, sincronización bancaria, metas financieras. Control total de tus datos.

¿Qué es BudgetBoard?

BudgetBoard es una aplicación de finanzas personales open source autohospedada diseñada como alternativa a Mint (que cerró en 2024). Te permite rastrear gastos mensuales, establecer presupuestos, gestionar múltiples cuentas bancarias y trabajar hacia metas financieras. Todo bajo tu control, en tu servidor, sin depender de terceros.

Características completas: Gestión de cuentas (corriente, ahorro, tarjetas crédito), registro de transacciones, presupuestos por categoría, importación CSV masiva, sincronización bancaria automática con SimpleFIN/LunchFlow, auto-categorización con IA, metas financieras, análisis de tendencias, autenticación 2FA, múltiples idiomas, soporte OIDC.

Privacidad garantizada: Tu información financiera nunca se envía a servidores remotos. Tus datos permanecen en tu servidor local. Reemplazo directo y más seguro que Mint.

Características principales

Gestión de cuentas

Corriente, ahorro, tarjetas de crédito, activos (propiedades, valuables).

Registro de transacciones

Registra y categoriza transacciones manualmente o automáticamente.

Presupuestos mensuales

Establece presupuestos por categoría y rastrear gasto vs presupuesto.

Importación CSV

Importa transacciones en lote desde archivos CSV de tus bancos.

Sincronización bancaria

Conecta con SimpleFIN o Lunchflow para sincronización automática.

Auto-categorización IA

Entrena modelo ML para predecir categorías automáticamente.

Metas financieras

Establece metas (comprar casa, vacaciones) y rastrear progreso.

Reglas automáticas

Crea reglas para actualizar automáticamente transacciones.

Gráficos de tendencias

Visualiza tendencias de gastos personalizables por fecha, cuenta, categoría.

Autenticación 2FA

Auenticación local con 2FA, o usa OIDC con tu proveedor.

Multi-idioma

Inglés, alemán, francés, chino simplificado, con contribuciones comunitarias.

Open Source

Código abierto, auditable, personalizable, 100% gratuito.

Requisitos del sistema

• Docker y Docker Compose instalados
• PostgreSQL 18+ (en contenedor)
• 1-2 GB de RAM mínimo
• 5+ GB de espacio en disco para base de datos
• Puerto 6253 disponible (o configurable)

Importante: BudgetBoard usa PostgreSQL, no SQLite. Requiere dos contenedores: servidor backend + cliente frontend.

Instalación con Docker Compose

Docker Compose (recomendado)

version: '3.8' services: budget-board-server: image: ghcr.io/teelur/budget-board/server:v3 container_name: budget-board-server restart: on-failure:5 environment: - LOG_LEVEL=Information - CLIENT_ADDRESS=budget-board-client - POSTGRES_HOST=budgetboard-db - POSTGRES_DATABASE=budgetboard - POSTGRES_USER=budgetboarduser - POSTGRES_PASSWORD=contraseña-segura-aqui - DISABLE_NEW_USERS=false - AUTO_UPDATE_DB=true - TZ=Europe/Madrid depends_on: - budgetboard-db budget-board-client: image: ghcr.io/teelur/budget-board/client:v3 container_name: budget-board-client restart: on-failure:5 ports: - "6253:6253" environment: - VITE_SERVER_ADDRESS=budget-board-server - PORT=6253 depends_on: - budget-board-server budgetboard-db: image: postgres:18 container_name: budgetboard-db restart: on-failure:5 environment: - POSTGRES_DB=budgetboard - POSTGRES_USER=budgetboarduser - POSTGRES_PASSWORD=contraseña-segura-aqui volumes: - budgetboard-db:/var/lib/postgresql/data healthcheck: test: ["CMD", "pg_isready", "-U", "budgetboarduser"] interval: 10s retries: 5 volumes: budgetboard-db:

Iniciar

docker compose up -d

Acceder

Abre http://localhost:6253 en tu navegador. Se mostrará la pantalla de login. Crea tu primera cuenta.

Primeros pasos

1. Crear primer usuario

1. Abre http://localhost:6253
2. Click en "Sign up" para crear cuenta
3. Completa email, contraseña, nombre
4. Configura zona horaria y idioma (español si está disponible)

2. Crear cuentas bancarias

1. En el dashboard: "Accounts & Assets" → "Add Account"
2. Nombre: "Mi Corriente"
3. Tipo: "Checking Account"
4. Moneda: EUR (o tu moneda)
5. Saldo inicial: ingresa tu saldo actual
6. Save

3. Importar transacciones (CSV)

1. Exporta CSV desde tu banco (historial de transacciones)
2. En BudgetBoard: "Import" → "Upload CSV"
3. Selecciona cuenta destino
4. Carga el archivo CSV
5. BudgetBoard importa automáticamente todas las transacciones

4. Crear presupuesto mensual

1. Ve a "Budgets" → "Create Budget"
2. Selecciona categoría (Comida, Transporte, Entretenimiento, etc)
3. Establece cantidad: $500 (ejemplo)
4. Save
5. BudgetBoard rastreará automáticamente vs presupuesto

5. Establecer meta financiera

1. Ve a "Goals" → "Create Goal"
2. Nombre: "Comprar coche"
3. Cantidad objetivo: $25,000
4. BudgetBoard calcula automáticamente cuánto ahorrar al mes
5. Visualiza progreso en gráfico

Sincronización automática de cuentas

Con SimpleFIN o LunchFlow

1. Crea cuenta en SimpleFIN (simplefin.org) o LunchFlow
2. Conecta tu banco (cuenta bancaria real)
3. Obtén el "Connection Token"
4. En BudgetBoard: "Accounts" → "Link Bank Account"
5. Pega el token
6. Las transacciones se sincronizarán automáticamente diariamente

Privacidad: BudgetBoard nunca ve tus credenciales bancarias directas. SimpleFIN actúa como intermediario seguro.

Configuración avanzada

Auto-categorización con IA

1. Categoriza manualmente 50+ transacciones
2. Ve a "Settings" → "AI Categorization"
3. Click "Train Model"
4. Espera a que BudgetBoard entrene
5. Las nuevas transacciones se categoricen automáticamente

Reglas automáticas

Crea reglas para actualizar transacciones automáticamente:

• Si descripción contiene "AMAZON" → categoría "Shopping"
• Si monto > $100 → revisar luego
• Si fecha es viernes → etiqueta "Fin de semana"

OIDC personalizado

OIDC_ISSUER=https://tu-proveedor-oidc.com OIDC_CLIENT_ID=tu-client-id OIDC_CLIENT_SECRET=tu-secret

HTTPS con Caddy (acceso remoto)

Configuración Caddyfile

budgetboard.tudominio.com { reverse_proxy localhost:6253 }

Habilitar WebSocket

BudgetBoard requiere WebSocket para sincronización en tiempo real. Con Caddy se configura automáticamente.

Acceso remoto seguro

1. Configura Caddy con tu dominio
2. HTTPS automático con Let's Encrypt
3. Accede: https://budgetboard.tudominio.com
4. Login y gestiona finanzas desde cualquier lugar

Casos de uso

• Reemplazo de Mint: Migra desde Mint ahora que cerró en 2024
• Privacidad financiera: No quieres que Google/Amazon vean tus gastos
• Control presupuestario: Entiende exactamente dónde va tu dinero
• Metas de ahorro: Visualiza progreso hacia objetivos (casa, coche, viajes)
• Múltiples cuentas: Gestiona corriente, ahorro, tarjetas en un lugar
• Análisis tributario: Exporta datos para declaración de impuestos
• Educación financiera: Enseña a la familia cómo rastrear gastos

Gestión y mantenimiento

Ver logs

docker compose logs -f budget-board-server

Backup de base de datos

docker exec budgetboard-db pg_dump -U budgetboarduser budgetboard > budget-backup-$(date +%Y%m%d).sql

Restaurar desde backup

docker exec -i budgetboard-db psql -U budgetboarduser budgetboard < budget-backup-20250101.sql

Actualizar a la última versión

docker compose pull docker compose up -d

Reiniciar servicios

docker compose restart

Ver estado de salud

docker compose ps

---

Referencias oficiales

• BudgetBoard Official Website
• GitHub Repository
• Wiki - Guía completa
• Deploy Instructions
• Releases - Historial

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