Cómo instalar y configurar Akaunting: Software de Contabilidad Autohospedado en Docker

Akaunting | Accounting Software | Laravel | VueJS | PostgreSQL | App Store | BSL | 10.1k stars

Akaunting en Docker: Software contabilidad online autohospedado con Laravel, VueJS, PostgreSQL, facturas, gastos, presupuestos, reportes, integraciones pago, modular App Store, BSL open source 💰📊

Akaunting es un software de contabilidad online diseñado para pequeñas empresas y freelancers completamente autohospedado. Laravel + VueJS backend, PostgreSQL/MySQL flexible, facturas profesionales, expense tracking, budgeting, reportes financieros, integraciones Stripe/PayPal, modular App Store extensiones, API REST, usuarios/roles, multi-empresa, 10.1k+ GitHub stars, BSL open source, production-ready.



Vídeo tutorial en YouTube

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

¿Qué es Akaunting en Docker?

Akaunting es un software de contabilidad online autohospedado diseñado para pequeñas empresas y freelancers con Laravel + VueJS backend, PostgreSQL/MySQL flexible, facturas profesionales, expense tracking, budgeting, reportes financieros (P&L, Balance Sheet, Cash Flow), integraciones pago Stripe/PayPal, sistema modular de extensiones (App Store), API REST, usuarios con roles, multi-empresa, control acceso granular, sin dependencias externas, imagen Docker lista para producción. La contabilidad que controlas tú.

Propuesta clave: Self-hosted accounting software (Laravel + VueJS + PostgreSQL). Invoice management. Expense tracking. Budgeting. Financial reports (P&L, Balance, Cash flow). Payment integrations (Stripe, PayPal). Modular App Store. Multi-user with roles. Multi-company support. API REST. No third-party data lock-in. 10.1k GitHub stars. BSL open source license. Production-ready.

Para homelabs: Contabilidad privada. Invoicing profesional. Sin compartir datos. Control total. Pago integrado.

Características principales

Facturas profesionales

Crear, enviar, rastrear. Plantillas personalizables. Recordatorios automáticos.

Gastos e ingresos

Registro de gastos. Categorización. Seguimiento ingresos por cliente.

Presupuestos

Crear presupuestos. Comparar vs gastos reales. Alertas excedente.

Reportes financieros

P&L, Balance Sheet, Cash Flow. Export PDF/Excel. Por período.

Integraciones pago

Stripe, PayPal. Pagos online en facturas. Reconciliación.

Multi-usuario y roles

Usuarios, permisos granulares. Admin, Accountant, Customer roles.

Multi-empresa

Gestionar múltiples empresas. Datos separados. Control acceso.

App Store modular

Extensiones, plugins comunitarios. Monetización para developers.

Requisitos del sistema

  • Docker y Docker Compose: versión reciente.
  • PHP 8.1+: dentro de imagen Docker.
  • Base de datos: PostgreSQL 10+, MySQL 5.7+, MariaDB 10.3+, SQLite.
  • RAM: mínimo 1 GB; recomendado 2-4 GB.
  • Almacenamiento: 5-20 GB (facturas, reportes, datos).
  • Puertos: 8080 (app web), 5432 o 3306 (BD opcional).
📌 Tip: Akaunting es muy flexible con BDs. Elige PostgreSQL para mayor estabilidad en producción.

Instalación con Docker Compose

Paso 1: Crear docker-compose.yml

version: '3.8' services: app: image: akaunting/akaunting:latest ports: - "8080:80" environment: APP_ENV: production APP_DEBUG: "false" APP_KEY: base64:clave_base64_aqui DB_CONNECTION: pgsql DB_HOST: postgres DB_PORT: 5432 DB_DATABASE: akaunting DB_USERNAME: akaunting DB_PASSWORD: contraseña_db_segura TZ: Europe/Madrid depends_on: - postgres volumes: - ./storage:/var/www/html/storage - ./public:/var/www/html/public networks: - akaunting-net postgres: image: postgres:15-alpine environment: POSTGRES_DB: akaunting POSTGRES_USER: akaunting POSTGRES_PASSWORD: contraseña_db_segura TZ: Europe/Madrid volumes: - postgres_data:/var/lib/postgresql/data networks: - akaunting-net volumes: postgres_data: networks: akaunting-net:

Paso 2: Lanzar Docker Compose

docker compose up -d

Paso 3: Acceder a la interfaz

La aplicación estará disponible en http://localhost:8080 en ~30 segundos. Se crea la BD automáticamente.

Acceder al proyecto

URL: http://localhost:8080

Setup inicial: Al primer acceso, Akaunting te pide crear empresa y usuario admin:

  1. Abre http://localhost:8080
  2. Selecciona idioma (Español disponible)
  3. Crea empresa (nombre, moneda, zona horaria)
  4. Crea usuario admin (email, contraseña fuerte)
  5. Configura impuestos y categorías (opcional)
  6. ¡Listo! Dashboard principal
⚠️ Importante: Usa contraseña admin fuerte (16+ caracteres). Cambia en producción.
💡 Consejo: Familiarízate primero creando una factura de prueba. Luego configura integraciones de pago (Stripe/PayPal).

Casos de uso

  • Freelancers: Facturas a clientes. Gastos deducibles. Impuestos anuales.
  • Pequeñas empresas: Invoicing, expense tracking, budgeting, multi-usuario.
  • Autónomos: Control ingresos/gastos. Reportes para hacienda.
  • Agencias: Multi-empresa, multi-usuario, proyectos (con extensiones).
  • Startups: Contabilidad básica. Escalable con plugins.
  • Cumplimiento fiscal: Generación reportes para declaraciones.
  • Integración ERP/CRM: API REST conecta otros sistemas.

Configuración avanzada

Integración con Stripe

Para aceptar pagos de facturas online:

  1. Crea cuenta en stripe.com. Obtén API keys (public + secret).
  2. En Akaunting: Settings → Payment Gateways → Stripe
  3. Pega keys y activa
  4. Clientes pueden pagar facturas directamente

Integración con PayPal

Similar a Stripe. Obtén Client ID + Secret de PayPal Developer Console y configura en Settings.

Usuarios y roles

Akaunting soporta múltiples usuarios con permisos granulares:

  • Admin: Acceso total. Gestión settings, usuarios, facturas.
  • Accountant: Crear/editar facturas, reportes. No settings.
  • Customer: Ver solo sus facturas (portal restringido).
  • Crear roles personalizados según necesidad.

Extensiones (App Store)

Akaunting tiene App Store con extensiones comunitarias:

  • Impuestos automáticos: Cálculo por región/país.
  • Email templates: Personalizar facturas.
  • Integraciones: Slack, Zapier, webhooks.
  • Reportes avanzados: Cash flow proyectado, análisis.

Gestión y mantenimiento

Ver estado y logs

docker compose ps docker compose logs -f app

Detener contenedor

docker compose down

Actualizar Akaunting

docker compose pull docker compose up -d

Las migraciones de BD corren automáticamente.

Backup de datos

Respalda BD PostgreSQL:

docker exec akaunting_postgres_1 pg_dump -U akaunting akaunting > backup.sql

También respalda volumen ./storage (facturas, documentos):

tar -czf storage_backup.tar.gz ./storage/

Monitoreo

  • Facturas pendientes: Dashboard muestra resumen.
  • Pagos recibidos: Seguimiento automático si tienes Stripe/PayPal.
  • Usuarios activos: Settings → Users.
  • Uso almacenamiento: Crece con histórico de facturas/reportes.

Stack técnico

  • Backend: Laravel 10+ (PHP 8.1+)
  • Frontend: VueJS 3 + Tailwind CSS
  • BD: PostgreSQL 10+, MySQL 5.7+, MariaDB, SQLite
  • API: RESTful + JSON
  • Auth: Session-based + API tokens
  • Modularidad: Sistema módulos/plugins (App Store)
  • Container: Docker (PHP 8.x)
  • License: BSL (Business Source License)

Referencias oficiales

Sígueme en mis redes sociales

Comentarios

Entradas populares de este blog

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

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

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