Héberger Actual Budget sur un VPS géré, c'est garder vos budgets et leur synchronisation sur une machine à vous, que nos équipes tiennent à jour et supervisent jour et nuit. Actual Budget est un outil de finances personnelles local-first, publié sous licence MIT. Ce guide suit sa documentation officielle : le rôle du serveur, l'installation avec Docker Compose, HTTPS, le mot de passe du serveur, OpenID, le chiffrement de bout en bout, la synchronisation bancaire, les sauvegardes et les mises à jour.
Par Simon Vasconcelos Lee
Publié le 17 novembre 2026Lecture : 14 minutes
SharedArrayBuffer, que les navigateurs n'ouvrent qu'à une page servie en HTTPS. Un mandataire inverse s'en charge.docker compose pull.Actual Budget est un outil de finances personnelles local-first, écrit en Node.js, que son README présente comme entièrement libre et gratuit. Il garde toutes vos données sur chacun de vos appareils, et les synchronise en arrière-plan avec le serveur que vous avez choisi : l'application fonctionne même sans connexion, et vos modifications rejoignent vos autres appareils dès que le réseau revient.
Le projet se compose d'un client et d'un serveur. Le serveur n'est pas obligatoire, mais la documentation le recommande vivement, car il ouvre plusieurs fonctions :
| Fonction | Sans serveur | Avec serveur |
|---|---|---|
| Budgets, rapports, échéanciers | Oui | Oui |
| Import de transactions depuis un fichier | Oui | Oui |
| Import et export des fichiers de budget | Oui | Oui |
| Application dans le navigateur et sur le téléphone | Oui | |
| Synchronisation entre appareils | Oui | |
| Synchronisation bancaire | Oui | |
| API d'Actual | Oui |
Actual Budget est publié sous licence MIT, au copyright de James Long. Le texte accorde gratuitement à toute personne qui obtient une copie le droit de l'utiliser, de la copier, de la modifier, de la fusionner, de la publier, de la distribuer, d'en concéder des sous-licences et d'en vendre des copies.
Une seule condition : la mention de copyright et le texte de la licence accompagnent toutes les copies ou les parties substantielles du logiciel. Vous pouvez donc faire tourner l'image publiée par le projet pour vous, votre famille ou votre entreprise, sans licence à acheter.
Le projet publie le serveur en image Docker, actualbudget/actual-server sur Docker Hub, et la même image sur le registre de GitHub, ghcr.io/actualbudget/actual. Sur un serveur où Docker est installé, créez un dossier et placez-y ce compose.yaml, tiré du fichier fourni dans le dépôt :
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, il ne s'atteint que par le mandataire inverse posé sur le même serveur, qui ajoute HTTPS.actual-data reçoit tout ce que garde le serveur. Il y crée deux sous-dossiers, server-files et user-files, et la documentation rappelle que ce montage garde vos données quand le conteneur est supprimé.latest suit la dernière version officielle, et la documentation la recommande à la plupart des usages. latest-alpine donne la même version sur une base Alpine, plus légère, et une étiquette comme 26.11.0 fixe une version. Les étiquettes nightly suivent le développement, à chaque modification de sa branche principale.Votre nom de domaine pointe vers le serveur avec des enregistrements A et AAAA, et les visiteurs arrivent sur les ports 80 et 443. Tant que HTTPS n'est pas en place, l'application ne s'ouvre pas : passez directement à la section suivante.
Le projet ne chiffre ni la mémoire ni le processeur nécessaires. La taille dépend du nombre de budgets, de leur historique et du nombre d'appareils qui se synchronisent. Sur un VPS géré, décrivez-nous votre usage et nous vous recommandons la taille qui convient.
Actual Budget s'appuie sur SharedArrayBuffer, une technologie du navigateur que sa documentation déclare indispensable : sans elle, l'application ne démarre pas. Les navigateurs ne l'ouvrent qu'à une page isolée, ce qui suppose deux conditions :
localhost.Cross-Origin-Embedder-Policy à require-corp et Cross-Origin-Opener-Policy à same-origin. Le serveur officiel les ajoute toujours lui-même.Pour ouvrir Actual à Internet, la documentation demande de le placer derrière un mandataire inverse en HTTPS. Le serveur sait aussi servir HTTPS lui-même avec un certificat que vous lui donnez, par ACTUAL_HTTPS_KEY et ACTUAL_HTTPS_CERT : la documentation décrit cette voie pour un serveur qui reste hors d'Internet.
La documentation présente Caddy comme un mandataire inverse simple, qui obtient et renouvelle de lui-même ses certificats. Voici son exemple, adapté à un Caddy installé sur le serveur :
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
Ce bloc reprend la configuration Nginx de la documentation, réduite au port 80 pour laisser Certbot installer HTTPS. Elle masque les deux en-têtes envoyés par Actual, puis les ajoute une seule fois : la documentation prévient qu'un en-tête en double invalide la protection, et l'application s'arrête alors sur l'erreur 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 lève la limite de taille de Nginx, comme dans l'exemple de la documentation : un gros fichier de budget passe ainsi jusqu'au serveur. Certbot installe ensuite le certificat et se charge de le renouveler :
sudo certbot --nginx
Ouvrez votre adresse en https, dans un nouvel onglet plutôt qu'en rechargeant une page restée en erreur, comme le conseille la documentation. L'écran d'accueil d'Actual s'affiche : HTTPS et les en-têtes sont en place.
Au premier lancement, l'écran d'accueil demande de choisir un mot de passe pour le serveur : c'est lui qui protège l'accès à vos budgets. Tant qu'aucun n'est défini, cet écran s'affiche à la première personne qui ouvre l'adresse. Ouvrez-la donc dès que HTTPS fonctionne, et choisissez un mot de passe long, propre à ce serveur.
Le serveur garde ce mot de passe haché, en argon2, dans le fichier account.sqlite de server-files, avec la liste des fichiers de budget qu'il connaît et le jeton de session actif.
La documentation fournit une commande qui définit un nouveau mot de passe sans toucher à vos fichiers ni à vos données. Elle le demande deux fois :
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD : password par défaut, openid pour un fournisseur d'identité, ou header.x-actual-password. La documentation prévient qu'une erreur de réglage à cette étape pourrait ouvrir l'instance à tout Internet : réservez-la à ces services.ACTUAL_ALLOWED_LOGIN_METHODS, une liste séparée par des virgules.Pour une authentification plus robuste qu'un mot de passe, la documentation recommande un fournisseur OpenID : la plupart proposent la double authentification. C'est aussi la condition pour ouvrir le serveur à plusieurs utilisateurs. La référence de configuration présente cette méthode comme une préversion.
https://budget.example.com/openid/callback.La même configuration se définit aussi dans config.json ou par variables d'environnement, avec une adresse de découverte quand le fournisseur en publie une :
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"
Le secret se place dans un fichier .env, à côté de compose.yaml. Depuis la version 26.10.0, ACTUAL_OPENID_CLIENT_SECRET_FILE le lit aussi dans un fichier, ce qui convient aux secrets Docker.
"authMethod": "oauth2", dans config.json.ACTUAL_USER_CREATION_MODE à login les crée à leur première connexion.ACTUAL_OPENID_ENFORCE à true en fait la seule méthode de connexion acceptée.ACTUAL_TOKEN_EXPIRATION vaut never par défaut. Elle peut suivre celle du fournisseur, avec openid-provider, ou une durée en secondes.En plus du mot de passe du serveur, chaque budget peut être chiffré de bout en bout. Ses données sont alors chiffrées sur votre appareil, avec une clé tirée d'un second mot de passe, avant d'en partir : le serveur ne fait plus que transmettre des modifications qu'il ne peut pas lire.
La documentation est claire : un mot de passe de chiffrement oublié ne se récupère pas. Si une copie locale du budget existe encore, vous pouvez générer une nouvelle clé, ce qui réinitialise la synchronisation. Le chiffrement ne se désactive pas non plus : revenir à un fichier non chiffré passe par un export, puis un import.
| Protection | Ce qu'elle apporte | Où elle se règle |
|---|---|---|
| HTTPS | Chiffre le trajet entre vos appareils et le serveur, et permet à l'application de démarrer | Le mandataire inverse |
| Mot de passe du serveur | Réserve l'accès aux budgets, haché en argon2 sur le serveur | Au premier lancement, puis dans les réglages |
| OpenID | La double authentification de votre fournisseur, et des comptes par personne | Chez le fournisseur, puis dans les réglages |
| Chiffrement de bout en bout | Rend les budgets illisibles pour le serveur et pour ses sauvegardes | Dans chaque budget |
| Chiffrement du disque | Protège la copie locale, que la documentation rappelle non chiffrée | Sur chacun de vos appareils |
Le chiffrement de bout en bout porte sur les données du budget. Les identifiants de synchronisation bancaire, eux, sont gardés sur le serveur, dans account.sqlite, hors de ce chiffrement : protégez l'accès au serveur et à ses sauvegardes en conséquence.
Actual importe vos transactions depuis un fichier, sans aucun réglage. Il peut aussi les récupérer directement auprès de votre banque, par un fournisseur d'accès bancaire. Cette synchronisation est facultative, demande le serveur, et repose sur vos propres identifiants : vous ouvrez un compte chez le fournisseur et y créez les clés que vous donnez à Actual. Ces clés sont gardées sur le serveur, et vous ne les saisissez qu'une fois.
| Fournisseur | Banques couvertes, selon la documentation | État à la version 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Banques d'Amérique du Nord | Pris en charge ; identifiants par budget possibles depuis la 26.11.0 |
| GoCardless Bank Account Data | Banques européennes | Pris en charge pour les comptes existants : GoCardless n'ouvre plus de nouveaux comptes depuis juillet 2025 |
| Pluggy.ai | Banques brésiliennes | Pris en charge |
| Enable Banking | Banques européennes | Fonction expérimentale |
| Akahu | Banques néo-zélandaises | Fonction expérimentale |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. Les ponts SimpleFIN publics n'ont besoin d'aucun réglage.Chaque appareil garde une copie complète de vos budgets, et le serveur en garde une autre. Une bonne sauvegarde porte sur les deux : le dossier de données du serveur, et un export de chaque budget.
| Élément | Ce qu'il garde | À sauvegarder |
|---|---|---|
server-files/account.sqlite | Le mot de passe haché, la liste des budgets, les sessions, les comptes OpenID et les identifiants bancaires | Obligatoire, chiffré |
user-files/ | Les fichiers de budget, sous forme de fichiers binaires | Obligatoire |
config.json | La configuration du serveur, si vous en avez créé une | Recommandé, chiffré |
| L'export de chaque budget | Un fichier zip avec la base db.sqlite et metadata.json | Recommandé |
Tout ce que garde le serveur vit dans actual-data. Arrêté, il se copie d'un bloc, avec ses bases SQLite au repos :
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
Planifiez cette copie sur le serveur, chiffrez-la, et gardez-en une ailleurs. Posée sur le disque du serveur, elle entre aussi dans ses sauvegardes de nuit.
Depuis un budget ouvert : Settings, section Data, Export data. Le fichier se garde où vous voulez, et se relit sans serveur. La documentation se sert de cet export pour revenir d'un budget chiffré à un fichier non chiffré : il contient vos données en clair, gardez-le en lieu sûr.
Un budget ancien donne un gros export, car Actual garde chaque modification dans le fichier. La documentation conseille alors Reset sync, dans les réglages avancés, avant d'exporter : l'historique se compacte en un seul fichier, et la taille baisse nettement.
Sur vos autres appareils, choisissez ensuite ce budget dans la liste des fichiers : il se télécharge, puis se synchronise. Les applications de bureau gardent en plus leurs sauvegardes automatiques, une par jour d'usage sur les dix derniers, et plusieurs pour le jour en cours.
La documentation donne la commande, depuis le dossier du compose.yaml. Le dossier de données reste en place :
docker compose pull
docker compose up -d
Les versions se numérotent par année et par mois : la 26.11.0 est sortie le 1er novembre 2026, et les dernières sont parues au début de chaque mois. Lisez leurs notes avant de mettre à jour, et exportez vos budgets juste avant, comme le recommande la documentation. Les notes signalent les changements à prévoir, comme la liste des réseaux SimpleFIN autorisés en 26.11.0, ou le passage de l'image Ubuntu à Node.js 24 en 26.9.0, qui l'a retirée des processeurs ARM 32 bits au profit de l'image Alpine.
nightly : revenir de nightly à latest peut laisser un budget illisible pour la version stable. La documentation décrit la réparation, et demande pour ces étiquettes des sauvegardes de vos budgets.L'auto-hébergement demande de tenir le serveur en plus de l'application. Sur un VPS géré, nos équipes prennent le serveur en main et suivent votre instance de manière proactive ; Actual Budget reste votre logiciel, avec ses réglages et vos budgets.
| Sujet | Nos équipes | Vous |
|---|---|---|
| Le serveur | Mises à jour du système et de la sécurité, interventions sur le serveur comprises | Le moment qui convient à votre activité |
| La supervision | Serveur suivi 24 h/24 et 7 j/7, avec intervention sans attendre votre appel | La lecture des journaux de votre instance |
| Actual Budget | Suivi proactif : erreurs, lenteurs et espace disque repérés, correction recommandée | Son installation, ses mises à jour et ses réglages, que vous appliquez, vous ou votre assistant IA |
| Les accès et les budgets | Le serveur qui les porte, surveillé et sauvegardé | Le mot de passe du serveur, OpenID, les utilisateurs et le chiffrement de bout en bout |
| La synchronisation bancaire | Le serveur qui garde ses identifiants, surveillé et sauvegardé | Le choix du fournisseur, ses clés et les comptes liés |
| Les sauvegardes | Chaque nuit, chiffrées et gardées hors de la machine ; restauration comprise | Les exports de vos budgets, et la demande de restauration, quand vous en avez besoin |
| La migration | Votre serveur actuel migré, offert | Le moment de la bascule |
Si vous préférez que nos équipes interviennent dans l'application elle-même, cette prestation se facture à l'heure ou au forfait, avec un chiffrage communiqué avant l'intervention.
Avec un VPS géré Simafri, nos équipes tiennent à jour le serveur de votre instance Actual Budget, le surveillent jour et nuit et interviennent sans attendre votre appel ; elles suivent aussi votre instance de manière proactive et vous recommandent les corrections utiles, que vous appliquez, vous ou votre assistant IA. Les sauvegardes sont chiffrées chaque nuit et gardées hors de la machine, leur restauration est comprise, et la migration de votre serveur actuel est offerte.
Oui. Actual Budget est publié sous licence MIT : vous pouvez l'utiliser, le modifier et le redistribuer librement, pour vous comme pour une entreprise, en gardant sa mention de copyright et de licence dans les copies. Reste le coût du serveur qui le fait tourner.
Les applications de bureau fonctionnent seules. Le serveur, que la documentation recommande vivement, ajoute l'application web et mobile, la synchronisation entre appareils, la synchronisation bancaire et l'API. Chaque appareil garde une copie complète de vos budgets, synchronisée avec le serveur.
Créez un compose.yaml avec l'image actualbudget/actual-server, le port 5006 publié sur 127.0.0.1 et un dossier de données monté sur /data, puis lancez docker compose up -d. Placez ensuite un mandataire inverse en HTTPS devant, et ouvrez votre adresse pour choisir le mot de passe du serveur.
L'application a besoin de SharedArrayBuffer, que les navigateurs n'ouvrent qu'à une page servie en HTTPS avec les en-têtes Cross-Origin-Embedder-Policy et Cross-Origin-Opener-Policy. Le serveur ajoute ces en-têtes ; le mandataire inverse apporte HTTPS. Seul un accès par localhost s'en passe.
Servez l'instance en HTTPS, choisissez un mot de passe de serveur solide ou passez par OpenID avec double authentification, et activez le chiffrement de bout en bout : le serveur ne lit plus vos budgets. Gardez ce second mot de passe en lieu sûr, car il ne se récupère pas.
Oui, par un fournisseur d'accès bancaire, avec vos propres identifiants : SimpleFIN Bridge, GoCardless Bank Account Data pour les comptes existants, Pluggy.ai, et Enable Banking et Akahu en fonction expérimentale. La synchronisation demande le serveur, et peut tourner automatiquement depuis la version 26.11.0.
Copiez le dossier de données du serveur, service arrêté : server-files porte les comptes et les identifiants, user-files les budgets. Exportez aussi chaque budget depuis Settings, Export data, et gardez ces copies chiffrées. Un export se restaure par Import file.
Un VPS géré couvre le serveur : système, sécurité, supervision et sauvegardes. Nos équipes suivent aussi votre instance de manière proactive et vous recommandent les corrections utiles, que vous appliquez. Une intervention dans l'application se facture à l'heure ou au forfait.
Simafri
Parlons de votre site web
Dites-nous en deux mots votre projet : on revient vers vous rapidement.
Merci ! Votre demande a bien été envoyée. Nous vous répondrons rapidement.
Vous préférez l'email ? Écrivez-nous à support@simafri.com.