Actual Budget sur un VPS : installation et configuration d'un budget personnel

30/08/20267 min de lecture

Tropic

Actual Budget sur un VPS : installation et configuration d'un budget personnel

Actual Budget : votre propre gestionnaire de budget personnel sur un VPS

Une application bancaire indique où l'argent a déjà été dépensé. Actual Budget répond à une autre question : quelle part de la somme disponible peut réellement être utilisée si une partie est déjà réservée au loyer, à l'alimentation, aux vacances et aux dépenses imprévues ?

Actual Budget est un gestionnaire de finances personnelles gratuit et open source. Il fonctionne localement, se synchronise par l'intermédiaire de votre propre serveur et prend en charge le chiffrement de bout en bout. Examinons ses possibilités, ses limites et son installation sur un VPS.

Actual Budget en sept étapes

Créer un VPS Linux et faire pointer un sous-domaine vers celui-ci, par exemple budget.example.com.
Installer Docker et Docker Compose.
Lancer le conteneur officiel avec un répertoire de données persistant.
Activer HTTPS avec Caddy.
Définir un mot de passe serveur et créer un budget.
Ajouter des comptes, des catégories, des règles et des paiements récurrents.
Activer le chiffrement et configurer une sauvegarde externe.

Qu'est-ce qu'Actual Budget ?

Actual Budget est une application auto-hébergée destinée à la gestion d'un budget personnel ou familial. Elle est souvent présentée comme une alternative ouverte à YNAB, mais il est également possible de commencer avec un budget entièrement neuf.

Le service utilise la méthode des enveloppes virtuelles. Imaginons que les comptes contiennent 100 000 roubles. Sur cette somme, 40 000 sont nécessaires pour le logement, 20 000 pour l'alimentation, 10 000 pour les charges et 15 000 pour une réserve. Une fois l'argent réparti, il ne reste pas 100 000 roubles pour les achats facultatifs, mais seulement 15 000.

Cette approche modifie le rôle de l'application. Un outil classique de suivi des dépenses explique les dépenses passées, tandis qu'Actual Budget aide à prendre une décision avant un achat. Le solde inutilisé d'une catégorie est reporté, et en cas de dépassement il est possible de déplacer de l'argent depuis une autre enveloppe.

L'architecture local-first constitue une autre différence. Le budget est stocké sur les appareils connectés et reste accessible sans Internet. Lorsque la connexion revient, les modifications sont synchronisées par l'intermédiaire du serveur. Le VPS sert principalement à échanger des données entre l'ordinateur, le téléphone et les navigateurs, et non à exécuter chaque opération.

Principales fonctionnalités d'Actual Budget

Budget par enveloppes. Seul l'argent déjà reçu est réparti.
Comptes et opérations. L'application gère les virements, la répartition d'un achat entre plusieurs catégories, les notes et le rapprochement des soldes.
Règles et calendriers. Il est possible de nettoyer les libellés bancaires, d'attribuer des catégories et d'anticiper un salaire, un loyer ou des abonnements.
Importation. Les formats CSV, QIF, OFX, QFX et CAMT sont pris en charge. Les formats contenant des identifiants d'opération protègent mieux contre les doublons.
Rapports. Sont disponibles les flux de trésorerie, le patrimoine net, les dépenses et des graphiques personnalisables.
Migration et API. L'application permet d'importer des données depuis YNAB4 et la version actuelle de YNAB, et fournit une API pour les intégrations personnalisées.

Sur un téléphone, Actual Budget s'installe sous la forme d'une PWA, c'est-à-dire d'une application web ajoutée à l'écran d'accueil. Il est préférable de vérifier au préalable si l'interface mobile vous convient.

Paramètre	Service cloud	Actual Budget
Stockage	Chez le fournisseur	Sur l'appareil et votre propre serveur
Fonctionnement hors ligne	Dépend du service	Les fonctions principales sont disponibles localement
Maintenance	Assurée par le fournisseur	Assurée par le propriétaire
Coût du logiciel	Abonnement ou offre gratuite	Aucun abonnement obligatoire
Contrôle des données	Selon les règles du fournisseur	Entre les mains du propriétaire du serveur

Actual Budget convient aux personnes qui privilégient la confidentialité et le contrôle. Un service cloud reste plus pratique si vous ne souhaitez pas administrer un serveur.

Configuration serveur requise pour Actual Budget

Le projet ne publie pas de minimum strict pour le processeur et la mémoire vive. Le serveur synchronise principalement de petits volumes de données financières. Pour une personne ou une famille, une configuration de départ raisonnable est donc la suivante :

1 vCPU ;
1 Go de RAM ;
SSD de 10 Go ;
Ubuntu 24.04 LTS ;
un domaine ou sous-domaine ;
un espace externe pour la sauvegarde.

Il s'agit d'une recommandation pratique et non d'un minimum officiel. Si d'autres conteneurs doivent être exécutés, il est préférable de prévoir 2 Go de RAM.

Comment installer Actual Budget sur un VPS

Cet exemple utilise Ubuntu 24.04 et le sous-domaine budget.example.com.

1. Préparer le serveur

Créez un enregistrement DNS A pointant vers l'adresse IP du VPS, connectez-vous en SSH et ouvrez uniquement les ports nécessaires :

ssh root@SERVER_IP

apt update && apt upgrade -y
apt install -y ca-certificates curl ufw

ufw allow OpenSSH
ufw allow 80/tcp
ufw allow 443/tcp
ufw enable

2. Installer Docker

Ajoutez le dépôt officiel de Docker :

install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

cat > /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

apt update
apt install -y docker-ce docker-ce-cli containerd.io \
  docker-buildx-plugin docker-compose-plugin

3. Lancer Actual Budget

mkdir -p /opt/actual-budget/data
cd /opt/actual-budget

cat > compose.yml <<'EOF'
services:
  actual:
    image: actualbudget/actual-server:latest
    restart: unless-stopped
    ports:
      - "127.0.0.1:5006:5006"
    volumes:
      - ./data:/data
EOF

docker compose up -d
docker compose ps

La liaison à 127.0.0.1 empêche d'exposer directement le port 5006 à Internet. Les budgets sont enregistrés dans /opt/actual-budget/data et ne disparaissent pas lors de la mise à jour du conteneur.

4. Activer HTTPS

apt install -y caddy

cat > /etc/caddy/Caddyfile <<'EOF'
budget.example.com {
    reverse_proxy 127.0.0.1:5006
}
EOF

caddy validate --config /etc/caddy/Caddyfile
systemctl reload caddy

Lorsque le DNS pointe vers le VPS et que les ports 80 et 443 sont accessibles, Caddy obtient automatiquement un certificat TLS. Ouvrez https://budget.example.com et définissez un mot de passe serveur long.

Comment configurer le premier budget

Il n'est pas nécessaire de commencer par importer plusieurs années d'historique. Il est plus rapide d'ajouter les comptes actuellement utilisés, d'indiquer leurs soldes actuels et de créer des catégories pour les paiements obligatoires, les dépenses quotidiennes, l'épargne et les dépenses irrégulières.

Répartissez uniquement l'argent déjà disponible jusqu'à ce que la somme « à répartir » atteigne zéro. Importez ensuite les opérations récentes, vérifiez les soldes et créez des règles pour les magasins, abonnements et virements fréquents.

Les catégories doivent faciliter les décisions. Des enveloppes distinctes pour la « santé », la « réparation du matériel » et les « abonnements annuels » sont plus utiles qu'une catégorie générale « divers ».

Ce qu'il faut savoir sur la synchronisation bancaire

La connexion bancaire n'est pas disponible dans tous les pays et dépend du fournisseur d'API pris en charge. Elle nécessite votre propre serveur ainsi que des identifiants supplémentaires. Actual Budget ne lance pas la synchronisation de façon entièrement automatique : l'utilisateur doit la déclencher depuis l'interface.

Les jetons de connexion bancaire sont stockés séparément sur le serveur et ne sont pas couverts par le chiffrement de bout en bout du budget. Si une banque précise n'est pas prise en charge, les opérations peuvent être importées depuis un relevé. Les formats OFX et QFX sont généralement plus pratiques que CSV, car ils contiennent des identifiants de transaction.

Chiffrement, sauvegardes et mises à jour

Le chiffrement de bout en bout s'active séparément pour chaque budget. Le mot de passe doit être conservé dans un gestionnaire de mots de passe, car le serveur ne pourra pas le récupérer. Actual Budget ne chiffre pas lui-même la copie locale : le téléphone et l'ordinateur doivent donc être protégés par un code de verrouillage et le chiffrement du disque.

La synchronisation ne remplace pas une sauvegarde. Exportez régulièrement le budget depuis les paramètres et copiez le répertoire de données vers un autre emplacement :

cd /opt/actual-budget
docker compose stop
tar -czf /root/actual-budget-$(date +%F).tar.gz data
docker compose start

L'archive doit être transférée en dehors du VPS. Avant une mise à jour, créez également une copie, puis exécutez :

cd /opt/actual-budget
docker compose pull
docker compose up -d

Pour une utilisation permanente, choisissez le tag stable latest plutôt que le tag expérimental nightly.

Quel VPS choisir pour Actual Budget ?

Une instance personnelle ne nécessite pas de serveur puissant. Un VPS Linux de base de tropic.host suffit pour héberger Actual Budget, Caddy et un sous-domaine protégé par HTTPS. Il est raisonnable de commencer avec 1 Go de RAM et de n'augmenter les ressources qu'en ajoutant d'autres services auto-hébergés.

N'exposez pas directement le port 5006, installez les mises à jour et conservez au moins une sauvegarde en dehors du VPS principal. La sécurité d'un service auto-hébergé dépend de la configuration réalisée par son propriétaire.

Limites d'Actual Budget

Actual Budget exige une maintenance autonome. La synchronisation bancaire est limitée selon les pays et les fournisseurs, la version mobile fonctionne sous forme de PWA et la perte du mot de passe de chiffrement peut rendre le budget inaccessible.

Le service ne conviendra pas à tout le monde, mais il répond efficacement à un besoin précis : associer la méthode des enveloppes, l'automatisation et le contrôle des données sans abonnement obligatoire.

Conclusion

Actual Budget transforme le suivi des dépenses en plan : chaque somme reçue obtient une fonction à l'avance. L'application fonctionne localement, se synchronise par l'intermédiaire de votre propre serveur et prend en charge l'importation, les règles, les rapports et le chiffrement.

Un petit VPS suffit pour la faire fonctionner. Après l'installation, le plus important est d'activer HTTPS, de conserver le mot de passe de chiffrement en lieu sûr et de configurer une sauvegarde externe.

FAQ

Actual Budget est-il gratuit ?

Oui. L'application est distribuée en open source et ne nécessite aucun abonnement obligatoire. Le VPS, le domaine et le stockage de sauvegarde sont facturés séparément.

Faut-il obligatoirement installer Actual Budget sur un VPS ?

Non. Il peut être utilisé localement sur un seul ordinateur. Un serveur est nécessaire pour synchroniser plusieurs appareils, connecter des banques, utiliser l'API et disposer d'un accès web permanent.

Peut-on connecter Actual Budget à une banque ?

Oui, si la banque et la région sont prises en charge par l'un des fournisseurs disponibles. Dans le cas contraire, les opérations peuvent être importées depuis des fichiers CSV, QIF, OFX, QFX ou CAMT.

Est-il sûr de stocker son budget sur son propre serveur ?

Oui, avec une configuration correcte, mais la responsabilité appartient au propriétaire. HTTPS, un mot de passe long, le chiffrement, les mises à jour et des sauvegardes externes sont nécessaires.

De combien de mémoire vive Actual Budget a-t-il besoin ?

Il n'existe pas de minimum officiel. Pour une instance personnelle, 1 Go de RAM constitue un point de départ pratique ; si d'autres services sont hébergés, mieux vaut prévoir 2 Go.

Retour au blog