Cómo instalar EZBookKeeping en Docker - Personal Finance autohospedado

EZBookKeeping | Personal Finance | Lightweight | Self-hosted | Go + React | Multiple databases | Multi-platform | MIT open source | Live demo | 3.5k+ stars

EZBookKeeping en Docker: Personal finance app autohospedado Go + React con transacciones, import CSV/OFX/QIF, gráficas, PWA mobile, SQLite/MySQL/PostgreSQL, Raspberry Pi compatible, 3.5k+ stars, MIT open source, production-ready 💰📊

EZBookKeeping es una aplicación de finanzas personales completamente autohospedada, lightweight y fácil de usar construida con Go y React. Registro transacciones diarias, importa datos múltiples formatos (CSV, OFX, QFX, QIF, IIF), búsqueda y filtrado avanzado, gráficas integradas, soporte PWA (Progressive Web App), interfaces adaptadas mobile/desktop, multi-database (SQLite, MySQL, PostgreSQL), funciona en Raspberry Pi/NAS/MicroServers, arquitectura multi-plataforma (x86, amd64, ARM), presupuestos y categorías custom, export datos, sin publicidades, completamente privado.

Vídeo tutorial en YouTube

Mira el vídeo completo sobre cómo instalar y usar EZBookKeeping en Docker en el canal GENBYTE:

🐳 </> GENBYTE Homelab • Docker • Self-Hosting 🐳 Docker 📂 Opensource 🏠 Self-Host Suscríbete al canal GENBYTE

Clickea la miniatura para ir a YouTube →

¿Qué es EZBookKeeping en Docker?

EZBookKeeping es una aplicación de finanzas personales completamente autohospedada, lightweight y fácil de usar construida con Go (backend) + React (frontend) que proporciona registro transacciones diarias, import datos múltiples formatos (CSV, OFX, QFX, QIF, IIF), búsqueda y filtrado avanzado, gráficas integradas para análisis, soporte PWA (Progressive Web App - agrega a home screen mobile), interfaces adaptadas mobile y desktop, soporte multi-database (SQLite, MySQL, PostgreSQL), funciona perfectamente en Raspberry Pi, NAS, MicroServers, arquitectura multi-plataforma (x86, amd64, ARM), presupuestos y categorías custom, export datos, sin publicidades, completamente privado, 3.5k+ GitHub stars, MIT open source. La aplicación de finanzas que pedías sin dependencias pesadas.

Propuesta clave: Lightweight personal finance app (Go + React). Record daily transactions. Import data (CSV/OFX/QFX/QIF/IIF). Advanced search + filtering. Built-in charts (spending patterns, trends). PWA support (mobile home screen). Multi-database (SQLite/MySQL/PostgreSQL). Raspberry Pi/NAS optimized. Multi-arch (amd64, arm64, armv7). Budget management. Custom categories. Data export. Ad-free. Private data. Live demo available. Cross-platform. Easy deployment (Docker + binary). 3.5k+ GitHub stars. MIT open source.

Para homelabs: Personal finance app. Lightweight. Self-hosted. Privacy-focused. Multi-database. No ads. Easy deploy.

Características principales

Record transacciones

Registro diario fácil. Categorías custom. Multiple cuentas. Balance tracking.

Import datos

CSV, OFX, QFX, QIF, IIF. Batch import. Mapeo automático. Data validation.

Search + filter

Búsqueda avanzada. Filtros por fecha, categoría, monto. Full-text search.

Built-in charts

Gráficas automáticas. Spending trends. Income analysis. Custom dimensions.

PWA support

Progressive Web App. Add to home screen mobile. Offline capability.

Mobile optimized

Responsive UI. Touch-friendly. Mobile-first design. Desktop adaption.

Budget management

Set budgets por categoría. Track vs budget. Alerts cuando se excede.

Multi-database

SQLite, MySQL, PostgreSQL. Choose backend. Easy migration.

Data export

Export a CSV. Backup datos. Migrate fácilmente. No vendor lock-in.

User management

Multiple users. Separate finances. Admin panel. User roles.

Custom categories

Create categorías custom. Organize gasto. Flexible taxonomy.

Low resource

Runs on Raspberry Pi. NAS compatible. Minimal CPU/RAM usage.

Requisitos del sistema

  • Docker & Docker Compose v2+
  • 256 MB - 1 GB RAM mínimo (ultra-ligero)
  • 100 MB - 50GB+ espacio disco (según datos transacciones)
  • Puerto TCP: 8080 (web UI, configurable)
  • Database: SQLite (embedded, default) O MySQL/PostgreSQL (external)
  • Arquitectura: multi-arch (amd64, arm64, armv7, i386)
  • OS: Linux, Windows, macOS (compatible)
  • Opcional: Reverse proxy nginx/Caddy para HTTPS
💡 Muy ligero: Ideal para Raspberry Pi, NAS, VPS económicos. Bajo consumo CPU/RAM.

Instalación con Docker Compose

Paso 1: docker-compose.yml (simple con SQLite)

version: '3.8' services: ezbookkeeping: image: mayswind/ezbookkeeping:latest container_name: ezbookkeeping restart: unless-stopped ports: - "8080:8080" volumes: - ./data:/data environment: - TZ=America/Mexico_City # SQLite database incrustado en ./data/ezbookkeeping.db

Paso 2: Iniciar EZBookKeeping

docker compose up -d # Espera ~10 segundos para que inicie docker compose logs -f

Paso 3: Acceder a EZBookKeeping

# Abre en navegador: http://localhost:8080 # Desde otro dispositivo: http://192.168.1.100:8080

Acceder a EZBookKeeping

💰 EZBookKeeping Web UI: http://localhost:8080
📊 Carpeta datos: ./data (SQLite database + config)

Primeros pasos

  1. Abre http://localhost:8080 en navegador
  2. Interfaz web limpia y responsiva carga
  3. Create cuenta de usuario + contraseña
  4. Login con credenciales
  5. Dashboard aparece con overview finanzas
  6. Start recording transacciones o importa datos CSV
  7. Crea categorías custom para organizar gasto
  8. View gráficas automáticas de spending patterns
💡 Sin login predeterminado: Primera ejecución setup inicial. Crea usuario admin.

Casos de uso

  • Personal finance tracking: Record daily transactions. Analyze spending. Budget management.
  • Household expenses: Family finance shared. Multiple user accounts. Separate tracking.
  • Small business accounting: Invoice tracking. Expense records. Simple bookkeeping.
  • Data import: Import banking CSV/OFX. Automatic categorization. Deduplication.
  • Analytics: Spending trends. Income vs expenses. Custom charts dimensions.
  • Privacy-focused: Self-hosted. No ads. Complete data control. Export anytime.
  • Low-resource deployment: Raspberry Pi, NAS, VPS económicos. Minimal requirements.

Configuración avanzada

Usar PostgreSQL en lugar SQLite

version: '3.8' services: postgres: image: postgres:15 container_name: ezbookkeeping-db restart: unless-stopped environment: - POSTGRES_DB=ezbookkeeping - POSTGRES_USER=ezbook - POSTGRES_PASSWORD=securepass123 volumes: - db_data:/var/lib/postgresql/data ezbookkeeping: image: mayswind/ezbookkeeping:latest container_name: ezbookkeeping restart: unless-stopped ports: - "8080:8080" environment: - DATABASE_TYPE=postgres - DATABASE_URL=postgres://ezbook:securepass123@postgres:5432/ezbookkeeping depends_on: - postgres volumes: db_data:

Import CSV transactions

# Dashboard → Tools → Import # Selecciona CSV file con transacciones # Map columns (date, description, amount, category) # Automatic categorization options # Deduplication check # Import!

Export datos a CSV

# Dashboard → Export # Select date range # Choose format (CSV, Excel compatible) # Download file

Configurar múltiples usuarios

# Admin Panel → User Management # Create user account # Set permissions (read, write, admin) # Each user has separate transaction view

Gestión y mantenimiento

Ver estado

docker compose ps

Ver logs

docker compose logs -f ezbookkeeping

Detener EZBookKeeping

docker compose down

Actualizar versión

docker compose pull docker compose up -d # Datos persistentes se mantienen en ./data

Backup de datos

docker compose exec ezbookkeeping tar -czf /data/backup-$(date +%Y%m%d).tar.gz /data # O simplemente backup la carpeta: cp -r data data_backup_$(date +%Y%m%d)

Monitorear consumo

docker stats ezbookkeeping # Típicamente: # CPU: <1-5% (según uso) # RAM: 50-200MB (muy ligero) # Pico durante import: <300MB

Stack técnico

  • Backend: Go (Golang, API REST)
  • Frontend: React 18+ (TypeScript, Vite)
  • Database: SQLite (default) / MySQL 5.7+ / PostgreSQL 9.6+
  • Storage: File-based (SQLite) o external database
  • API: REST API (JSON endpoints)
  • Authentication: Session-based (username/password)
  • Frontend rendering: SPA (Single Page App)
  • Cross-platform: Windows, macOS, Linux
  • Deployment: Docker, binary, system package
  • Licencia: MIT open source

Comparativa con alternativas

vs Firefly III

EZBookKeeping gana: Más lightweight, menos recursos, UI más simple. Firefly gana: Más features (bills, recurring, rules engine, OpenAPI), más maduro, comunidad grande.

vs Actual Budget

EZBookKeeping gana: Más simple, mejor para principiantes, no requiere sincronización. Actual gana: Multi-device sync, browser-based, más features avanzadas.

vs GnuCash Desktop

EZBookKeeping gana: Web UI moderno, responsive mobile, más fácil usar, cloud ready. GnuCash gana: Desktop app, más features contables, soporte CSV/OFX nativo.

Mejor para: Homelabs, principiantes, presupuestos personales. Lightweight. Self-hosted. Privacy-first. Fácil usar.

Referencias oficiales

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

Comentarios

Publicar un comentario

Entradas populares de este blog

Cómo Instalar y configurar SERVIDOR VPN WIREGUARD en MIKROTIK 🔐 #VPN #Wireguard #Mikrotik #RouterOS

Imagen
Wireguard en Mikrotik Breve Explicación de Wireguard ¿Qué es WireGuard VPN? WireGuard es un nuevo protocolo de VPN. No se trata de un software, sino de un conjunto de instrucciones que permite crear VPNs de forma muy sencilla. Ha sido desarrollada como una alternativa a IPsec, OpenVPN y similares VPNs, pero más rápida y sencilla de usar. En esencia, WireGuard está basado en ideas del protocolo IPsec. WireGuard es una VPN extremadamente simple, pero rápida y moderna que utiliza criptografía de última generación. Su objetivo es ser más rápido, más simple, y más versátil que IPSec, evitando al mismo tiempo el enorme dolor de cabeza (sobre todo en redes con NAT). Pretende ser considerablemente más eficaz que OpenVPN. WireGuard está diseñado como una VPN de propósito general para ejecutarse en interfaces embebidas, apto para muchas circunstancias diferentes. Se ejecuta sobre el protocolo UDP, por lo tanto es considerado un túnel de capa 3. ¿Cómo funciona Wireguard VPN? WireGuard es un proto...
Read more »

Cómo instalar y configurar DSM SYNOLOGY 7.2.2 en PC | Guía completa, instalación, RAID 1, SMB

Imagen
Instalación y puesta en marcha de Synology DSM 7.2.2 en PC Vídeo ACTUALIZADO, NUEVA VERSIÓN DEL ARC LOADER:  https://youtu.be/LgghogL-UCA https://genbyte.blogspot.com/2025/08/como-convertir-pc-en-synlogy-con-6-tb.html ----- Proceso de instalación y puesta en marcha de sistema operativo DSM Synology versión 7.2.2 en un PC, concretamente un HP 800 G1 EliteDesk. El PC tendrá 3 discos SSD, uno de 120 GB para el S.O. DSM, y otros dos de 240GB cada en RAID 1 para los Datos. Los 3 dicos duros conectados al PC mediante cables SATA. Lo primero que necesitamos es descargar la imagen bootloader ARC, desde el siguiente repositorio de Gothub, también necesitamos Rufus, en este momento, es la versión 4.6. Imagen ARC:  https://github.com/AuxXxilium/arc Imagen usado en el vídeo 1.1.29:  https://github.com/AuxXxilium/arc/releases/tag/1.1.29 Rufus:  https://rufus.ie/es/ Después de descargar la imagen ARC.img, conectamos nuestro primer disco SSD de 120GB por cable o conector SATA-USB y...
Read more »

Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso.

Imagen
Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso. Vídeo tutorial paso a paso en Youtube Desarrollo Ilustración: Diagrama RED Creación de Redes (Address) ----------------------------------------------- WAN 192.168.1.0/24 LAN 192.168.88.0/24 VPN 192.168.100.0/24 Creación del Rango VPN ------------------------ 192.168.100.1 - 192.168.100.100 Creación de los Certificados ------------------------------- Los certificados que vamos a crear a continuación tendrán una validez de 10 años; days-valid=3650 Crear certificado CA ---------------------- /certificate add name=CA-tpl country="" state="" locality="" organization="" unit="" common-name="CA" key-size=4096 days-valid=3650 key-usage=crl-sign,key-cert-sign /certificate sign CA-tpl ca-crl-host=127.0.0.1 name="CA" Crear certificado Server -------------------------- /certificate add name=SERVER-tpl country="" state="" locality=...
Read more »