Héberger Actual Budget sur un VPS infogéré : vos budgets sur votre serveur

Héberger Actual Budget sur un VPS infogé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.

Simon Vasconcelos Lee Par Publié le 17 novembre 2026Lecture : 15 minutes

Tous les guides

L'essentiel

  1. La licence MIT permet d'utiliser, de modifier et de redistribuer Actual Budget librement, en gardant sa mention de copyright et de licence dans les copies.
  2. Le serveur synchronise vos budgets entre vos appareils et sert l'application web : installez-le avec Docker Compose, une image et un dossier de données.
  3. HTTPS est indispensable : l'application a besoin de SharedArrayBuffer, que les navigateurs n'ouvrent qu'à une page servie en HTTPS. Un proxy inverse s'en charge.
  4. Ouvrez votre adresse dès le premier lancement pour choisir le mot de passe du serveur. OpenID ajoute la double authentification de votre fournisseur et plusieurs utilisateurs.
  5. Le chiffrement de bout en bout, en option, rend vos budgets illisibles pour le serveur. Sauvegardez le dossier de données et exportez vos budgets, puis mettez à jour avec docker compose pull.

Ce que fait Actual Budget, et le rôle de son serveur

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 :

FonctionSans serveurAvec serveur
Budgets, rapports, échéanciersOuiOui
Import de transactions depuis un fichierOuiOui
Import et export des fichiers de budgetOuiOui
Application dans le navigateur et sur le téléphoneOui
Synchronisation entre appareilsOui
Synchronisation bancaireOui
API d’ActualOui

Ce que permet la licence MIT

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.

L'installation avec Docker Compose

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 :

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

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 infogéré, décrivez-nous votre usage et nous vous recommandons la taille qui convient.

HTTPS : une condition pour que l’application démarre

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 :

Pour ouvrir Actual à Internet, la documentation demande de le placer derrière un proxy 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.

Avec Caddy

La documentation présente Caddy comme un proxy inverse simple, qui obtient et renouvelle de lui-même ses certificats. Voici son exemple, adapté à un Caddy installé sur le serveur :

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

Avec Nginx et Certbot

Ce bloc reprend la configuration Nginx de la documentation, réduite au port 80 pour laisser Certbot poser HTTPS. Elle masque les deux en-têtes envoyés par Actual et les repose 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.

Bloc 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 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 pose ensuite le certificat et se charge de le renouveler :

Terminal
sudo certbot --nginx

Vérifier

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.

Le mot de passe du serveur

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 posé, 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.

Réinitialiser un mot de passe oublié

La documentation fournit une commande qui pose un nouveau mot de passe sans toucher à vos fichiers ni à vos données. Elle le demande deux fois :

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

OpenID et plusieurs utilisateurs

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.

  1. Déclarez Actual chez votre fournisseur, avec l'adresse de retour https://budget.example.com/openid/callback.
  2. Dans un budget ouvert, allez dans les réglages et cliquez sur Start using OpenID, puis renseignez le fournisseur, l'identifiant du client et son secret.
  3. Connectez-vous avec OpenID. La documentation prévient que la première personne connectée devient administrateur et propriétaire du serveur, un rôle qui ne se change plus depuis l'interface : connectez-vous la première.

La même configuration se pose aussi dans config.json ou par variables d'environnement, avec une adresse de découverte quand le fournisseur en publie une :

compose.yaml, dans le service
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.

Le chiffrement de bout en bout

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.

  1. Ouvrez le budget, allez dans les réglages, section Encryption, et cliquez sur Enable encryption.
  2. Choisissez un mot de passe différent de celui du serveur.
  3. Sur chaque autre appareil, saisissez ce même mot de passe une fois, au premier téléchargement du budget.

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.

ProtectionCe qu’elle apporteOù elle se règle
HTTPSChiffre le trajet entre vos appareils et le serveur, et permet à l’application de démarrerLe proxy inverse
Mot de passe du serveurRéserve l’accès aux budgets, haché en argon2 sur le serveurAu premier lancement, puis dans les réglages
OpenIDLa double authentification de votre fournisseur, et des comptes par personneChez le fournisseur, puis dans les réglages
Chiffrement de bout en boutRend les budgets illisibles pour le serveur et pour ses sauvegardesDans chaque budget
Chiffrement du disqueProtège la copie locale, que la documentation rappelle non chiffréeSur 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.

La synchronisation bancaire

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.

FournisseurBanques couvertes, selon la documentationÉtat à la version 26.11.0
SimpleFIN BridgeBanques d’Amérique du NordPris en charge ; identifiants par budget possibles depuis la 26.11.0
GoCardless Bank Account DataBanques européennesPris en charge pour les comptes existants : GoCardless n’ouvre plus de nouveaux comptes depuis juillet 2025
Pluggy.aiBanques brésiliennesPris en charge
Enable BankingBanques européennesFonction expérimentale
AkahuBanques néo-zélandaisesFonction expérimentale

Les sauvegardes

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émentCe qu’il gardeÀ sauvegarder
server-files/account.sqliteLe mot de passe haché, la liste des budgets, les sessions, les comptes OpenID et les identifiants bancairesObligatoire, chiffré
user-files/Les fichiers de budget, sous forme de fichiers binairesObligatoire
config.jsonLa configuration du serveur, si vous en avez créé uneRecommandé, chiffré
L’export de chaque budgetUn fichier zip avec la base db.sqlite et metadata.jsonRecommandé

Le dossier du serveur

Tout ce que garde le serveur vit dans actual-data. Arrêté, il se copie d'un bloc, avec ses bases SQLite au repos :

Terminal, dans le dossier du compose.yaml
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.

L’export de chaque budget

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.

Restaurer

  1. Fermez le budget ouvert : cliquez sur son nom, en haut à gauche, puis sur Switch file.
  2. Cliquez sur Import file, choisissez Actual, puis le fichier zip de l’export.
  3. Le budget importé apparaît à côté de l’original : vérifiez-le, renommez-le au besoin, puis supprimez l’ancienne copie.

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.

Les mises à jour

La documentation donne la commande, depuis le dossier du compose.yaml. Le dossier de données reste en place :

Terminal
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.

Qui fait quoi sur un VPS infogéré

L'auto-hébergement demande de tenir le serveur en plus de l'application. Sur un VPS infogé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.

SujetNos équipesVous
Le serveurMises à jour du système et de la sécurité, interventions sur le serveur comprisesLe moment qui convient à votre activité
La supervisionServeur suivi 24 h/24 et 7 j/7, avec intervention sans attendre votre appelLa lecture des journaux de votre instance
Actual BudgetSuivi proactif : erreurs, lenteurs et espace disque repérés, correction recommandéeSon installation, ses mises à jour et ses réglages, que vous appliquez, vous ou votre assistant IA
Les accès et les budgetsLe 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 bancaireLe serveur qui garde ses identifiants, surveillé et sauvegardéLe choix du fournisseur, ses clés et les comptes liés
Les sauvegardesChaque nuit, chiffrées et gardées hors de la machine ; restauration compriseLes exports de vos budgets, et la demande de restauration, quand vous en avez besoin
La migrationVotre serveur actuel migré, offertLe 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.

Actual Budget, sur un serveur tenu pour vous

Avec un VPS infogé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.

Découvrir les VPS infogérés

Questions fréquentes

Actual Budget est-il gratuit ?

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.

Faut-il un serveur pour utiliser Actual Budget ?

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.

Comment installer Actual Budget avec Docker Compose ?

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 proxy inverse en HTTPS devant, et ouvrez votre adresse pour choisir le mot de passe du serveur.

Pourquoi Actual Budget exige-t-il HTTPS ?

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 pose ces en-têtes ; le proxy inverse apporte HTTPS. Seul un accès par localhost s'en passe.

Comment protéger les données d’un budget Actual ?

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.

Actual Budget se connecte-t-il à ma banque ?

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.

Comment sauvegarder Actual Budget ?

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 infogéré couvre-t-il Actual Budget ?

Un VPS infogé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.

Sources et documentation officielle

Guides liés

Différence entre VPS infogéré et non infogéré : qui fait quoiLa différence entre un VPS infogéré et un VPS non infogéré tient à une question : qui s'occupe du serveur une fois qu'il tourne. Le mot « infogéré » n'a pourtant pas de définition officielle, et va d'un hébergeur à l'autre d'une simple installation du système à l'exploitation complète du serveur. Ce guide montre qui fait quoi, ligne par ligne, avec le niveau intermédiaire de l'assistance, et donne les questions qui lèvent l'ambiguïté avant de signer.Sauvegardes d'un VPS : ce qu'il faut vérifier avant de signerUne offre de VPS annonce presque toujours « sauvegardes comprises ». Derrière ces deux mots, il peut y avoir une copie chaque nuit, gardée hors de la machine et restaurée par des experts, ou un instantané posé sur le même disque que le serveur. Ce guide donne les questions qui font la différence, ce que chaque réponse veut dire, et la façon de vérifier qu'une sauvegarde se restaure.Héberger Vaultwarden sur un VPS infogéré : vos mots de passe sur votre serveurHéberger Vaultwarden sur un VPS infogéré, c'est garder vos mots de passe et ceux de votre équipe sur une machine à vous, que nos équipes tiennent à jour et supervisent jour et nuit. Vaultwarden est un logiciel libre sous licence AGPL-3.0. Ce guide suit sa documentation officielle : l'installation avec Docker Compose, HTTPS, la fermeture des inscriptions, le jeton d'administration, ce qui protège le coffre, la base de données, les e-mails, les sauvegardes et les mises à jour.
Contactez-nous