Comment installer le logiciel de budgétisation Actual sur un serveur Debian 12

Actual Budget est un logiciel de gestion financière open-source axé sur la confidentialité et basé sur le “budgétisation de style enveloppe”. Actual est écrit en Node.js et peut être installé localement en un rien de temps. Il prend en charge la synchronisation multi-appareils et le chiffrement de bout en bout optionnel.

Dans ce tutoriel, nous allons vous montrer comment installer le système de budgétisation Actual sur le serveur Debian 12. Vous installerez Actual avec Nginx comme proxy inverse et le sécuriserez avec HTTPS via Certbot et Letsencrypt.

Prérequis

Pour commencer ce tutoriel, assurez-vous d’avoir :

• Un serveur Debian 12
• Un utilisateur non-root avec des privilèges d’administrateur
• Un nom de domaine pointé vers l’adresse IP du serveur

Installation de Node.js et Yarn

Avant d’installer Actual, vous devez vous assurer que Node.js, Git et le gestionnaire de paquets Yarn sont installés sur votre système. À ce moment, Actual nécessite Node v18 ou supérieur, qui peut être installé à partir du dépôt officiel de Debian.

Tout d’abord, exécutez la commande ‘ apt ‘ ci-dessous pour mettre à jour votre index de paquets Debian et installer des paquets de base tels que Node.js, NPM et Git. Entrez ‘ Y ‘ pour confirmer l’installation.

sudo apt update  
sudo apt install nodejs npm git

Après la fin de l’installation, installez le gestionnaire de paquets Yarn en utilisant la commande ‘ npm ‘ ci-dessous. Dans cet exemple, vous installerez Yarn globalement ou au niveau du système.

npm install --global yarn

Une fois terminé, vérifiez la version de Node.js et Yarn avec la commande ci-dessous.

node --version  
yarn --version

Dans la sortie ci-dessous, vous pouvez voir que Node.js 18 et Yarn 1.22 sont installés.

Téléchargement du code source d’Actual Budget

Après l’installation des dépendances, vous êtes prêt à télécharger le code source d’Actual, installer les dépendances via Yarn, configurer Actual avec le fichier ‘config.json’, puis exécuter Actual via la ligne de commande. De plus, vous avez besoin d’un utilisateur dédié pour installer et exécuter Actual sur votre système.

Connectez-vous à votre utilisateur avec la commande ci-dessous.

su - username

Téléchargez le code source d’Actual Budget avec la commande ‘ git ‘ ci-dessous.

git clone https://github.com/actualbudget/actual-server.git

Allez dans le répertoire ‘ actual-server ‘ et installez les dépendances JavaScript avec la commande ‘ yarn ‘ ci-dessous.

cd actual-server  
yarn install

Vous pouvez voir ci-dessous l’installation des dépendances JavaScript via le gestionnaire de paquets Yarn.

Après la fin de l’installation, créez un nouveau fichier ‘ config.json ‘ en utilisant l’éditeur ‘ nano ‘.

nano config.json

Insérez la configuration ci-dessous pour exécuter Actual sur l’adresse IP locale avec le port par défaut 5006.

{  
 "hostname": "127.0.0.1",  
 "port": 5006  
}

Enregistrez le fichier et quittez l’éditeur.

Enfin, exécutez la commande ‘ yarn start ‘ ci-dessous pour démarrer le logiciel actual. Cela ouvrira le port 5006 sur votre localhost ou l’adresse ‘ 127.0.0.1 ‘ qui sera utilisée par l’application.

yarn start

Appuyez sur Ctrl+c pour terminer le processus.

Exécution d’Actual en arrière-plan en tant que service Systemd

Maintenant que vous avez installé et configuré Actual, créons un nouveau fichier de service systemd pour exécuter Actual en arrière-plan en tant que service systemd.

Créez un nouveau fichier de service systemd ‘ /etc/systemd/system/actual.service ‘ avec l’éditeur ‘ nano ‘.

sudo nano /etc/systemd/system/actual.service

Insérez la configuration ci-dessous pour exécuter Actual en arrière-plan en tant que service systemd. Assurez-vous de changer le ‘ User ‘ et le ‘ Group ‘ par votre nom d’utilisateur, puis changez le ‘ WorkingDirectory ‘ par votre chemin approprié.

[Unit]  
Description=Actual-Server (https://actualbudget.org)  
After=network.target  
  
[Service]  
User=flash  
Group=flash  
WorkingDirectory=/home/flash/actual-server/  
ExecStart=/usr/local/bin/yarn start  
Restart=on-watchdog  
  
[Install]  
WantedBy=multi-user.target

Enregistrez le fichier et quittez l’éditeur une fois terminé.

Maintenant, exécutez la commande ‘ systemctl ‘ ci-dessous pour recharger le gestionnaire systemd et appliquer vos modifications.

sudo systemctl daemon-reload

Et ensuite, démarrez et activez le ‘ actual.service ‘ en utilisant la commande suivante. Cela démarrera le ‘ actual.service ‘ en arrière-plan et l’activera pour s’exécuter automatiquement au démarrage du système.

sudo systemctl enable --now actual.service

Vérifiez l’état du ‘ actual.service ‘ avec la commande ci-dessous. Vous devriez voir que le ‘ actual.service ‘ est en cours d’exécution et activé sur votre système.

sudo systemctl status actual.service

Configuration de Nginx en tant que proxy inverse

À ce stade, Actual est en cours d’exécution en arrière-plan en tant que service systemd. Dans cette section, vous allez installer Nginx et le configurer en tant que proxy inverse pour Actual. Après cela, vous générerez des certificats SSL pour votre déploiement Actual via Certbot et Letsencrypt.

Tout d’abord, exécutez la commande ‘ apt ‘ ci-dessous pour installer Nginx, Certbot et le plugin Python3 Certbot Nginx. Entrez ‘ Y ‘ pour procéder à l’installation.

sudo apt install nginx certbot python3-certbot-nginx -y

Après la fin de l’installation, créez un nouveau fichier de bloc serveur Nginx ‘ /etc/nginx/sites-available/actual-budget ‘ avec l’éditeur ‘ nano ‘.

sudo nano /etc/nginx/sites-available/actual-budget

Insérez la configuration ci-dessous et assurez-vous de changer le paramètre ‘ server_name ‘ avec votre nom de domaine.

server {  
listen 80;  
server_name budget.howtoforge.local;  
  
location / {  
include /config/nginx/proxy.conf;  
include /config/nginx/resolver.conf;  
  
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
proxy_set_header Host $host;  
  
set $upstream_app 127.0.0.1;  
set $upstream_port 5006;  
set $upstream_proto http;  
proxy_pass $upstream_proto://$upstream_app:$upstream_port;  
}  
}

Une fois terminé, enregistrez le fichier et quittez l’éditeur.

Maintenant, exécutez la commande ci-dessous pour activer le bloc serveur ‘ actual-budget ‘ et vérifier vos configurations Nginx. S’il n’y a pas d’erreur, vous obtiendrez une sortie telle que ‘ syntax is ok - test is successful ‘.

sudo ln -s /etc/nginx/sites-available/actual-budget /etc/nginx/sites-enabled/  
sudo nginx -t

Ensuite, exécutez la commande ci-dessous pour redémarrer et vérifier l’état du service Nginx. Assurez-vous que le serveur web Nginx est en cours d’exécution.

sudo systemctl restart nginx  
sudo systemctl status nginx

Enfin, exécutez la commande ‘ certbot ‘ ci-dessous pour générer des certificats SSL et sécuriser votre installation de logiciel Actual. Assurez-vous de changer le nom de domaine et l’adresse e-mail dans la commande suivante.

sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email <[email protected]> -d budget.howtoforge.local

Lorsque le processus est terminé, votre installation d’Actual devrait être sécurisée avec HTTPS via Certbot et Letsencrypt. Vos certificats SSL sont disponibles dans le répertoire ‘ /etc/letsencrypt/live/domain.com ‘ et HTTPS est automatiquement activé sur votre fichier de bloc serveur.

Accéder à Actual Budget via un navigateur web

Visitez le nom de domaine de votre installation d’Actual tel que https://budget.howtoforge.local. Si cela réussit, vous verrez le message de bienvenue d’Actual et serez invité à configurer un mot de passe.

Entrez votre nouveau mot de passe et répétez-le, puis cliquez sur ‘ OK ‘.

Une fois le mot de passe configuré, saisissez votre mot de passe pour vous connecter au tableau de bord d’Actual.

Pour la première fois, vous serez invité à voir des données de démonstration ou commencer frais.

Si vous êtes familier avec Actual, vous pouvez cliquer sur ‘ Commencer frais ‘, mais si vous êtes nouveau sur Actual, cliquez sur ‘ Voir la démonstration ‘ pour comprendre les usages de base d’Actual.

Ci-dessous un exemple de données de démonstration du système de budgétisation Actual.

Conclusion

Félicitations ! Vous avez terminé l’installation d’Actual, un logiciel financier axé sur la confidentialité, sur un serveur Debian 12. Vous avez Actual en cours d’exécution en tant que service systemd en arrière-plan, qui fonctionne sur le proxy inverse Nginx. De plus, vous avez également sécurisé Actual avec HTTPS via Certbot et Letsencrypt.