Come installare il software di budgeting Actual su un server Debian 12

Actual Budget è un software di gestione finanziaria open-source focalizzato sulla privacy e costruito sulla base del “Budgeting in stile busta”. Actual è scritto in Node.js e può essere installato localmente in un attimo. Supporta la sincronizzazione multi-dispositivo e la crittografia end-to-end opzionale.

In questo tutorial, ti mostreremo come installare il sistema di budgeting Actual sul server Debian 12. Installerai Actual con Nginx come reverse proxy e lo proteggerai con HTTPS tramite Certbot e Letsencrypt.

Prerequisiti

Per iniziare con questo tutorial, assicurati di avere:

• Un server Debian 12
• Un utente non root con privilegi di amministratore
• Un nome di dominio puntato all’indirizzo IP del server

Installazione di Node.js e Yarn

Prima di installare Actual, devi assicurarti che Node.js, Git e il gestore pacchetti Yarn siano installati sul tuo sistema. In questo momento, Actual richiede Node v18 o superiore, che può essere installato dal repository ufficiale di Debian.

Per prima cosa, esegui il comando ‘ apt ‘ qui sotto per aggiornare l’indice dei pacchetti Debian e installare pacchetti di base come Node.js, NPM e Git. Inserisci ‘ Y ‘ per confermare l’installazione.

sudo apt update  
sudo apt install nodejs npm git

Dopo che l’installazione è terminata, installa il gestore pacchetti Yarn utilizzando il comando ‘ npm ‘ qui sotto. In questo esempio, installerai Yarn globalmente o a livello di sistema.

npm install --global yarn

Quando hai finito, controlla la versione di Node.js e Yarn con il comando qui sotto.

node --version  
yarn --version

Nell’output qui sotto, puoi vedere che Node.js 18 e Yarn 1.22 sono installati.

Download del codice sorgente di Actual Budget

Dopo che le dipendenze sono installate, sei pronto per scaricare il codice sorgente di Actual, installare le dipendenze tramite Yarn, configurare Actual con il file ‘config.json’ e poi eseguire Actual tramite la riga di comando. Inoltre, hai bisogno di un utente dedicato per installare ed eseguire Actual sul tuo sistema.

Accedi al tuo utente con il comando qui sotto.

su - username

Scarica il codice sorgente di Actual Budget con il comando ‘ git ‘ qui sotto.

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

Vai nella directory ‘ actual-server ‘ e installa le dipendenze JavaScript con il comando ‘ yarn ‘ qui sotto.

cd actual-server  
yarn install

Puoi vedere qui sotto l’installazione delle dipendenze JavaScript tramite il gestore pacchetti Yarn.

Dopo che l’installazione è completa, crea un nuovo file ‘ config.json ‘ utilizzando l’editor ‘ nano ‘.

nano config.json

Inserisci la configurazione qui sotto per eseguire Actual sull’indirizzo IP locale con la porta predefinita 5006.

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

Salva il file ed esci dall’editor.

Infine, esegui il comando ‘ yarn start ‘ qui sotto per avviare il software Actual. Questo aprirà la porta 5006 sul tuo localhost o sull’indirizzo ‘ 127.0.0.1 ‘ che sarà utilizzato dall’applicazione.

yarn start

Premi Ctrl+c per terminare il processo.

Esecuzione di Actual in background come servizio Systemd

Ora che hai installato e configurato Actual, creiamo un nuovo file di servizio systemd per eseguire Actual in background come servizio systemd.

Crea un nuovo file di servizio systemd ‘ /etc/systemd/system/actual.service ‘ con l’editor ‘ nano ‘.

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

Inserisci la configurazione qui sotto per eseguire Actual in background come servizio systemd. Assicurati di cambiare il ‘ User ‘ e ‘ Group ‘ predefiniti con il tuo nome utente, quindi cambia il ‘ WorkingDirectory ‘ con il tuo percorso corretto.

[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

Salva il file ed esci dall’editor quando hai finito.

Ora esegui il comando ‘ systemctl ‘ qui sotto per ricaricare il gestore systemd e applicare le tue modifiche.

sudo systemctl daemon-reload

E poi, avvia e abilita il ‘ actual.service ‘ utilizzando il comando seguente. Questo avvierà il ‘ actual.service ‘ in background e lo abiliterà a essere eseguito automaticamente all’avvio del sistema.

sudo systemctl enable --now actual.service

Controlla lo stato del ‘ actual.service ‘ con il comando qui sotto. Dovresti vedere che il ‘ actual.service ‘ è in esecuzione e abilitato sul tuo sistema.

sudo systemctl status actual.service

Configurazione di Nginx come reverse proxy

A questo punto, Actual è attivo e funzionante in background come servizio systemd. In questa sezione, installerai Nginx e lo configurerai come reverse proxy per Actual. Dopo di che, genererai certificati SSL per il tuo deployment di Actual tramite Certbot e Letsencrypt.

Per prima cosa, esegui il comando ‘ apt ‘ qui sotto per installare Nginx, Certbot e il plugin Python3 Certbot Nginx. Inserisci ‘ Y ‘ per procedere con l’installazione.

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

Dopo che l’installazione è terminata, crea un nuovo file di blocco server Nginx ‘ /etc/nginx/sites-available/actual-budget ‘ con l’editor ‘ nano ‘.

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

Inserisci la configurazione qui sotto e assicurati di cambiare il parametro ‘ server_name ‘ con il tuo nome di dominio.

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;  
}  
}

Quando hai finito, salva il file ed esci dall’editor.

Ora esegui il comando qui sotto per attivare il blocco server ‘ actual-budget ‘ e verificare le tue configurazioni Nginx. Se non ci sono errori, riceverai un output come ‘ syntax is ok - test is successful ‘.

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

Successivamente, esegui il comando qui sotto per riavviare e verificare lo stato del servizio Nginx. Assicurati che il server web Nginx sia in esecuzione.

sudo systemctl restart nginx  
sudo systemctl status nginx

Infine, esegui il comando ‘ certbot ‘ qui sotto per generare certificati SSL e proteggere la tua installazione del software Actual. Assicurati di cambiare il nome di dominio e l’indirizzo email nel seguente comando.

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

Quando il processo è terminato, la tua installazione di Actual dovrebbe essere protetta con HTTPS tramite Certbot e Letsencrypt. I tuoi certificati SSL sono disponibili nella directory ‘ /etc/letsencrypt/live/domain.com ‘ e HTTPS è automaticamente abilitato nel tuo file di blocco server.

Accesso ad Actual Budget tramite browser web

Visita il nome di dominio della tua installazione di Actual come https://budget.howtoforge.local. Se tutto va a buon fine, vedrai il messaggio di benvenuto di Actual e ti verrà chiesto di impostare una password.

Inserisci la tua nuova password e ripetila, quindi fai clic su ‘ OK ‘.

Una volta configurata la password, inserisci la tua password per accedere al Dashboard di Actual.

Per la prima volta, ti verrà chiesto di visualizzare i dati demo o iniziare da zero.

Se sei già familiare con Actual, puoi fare clic su ‘ Inizia da zero ‘, ma se sei nuovo in Actual, fai clic su ‘ Visualizza demo ‘ per avere un’idea dell’uso di base di Actual.

Di seguito è riportato un esempio di dati demo dal sistema di budgeting Actual.

Conclusione

Congratulazioni! Hai completato l’installazione di Actual, un software finanziario focalizzato sulla privacy, su un server Debian 12. Hai Actual attivo e funzionante come servizio systemd in background, che è in esecuzione sopra il reverse proxy Nginx. Inoltre, hai anche protetto Actual con HTTPS tramite Certbot e Letsencrypt.