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.
Por Simon Vasconcelos Lee
Publicado el 17 de noviembre de 202614 minutos de lectura
SharedArrayBuffer, que los navegadores solo activan en una página servida en HTTPS. Un proxy inverso se encarga de ello.docker compose pull.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ón | Sin servidor | Con servidor |
|---|---|---|
| Presupuestos, informes, programaciones | Sí | Sí |
| Importar transacciones desde un archivo | Sí | Sí |
| Importar y exportar archivos de presupuesto | Sí | Sí |
| La aplicación en un navegador y en un teléfono | Sí | |
| La sincronización entre dispositivos | Sí | |
| La sincronización bancaria | Sí | |
| La API de Actual | Sí |
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.
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:
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
docker compose up -d
127.0.0.1, solo es accesible a través del proxy inverso del mismo servidor, que añade HTTPS.actual-data guarda todo lo que conserva el servidor. Crea en ella dos subcarpetas, server-files y user-files, y la documentación señala que este montaje conserva sus datos cuando se elimina el contenedor.latest sigue la versión oficial más reciente, y la documentación la recomienda para la mayoría de los usuarios. latest-alpine ofrece la misma versión sobre una base Alpine más ligera, y una etiqueta como 26.11.0 fija una versión. Las etiquetas nightly siguen el desarrollo, con cada cambio de su rama principal.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.
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:
localhost.Cross-Origin-Embedder-Policy con el valor require-corp y Cross-Origin-Opener-Policy con el valor same-origin. El servidor oficial las establece siempre por sí mismo.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.
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:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
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.
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:
sudo certbot --nginx
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.
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.
La documentación ofrece un comando que define una nueva contraseña sin tocar sus archivos ni sus datos. La pide dos veces:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: password por defecto, openid para un proveedor de identidad, o header.x-actual-password. La documentación advierte de que un error de configuración en este paso podría dejar la instancia accesible a todo internet: resérvelo para esos servicios.ACTUAL_ALLOWED_LOGIN_METHODS, una lista separada por comas.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.
https://budget.example.com/openid/callback.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:
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.
"authMethod": "oauth2", en config.json.ACTUAL_USER_CREATION_MODE con el valor login los crea en su primer inicio de sesión.ACTUAL_OPENID_ENFORCE con el valor true lo convierte en el único método de inicio de sesión aceptado.ACTUAL_TOKEN_EXPIRATION vale never por defecto. Puede seguir la del proveedor, con openid-provider, o una duración en segundos.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.
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ón | Lo que aporta | Dónde se ajusta |
|---|---|---|
| HTTPS | Cifra el trayecto entre sus dispositivos y el servidor, y permite que la aplicación arranque | El proxy inverso |
| Contraseña del servidor | Limita el acceso a los presupuestos, guardada con hash argon2 en el servidor | En el primer arranque, y después en los ajustes |
| OpenID | La doble autenticación de su proveedor, y una cuenta por persona | En el proveedor, y después en los ajustes |
| Cifrado de extremo a extremo | Hace que los presupuestos sean ilegibles para el servidor y para sus copias de seguridad | En cada presupuesto |
| Cifrado del disco | Protege la copia local, que la documentación señala que no está cifrada | En 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.
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.
| Proveedor | Bancos cubiertos, según la documentación | Situación en la versión 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Bancos de América del Norte | Admitido; accesos por presupuesto posibles desde la 26.11.0 |
| GoCardless Bank Account Data | Bancos europeos | Admitido para las cuentas existentes: GoCardless no acepta cuentas nuevas desde julio de 2025 |
| Pluggy.ai | Bancos brasileños | Admitido |
| Enable Banking | Bancos europeos | Función experimental |
| Akahu | Bancos neozelandeses | Función experimental |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. Los puentes SimpleFIN públicos no necesitan ningún ajuste.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.
| Elemento | Lo que guarda | Copia de seguridad |
|---|---|---|
server-files/account.sqlite | La contraseña con hash, la lista de presupuestos, las sesiones, las cuentas OpenID y los accesos bancarios | Obligatoria, cifrada |
user-files/ | Los archivos de presupuesto, en forma de archivos binarios | Obligatoria |
config.json | La configuración del servidor, si ha creado una | Recomendada, cifrada |
| La exportación de cada presupuesto | Un archivo zip con la base db.sqlite y metadata.json | Recomendada |
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:
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.
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.
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.
La documentación da el comando, desde la carpeta del compose.yaml. La carpeta de datos se queda en su sitio:
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.
nightly: volver de nightly a latest puede dejar un presupuesto ilegible para la versión estable. La documentación describe la solución, y pide copias de seguridad de sus presupuestos con estas etiquetas.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.
| Tema | Nuestros equipos | Usted |
|---|---|---|
| El servidor | Actualizaciones del sistema y de seguridad, con intervenciones en el servidor incluidas | El momento que mejor convenga a su actividad |
| La supervisión | Servidor vigilado las 24 horas del día, los 7 días de la semana, con intervención sin esperar su llamada | La lectura de los registros de su instancia |
| Actual Budget | Seguimiento proactivo: errores, lentitud y espacio en disco detectados, corrección recomendada | Su instalación, sus actualizaciones y sus ajustes, que aplica usted o su asistente de IA |
| Los accesos y los presupuestos | El servidor que los soporta, vigilado y con copias de seguridad | La contraseña del servidor, OpenID, los usuarios y el cifrado de extremo a extremo |
| La sincronización bancaria | El servidor que guarda sus accesos, vigilado y con copias de seguridad | La elección del proveedor, sus claves y las cuentas vinculadas |
| Las copias de seguridad | Cada noche, cifradas y guardadas fuera de la máquina; restauración incluida | Las exportaciones de sus presupuestos, y la petición de restauración, cuando la necesite |
| La migración | Su servidor actual migrado, gratis | El 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.
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.
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.
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.
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.
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.
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.
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.
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 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.
Simafri
Hablemos de su proyecto
Díganos en pocas palabras lo que necesita: le respondemos rápidamente.
¡Gracias! Su solicitud ha sido enviada. Le responderemos en breve.
¿Prefiere el correo? Escríbanos a support@simafri.com.