Alojar Actual Budget en un VPS administrado: sus presupuestos en su servidor

Alojar Actual Budget en un VPS administrado significa guardar sus presupuestos y su sincronización en una máquina propia, que nuestros equipos mantienen actualizada y supervisan día y noche. Actual Budget es una herramienta de finanzas personales que da prioridad a los datos locales, publicada con licencia MIT. Esta guía sigue su documentación oficial: el papel del servidor, la instalación con Docker Compose, HTTPS, la contraseña del servidor, OpenID, el cifrado de extremo a extremo, la sincronización bancaria, las copias de seguridad y las actualizaciones.

Simon Vasconcelos Lee Por Publicado el 17 de noviembre de 202614 minutos de lectura

Todas las guías

Lo esencial

  1. La licencia MIT permite usar, modificar y redistribuir Actual Budget libremente, siempre que su aviso de copyright y de licencia acompañe a las copias.
  2. El servidor sincroniza sus presupuestos entre sus dispositivos y sirve la aplicación web: instálelo con Docker Compose, una imagen y una carpeta de datos.
  3. HTTPS es imprescindible: la aplicación necesita SharedArrayBuffer, que los navegadores solo activan en una página servida en HTTPS. Un proxy inverso se encarga de ello.
  4. Abra su dirección en cuanto el servidor arranque por primera vez para elegir la contraseña del servidor. OpenID añade la doble autenticación de su proveedor y varios usuarios.
  5. El cifrado de extremo a extremo, opcional, hace que sus presupuestos sean ilegibles para el servidor. Haga copia de la carpeta de datos y exporte sus presupuestos, y actualice con docker compose pull.

Qué hace Actual Budget, y el papel de su servidor

Actual Budget es una herramienta de finanzas personales que da prioridad a los datos locales, escrita en Node.js, y que su README describe como totalmente gratuita y de código abierto. Guarda todos sus datos en cada uno de sus dispositivos y los sincroniza en segundo plano con el servidor que haya elegido: la aplicación funciona incluso sin conexión, y sus cambios llegan a sus otros dispositivos en cuanto vuelve la red.

El proyecto se compone de un cliente y de un servidor. El servidor es opcional, pero la documentación lo recomienda encarecidamente, porque da acceso a varias funciones:

FunciónSin servidorCon servidor
Presupuestos, informes, programacionesSíSí
Importar transacciones desde un archivoSíSí
Importar y exportar archivos de presupuestoSíSí
La aplicación en un navegador y en un teléfonoSí
La sincronización entre dispositivosSí
La sincronización bancariaSí
La API de ActualSí

Lo que permite la licencia MIT

Actual Budget se publica bajo la licencia MIT, copyright James Long. El texto concede a cualquier persona que obtenga una copia, de forma gratuita, el derecho a usar, copiar, modificar, fusionar, publicar, distribuir, sublicenciar y vender copias del mismo.

Hay una condición: el aviso de copyright y el texto de la licencia acompañan a todas las copias o partes sustanciales del software. Puede, por tanto, ejecutar la imagen publicada por el proyecto para usted, su familia o su empresa, sin ninguna licencia que comprar.

La instalación con Docker Compose

El proyecto publica el servidor en forma de imagen Docker, actualbudget/actual-server en Docker Hub, y la misma imagen en el registro de GitHub, ghcr.io/actualbudget/actual. En un servidor con Docker instalado, cree una carpeta y coloque en ella este compose.yaml, tomado del archivo que ofrece el repositorio:

compose.yaml
services:
  actual_server:
    image: docker.io/actualbudget/actual-server:latest
    container_name: actual_server
    restart: unless-stopped
    ports:
      - 127.0.0.1:5006:5006
    volumes:
      - ./actual-data:/data
    healthcheck:
      test: ['CMD-SHELL', 'node scripts/health-check.js']
      interval: 60s
      timeout: 10s
      retries: 3
      start_period: 20s
Terminal
docker compose up -d

Su nombre de dominio apunta al servidor con registros A y AAAA, y los visitantes llegan por los puertos 80 y 443. Mientras HTTPS no esté en su sitio, la aplicación no se abre: pase directamente a la sección siguiente.

El proyecto no da ninguna cifra de memoria ni de procesador. El tamaño depende del número de presupuestos, de su historial y del número de dispositivos que se sincronizan. En un VPS administrado, descríbanos su uso y le recomendamos el tamaño adecuado.

HTTPS: una condición para que arranque la aplicación

Actual Budget se apoya en SharedArrayBuffer, una tecnología del navegador que su documentación califica de imprescindible: sin ella, la aplicación no arranca. Los navegadores solo la activan en una página aislada, lo que exige dos condiciones:

Para exponer Actual a internet, la documentación pide colocarlo detrás de un proxy inverso con HTTPS. El servidor también puede servir HTTPS por sí mismo con un certificado que usted le proporcione, mediante ACTUAL_HTTPS_KEY y ACTUAL_HTTPS_CERT: la documentación describe esta vía para un servidor que se queda fuera de internet.

Con Caddy

La documentación presenta Caddy como un proxy inverso sencillo, que obtiene y renueva sus certificados por sí mismo. Este es su ejemplo, adaptado a un Caddy instalado en el servidor:

Caddyfile
budget.example.com {
    encode gzip zstd
    reverse_proxy 127.0.0.1:5006
}

Con Nginx y Certbot

Este bloque sigue la configuración de Nginx de la documentación, reducida al puerto 80 para que Certbot pueda instalar HTTPS. Oculta las dos cabeceras enviadas por Actual y las vuelve a establecer, una sola vez: la documentación advierte de que una cabecera duplicada invalida la política, y la aplicación se detiene entonces con el error SharedArrayBufferMissing.

Bloque Nginx
server {
    listen 80;
    listen [::]:80;
    server_name budget.example.com;

    client_max_body_size 0;

    location / {
        proxy_pass http://127.0.0.1:5006;

        proxy_hide_header Cross-Origin-Embedder-Policy;
        proxy_hide_header Cross-Origin-Opener-Policy;

        add_header Cross-Origin-Embedder-Policy "require-corp" always;
        add_header Cross-Origin-Opener-Policy "same-origin" always;
        add_header Origin-Agent-Cluster "?1" always;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

client_max_body_size 0 elimina el límite de tamaño de Nginx, como en el ejemplo de la documentación, para que un archivo de presupuesto voluminoso llegue al servidor. Certbot instala después el certificado y se encarga de renovarlo:

Terminal
sudo certbot --nginx

Comprobar

Abra su dirección en https, en una pestaña nueva en lugar de recargar una página que mostraba un error, como aconseja la documentación. Aparece la pantalla de bienvenida de Actual: HTTPS y las cabeceras están en su sitio.

La contraseña del servidor

En el primer arranque, la pantalla de bienvenida pide elegir una contraseña para el servidor: es lo que protege el acceso a sus presupuestos. Mientras no se defina, esta pantalla se muestra a la primera persona que abra la dirección. Ábrala, por tanto, en cuanto HTTPS funcione, y elija una contraseña larga, reservada a este servidor.

El servidor guarda esta contraseña con hash, en argon2, en el archivo account.sqlite de server-files, junto con la lista de los archivos de presupuesto que conoce y el token de la sesión activa.

Restablecer una contraseña olvidada

La documentación ofrece un comando que define una nueva contraseña sin tocar sus archivos ni sus datos. La pide dos veces:

Terminal
docker exec -it actual_server node /app/src/scripts/reset-password.js

OpenID y varios usuarios

Para una autenticación más sólida que una contraseña, la documentación recomienda un proveedor OpenID: la mayoría ofrecen la doble autenticación. Es también lo que abre el servidor a varios usuarios. La referencia de configuración presenta este método como una vista previa.

  1. Registre Actual en su proveedor, con la URI de redirección https://budget.example.com/openid/callback.
  2. En un presupuesto abierto, vaya a los ajustes y haga clic en Start using OpenID, y rellene después el proveedor, el identificador de cliente y su secreto.
  3. Inicie sesión con OpenID. La documentación advierte de que la primera persona que inicia sesión se convierte en administradora y propietaria del servidor, un rol que ya no puede cambiarse desde la interfaz: asegúrese de ser el primero en iniciar sesión.

La misma configuración puede ir también en config.json o en variables de entorno, con una URL de descubrimiento cuando el proveedor la publica:

compose.yaml, en el servicio
environment:
  ACTUAL_OPENID_DISCOVERY_URL: "https://auth.example.com/.well-known/openid-configuration"
  ACTUAL_OPENID_CLIENT_ID: "actual"
  ACTUAL_OPENID_CLIENT_SECRET: ${ACTUAL_OPENID_CLIENT_SECRET}
  ACTUAL_OPENID_SERVER_HOSTNAME: "https://budget.example.com"

El secreto va en un archivo .env junto a compose.yaml. Desde la versión 26.10.0, ACTUAL_OPENID_CLIENT_SECRET_FILE también puede leerlo de un archivo, lo que conviene a los secretos de Docker.

El cifrado de extremo a extremo

Además de la contraseña del servidor, cada presupuesto puede cifrarse de extremo a extremo. Sus datos se cifran entonces en su dispositivo, con una clave derivada de una segunda contraseña, antes de salir: el servidor solo transmite cambios que no puede leer.

  1. Abra el presupuesto, vaya a los ajustes, sección Encryption, y haga clic en Enable encryption.
  2. Elija una contraseña distinta de la del servidor.
  3. En cada uno de los demás dispositivos, introduzca esta misma contraseña una vez, en la primera descarga del presupuesto.

La documentación es clara: una contraseña de cifrado olvidada no puede recuperarse. Si aún existe una copia local del presupuesto, puede generar una nueva clave, lo que restablece la sincronización. El cifrado tampoco puede desactivarse: volver a un archivo sin cifrar pasa por una exportación y después una importación.

ProtecciónLo que aportaDónde se ajusta
HTTPSCifra el trayecto entre sus dispositivos y el servidor, y permite que la aplicación arranqueEl proxy inverso
Contraseña del servidorLimita el acceso a los presupuestos, guardada con hash argon2 en el servidorEn el primer arranque, y después en los ajustes
OpenIDLa doble autenticación de su proveedor, y una cuenta por personaEn el proveedor, y después en los ajustes
Cifrado de extremo a extremoHace que los presupuestos sean ilegibles para el servidor y para sus copias de seguridadEn cada presupuesto
Cifrado del discoProtege la copia local, que la documentación señala que no está cifradaEn cada uno de sus dispositivos

El cifrado de extremo a extremo cubre los datos de los presupuestos. Los accesos de la sincronización bancaria se guardan en el servidor, en account.sqlite, fuera de este cifrado: proteja en consecuencia el acceso al servidor y a sus copias de seguridad.

La sincronización bancaria

Actual importa sus transacciones desde un archivo, sin ninguna configuración. También puede recuperarlas directamente de su banco, a través de un proveedor de datos bancarios. Esta sincronización es opcional, necesita el servidor y se apoya en sus propios accesos: abre una cuenta con el proveedor y crea en ella las claves que entrega a Actual. Estas claves se guardan en el servidor, y solo las introduce una vez.

ProveedorBancos cubiertos, según la documentaciónSituación en la versión 26.11.0
SimpleFIN BridgeBancos de América del NorteAdmitido; accesos por presupuesto posibles desde la 26.11.0
GoCardless Bank Account DataBancos europeosAdmitido para las cuentas existentes: GoCardless no acepta cuentas nuevas desde julio de 2025
Pluggy.aiBancos brasileñosAdmitido
Enable BankingBancos europeosFunción experimental
AkahuBancos neozelandesesFunción experimental

Las copias de seguridad

Cada dispositivo guarda una copia completa de sus presupuestos, y el servidor guarda otra. Una buena copia de seguridad cubre ambas: la carpeta de datos del servidor, y una exportación de cada presupuesto.

ElementoLo que guardaCopia de seguridad
server-files/account.sqliteLa contraseña con hash, la lista de presupuestos, las sesiones, las cuentas OpenID y los accesos bancariosObligatoria, cifrada
user-files/Los archivos de presupuesto, en forma de archivos binariosObligatoria
config.jsonLa configuración del servidor, si ha creado unaRecomendada, cifrada
La exportación de cada presupuestoUn archivo zip con la base db.sqlite y metadata.jsonRecomendada

La carpeta del servidor

Todo lo que guarda el servidor vive en actual-data. Con el servidor detenido, se copia de una sola vez, con sus bases SQLite en reposo:

Terminal, en la carpeta del compose.yaml
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d

Programe esta copia en el servidor, cífrela y guarde una en otro lugar. Colocada en el disco del servidor, entra también en sus copias de seguridad nocturnas.

La exportación de cada presupuesto

Desde un presupuesto abierto: Settings, sección Data, Export data. El archivo se guarda donde quiera, y se vuelve a abrir sin servidor. La documentación usa esta exportación para pasar de un presupuesto cifrado a un archivo sin cifrar: contiene sus datos en claro, así que guárdelo en un lugar seguro.

Un presupuesto antiguo da una exportación voluminosa, porque Actual conserva en el archivo cada cambio. La documentación aconseja entonces Reset sync, en los ajustes avanzados, antes de exportar: el historial se compacta en un solo archivo, y el tamaño baja mucho.

Restaurar

  1. Cierre el presupuesto abierto: haga clic en su nombre, arriba a la izquierda, y después en Switch file.
  2. Haga clic en Import file, elija Actual y después el archivo zip de la exportación.
  3. El presupuesto importado aparece junto al original: compruébelo, cámbiele el nombre si hace falta y elimine después la copia antigua.

En sus otros dispositivos, elija después este presupuesto en la lista de archivos: se descarga y luego se sincroniza. Las aplicaciones de escritorio guardan además sus propias copias de seguridad automáticas, una por cada uno de los diez últimos días de uso, y varias para el día en curso.

Las actualizaciones

La documentación da el comando, desde la carpeta del compose.yaml. La carpeta de datos se queda en su sitio:

Terminal
docker compose pull
docker compose up -d

Las versiones se numeran por año y mes: la 26.11.0 salió el 1 de noviembre de 2026, y las últimas versiones se han publicado a principios de cada mes. Lea sus notas antes de actualizar, y exporte sus presupuestos justo antes, como recomienda la documentación. Las notas señalan los cambios que hay que prever, como la lista de redes SimpleFIN autorizadas en la 26.11.0, o el paso de la imagen Ubuntu a Node.js 24 en la 26.9.0, que la retiró de los procesadores ARM de 32 bits en favor de la imagen Alpine.

Quién hace qué en un VPS administrado

El autoalojamiento exige mantener el servidor además de la aplicación. En un VPS administrado, nuestros equipos se encargan del servidor y siguen su instancia de forma proactiva; Actual Budget sigue siendo su software, con sus ajustes y sus presupuestos.

TemaNuestros equiposUsted
El servidorActualizaciones del sistema y de seguridad, con intervenciones en el servidor incluidasEl momento que mejor convenga a su actividad
La supervisiónServidor vigilado las 24 horas del día, los 7 días de la semana, con intervención sin esperar su llamadaLa lectura de los registros de su instancia
Actual BudgetSeguimiento proactivo: errores, lentitud y espacio en disco detectados, corrección recomendadaSu instalación, sus actualizaciones y sus ajustes, que aplica usted o su asistente de IA
Los accesos y los presupuestosEl servidor que los soporta, vigilado y con copias de seguridadLa contraseña del servidor, OpenID, los usuarios y el cifrado de extremo a extremo
La sincronización bancariaEl servidor que guarda sus accesos, vigilado y con copias de seguridadLa elección del proveedor, sus claves y las cuentas vinculadas
Las copias de seguridadCada noche, cifradas y guardadas fuera de la máquina; restauración incluidaLas exportaciones de sus presupuestos, y la petición de restauración, cuando la necesite
La migraciónSu servidor actual migrado, gratisEl momento del cambio

Si prefiere que nuestros equipos intervengan en la propia aplicación, ese servicio se factura por horas o a precio cerrado, con un presupuesto comunicado antes de la intervención.

Actual Budget, en un servidor que cuidamos por usted

Con un VPS administrado de Simafri, nuestros equipos mantienen actualizado el servidor de su instancia de Actual Budget, lo vigilan día y noche e intervienen sin esperar su llamada; también siguen su instancia de forma proactiva y le recomiendan las correcciones útiles, que aplica usted o su asistente de IA. Las copias de seguridad se cifran cada noche y se guardan fuera de la máquina, su restauración está incluida, y la migración de su servidor actual es gratuita.

Descubrir los VPS administrados

Preguntas frecuentes

¿Actual Budget es gratuito?

Sí. Actual Budget se publica con licencia MIT: puede usarlo, modificarlo y redistribuirlo libremente, para usted o para una empresa, siempre que su aviso de copyright y de licencia acompañe a las copias. Queda el coste del servidor que lo ejecuta.

¿Hace falta un servidor para usar Actual Budget?

Las aplicaciones de escritorio funcionan solas. El servidor, que la documentación recomienda encarecidamente, añade la aplicación web y móvil, la sincronización entre dispositivos, la sincronización bancaria y la API. Cada dispositivo guarda una copia completa de sus presupuestos, sincronizada con el servidor.

¿Cómo instalar Actual Budget con Docker Compose?

Cree un compose.yaml con la imagen actualbudget/actual-server, el puerto 5006 publicado en 127.0.0.1 y una carpeta de datos montada en /data, y ejecute docker compose up -d. Coloque después delante un proxy inverso en HTTPS, y abra su dirección para elegir la contraseña del servidor.

¿Por qué Actual Budget exige HTTPS?

La aplicación necesita SharedArrayBuffer, que los navegadores solo activan en una página servida en HTTPS con las cabeceras Cross-Origin-Embedder-Policy y Cross-Origin-Opener-Policy. El servidor establece estas cabeceras; el proxy inverso aporta HTTPS. Solo el acceso mediante localhost prescinde de ello.

¿Cómo proteger los datos de un presupuesto de Actual?

Sirva la instancia en HTTPS, elija una contraseña de servidor sólida o use OpenID con doble autenticación, y active el cifrado de extremo a extremo: el servidor ya no puede leer sus presupuestos. Guarde esa segunda contraseña en un lugar seguro, porque no puede recuperarse.

¿Actual Budget se conecta a mi banco?

Sí, a través de un proveedor de datos bancarios, con sus propios accesos: SimpleFIN Bridge, GoCardless Bank Account Data para las cuentas existentes, Pluggy.ai, y Enable Banking y Akahu como funciones experimentales. La sincronización necesita el servidor, y puede ejecutarse de forma automática desde la versión 26.11.0.

¿Cómo hacer copia de seguridad de Actual Budget?

Copie la carpeta de datos del servidor con el servidor detenido: server-files contiene las cuentas y los accesos, user-files los presupuestos. Exporte también cada presupuesto desde Settings, Export data, y guarde estas copias cifradas. Una exportación se restaura con Import file.

¿Un VPS administrado cubre Actual Budget?

Un VPS administrado cubre el servidor: sistema, seguridad, supervisión y copias de seguridad. Nuestros equipos siguen también su instancia de forma proactiva y le recomiendan las correcciones útiles, que aplica usted. Una intervención en la aplicación se factura por horas o a precio cerrado.

Fuentes y documentación oficial

Guías relacionadas

Diferencia entre VPS administrado y no administrado: quién hace quéLa diferencia entre un VPS administrado y uno no administrado se reduce a una pregunta: quién se ocupa del servidor una vez que está en marcha. Sin embargo, «administrado» carece de una definición oficial y, de un proveedor a otro, la palabra va desde una simple instalación del sistema hasta la explotación completa del servidor. Esta guía muestra quién hace qué, tarea por tarea, con el nivel intermedio de la asistencia, y da las preguntas que despejan la ambigüedad antes de firmar.Copias de seguridad de un VPS: qué comprobar antes de contratarUna oferta de VPS anuncia casi siempre «copias de seguridad incluidas». Detrás de estas palabras puede haber una copia cada noche, guardada fuera de la máquina y restaurada por expertos, o una instantánea situada en el mismo disco que el servidor. Esta guía da las preguntas que marcan la diferencia, lo que significa cada respuesta y la forma de comprobar que una copia de seguridad se restaura.Alojar Vaultwarden en un VPS administrado: sus contraseñas en su servidorAlojar Vaultwarden en un VPS administrado significa guardar sus contraseñas y las de su equipo en una máquina propia, que nuestros equipos mantienen actualizada y supervisan día y noche. Vaultwarden es software libre con licencia AGPL-3.0. Esta guía sigue su documentación oficial: la instalación con Docker Compose, HTTPS, el cierre de los registros, el token de administración, lo que protege la caja fuerte, la base de datos, los correos electrónicos, las copias de seguridad y las actualizaciones.
Contáctenos