Ospitare Actual Budget su un VPS gestito significa tenere i vostri budget e la loro sincronizzazione su una macchina tutta vostra, che i nostri team tengono aggiornata e supervisionano giorno e notte. Actual Budget è uno strumento di finanza personale local-first, pubblicato con licenza MIT. Questa guida segue la sua documentazione ufficiale: il ruolo del server, l'installazione con Docker Compose, HTTPS, la password del server, OpenID, la cifratura end-to-end, la sincronizzazione bancaria, i backup e gli aggiornamenti.
Di Simon Vasconcelos Lee
Pubblicato il 17 novembre 2026Lettura: 14 minuti
SharedArrayBuffer, che i browser attivano solo su una pagina servita in HTTPS. Se ne occupa un reverse proxy.docker compose pull.Actual Budget è uno strumento di finanza personale local-first scritto in Node.js, che il suo README descrive come interamente gratuito e open source. Conserva tutti i vostri dati su ciascuno dei vostri dispositivi e li sincronizza in background con il server che avete scelto: l'app funziona anche senza connessione, e le vostre modifiche raggiungono gli altri dispositivi non appena la rete torna disponibile.
Il progetto è composto da un client e da un server. Il server è facoltativo, ma la documentazione lo raccomanda vivamente, perché sblocca diverse funzioni:
| Funzione | Senza server | Con un server |
|---|---|---|
| Budget, report, pianificazioni | Sì | Sì |
| Importazione delle transazioni da un file | Sì | Sì |
| Importazione ed esportazione dei file di budget | Sì | Sì |
| L'app in un browser e su un telefono | Sì | |
| La sincronizzazione tra dispositivi | Sì | |
| La sincronizzazione bancaria | Sì | |
| L'API di Actual | Sì |
Actual Budget è pubblicato con la licenza MIT, copyright James Long. Il testo concede gratuitamente a chiunque ne ottenga una copia il diritto di usarne, copiarne, modificarne, unirne, pubblicarne, distribuirne, concederne in sublicenza e venderne copie.
C'è una sola condizione: l'avviso di copyright e il testo della licenza accompagnano tutte le copie o le parti sostanziali del software. Potete quindi far girare l'immagine pubblicata dal progetto per voi stessi, per la vostra famiglia o per la vostra azienda, senza alcuna licenza da acquistare.
Il progetto pubblica il server come immagine Docker, actualbudget/actual-server su Docker Hub, e la stessa immagine sul registro di GitHub, ghcr.io/actualbudget/actual. Su un server in cui Docker è installato, create una cartella e collocatevi questo compose.yaml, tratto dal file fornito nel repository:
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, si raggiunge solo tramite il reverse proxy sullo stesso server, che aggiunge HTTPS.actual-data contiene tutto ciò che il server conserva. Vi crea due sottocartelle, server-files e user-files, e la documentazione ricorda che questo montaggio conserva i vostri dati quando il container viene eliminato.latest segue l'ultima versione ufficiale, e la documentazione lo raccomanda alla maggior parte degli utenti. latest-alpine dà la stessa versione su una base Alpine più leggera, e un tag come 26.11.0 fissa una versione. I tag nightly seguono lo sviluppo, a ogni modifica del suo ramo principale.Il vostro nome di dominio punta al server con record A e AAAA, e i visitatori arrivano sulle porte 80 e 443. Finché HTTPS non è al suo posto, l'app non si apre: passate direttamente alla sezione successiva.
Il progetto non indica alcun valore di memoria o di CPU. La taglia dipende dal numero di budget, dalla loro cronologia e dal numero di dispositivi che si sincronizzano. Su un VPS gestito, descrivetici il vostro uso e vi raccomandiamo la taglia adatta.
Actual Budget si basa su SharedArrayBuffer, una tecnologia dei browser che la sua documentazione descrive come necessaria: senza di essa, l'app non si avvia. I browser la attivano solo su una pagina isolata, il che richiede due condizioni:
localhost.Cross-Origin-Embedder-Policy impostata su require-corp e Cross-Origin-Opener-Policy impostata su same-origin. Il server ufficiale le imposta sempre da sé.Per esporre Actual su Internet, la documentazione chiede di collocarlo dietro un reverse proxy in HTTPS. Il server può anche servire HTTPS da solo con un certificato che gli fornite, tramite ACTUAL_HTTPS_KEY e ACTUAL_HTTPS_CERT: la documentazione descrive questa strada per un server che resta fuori da Internet.
La documentazione presenta Caddy come un reverse proxy semplice, che ottiene e rinnova da solo i propri certificati. Ecco il suo esempio, adattato a Caddy installato sul server:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
Questo blocco segue la configurazione Nginx della documentazione, ridotta alla porta 80 per lasciare a Certbot l'attivazione di HTTPS. Nasconde le due intestazioni inviate da Actual e le reimposta, una sola volta: la documentazione avverte che un'intestazione duplicata invalida il criterio, e l'app si ferma allora sull'errore 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 toglie il limite di dimensione di Nginx, come nell'esempio della documentazione, perché un file di budget voluminoso arrivi fino al server. Certbot installa poi il certificato e si occupa di rinnovarlo:
sudo certbot --nginx
Aprite il vostro indirizzo in https, in una nuova scheda anziché ricaricando una pagina che mostrava un errore, come consiglia la documentazione. Compare la schermata di benvenuto di Actual: HTTPS e le intestazioni sono al loro posto.
Al primo avvio, la schermata di benvenuto chiede di scegliere una password per il server: è lei a proteggere l'accesso ai vostri budget. Finché non ne è stata impostata una, questa schermata compare alla prima persona che apre l'indirizzo. Apritelo quindi non appena HTTPS funziona, e scegliete una password lunga, usata solo per questo server.
Il server conserva questa password in forma hashata, con argon2, nel file account.sqlite di server-files, insieme all'elenco dei file di budget che conosce e al token della sessione attiva.
La documentazione fornisce un comando che imposta una nuova password senza toccare i vostri file né i vostri dati. La chiede due volte:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: password per impostazione predefinita, openid per un provider di identità, oppure header.x-actual-password. La documentazione avverte che un errore di configurazione in questa fase potrebbe rendere l'istanza accessibile a tutta Internet: riservatelo a quei servizi.ACTUAL_ALLOWED_LOGIN_METHODS, un elenco separato da virgole.Per un'autenticazione più robusta di una password, la documentazione raccomanda un provider OpenID: la maggior parte offre l'autenticazione a due fattori. È anche ciò che apre il server a più utenti. Il riferimento della configurazione presenta questo metodo come un'anteprima.
https://budget.example.com/openid/callback.La stessa configurazione può andare anche in config.json o in variabili d'ambiente, con un URL di discovery quando il provider ne pubblica uno:
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"
Il segreto va in un file .env accanto a compose.yaml. Dalla versione 26.10.0, ACTUAL_OPENID_CLIENT_SECRET_FILE può anche leggerlo da un file, il che si adatta ai secret di Docker.
"authMethod": "oauth2", in config.json.ACTUAL_USER_CREATION_MODE impostato su login li crea al loro primo accesso.ACTUAL_OPENID_ENFORCE impostato su true ne fa l'unico metodo di accesso accettato.ACTUAL_TOKEN_EXPIRATION vale never per impostazione predefinita. Può seguire quella del provider, con openid-provider, oppure una durata in secondi.Oltre alla password del server, ogni budget può essere cifrato end-to-end. I suoi dati vengono allora cifrati sul vostro dispositivo, con una chiave derivata da una seconda password, prima di partire: il server trasmette solo modifiche che non può leggere.
La documentazione è chiara: una password di cifratura dimenticata non si può recuperare. Se esiste ancora una copia locale del budget, potete generare una nuova chiave, il che reimposta la sincronizzazione. Nemmeno la cifratura si può disattivare: tornare a un file non cifrato passa da un'esportazione, poi da un'importazione.
| Protezione | Che cosa offre | Dove si imposta |
|---|---|---|
| HTTPS | Cifra il tragitto tra i vostri dispositivi e il server, e permette all'app di avviarsi | Il reverse proxy |
| Password del server | Limita l'accesso ai budget, hashata con argon2 sul server | Al primo avvio, poi nelle impostazioni |
| OpenID | L'autenticazione a due fattori del vostro provider, e un account per persona | Presso il provider, poi nelle impostazioni |
| Cifratura end-to-end | Rende i budget illeggibili per il server e per i suoi backup | In ogni budget |
| Cifratura del disco | Protegge la copia locale, che la documentazione segnala come non cifrata | Su ciascuno dei vostri dispositivi |
La cifratura end-to-end copre i dati dei budget. Le credenziali della sincronizzazione bancaria sono conservate sul server, in account.sqlite, fuori da questa cifratura: proteggete di conseguenza l'accesso al server e ai suoi backup.
Actual importa le vostre transazioni da un file, senza alcuna configurazione. Può anche recuperarle direttamente dalla vostra banca, tramite un fornitore di dati bancari. Questa sincronizzazione è facoltativa, richiede il server e si basa sulle vostre credenziali: aprite un account presso il fornitore e vi create le chiavi che date ad Actual. Queste chiavi sono conservate sul server, e le inserite una volta sola.
| Fornitore | Banche coperte, secondo la documentazione | Stato alla versione 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Banche nordamericane | Supportato; credenziali per budget possibili dalla 26.11.0 |
| GoCardless Bank Account Data | Banche europee | Supportato per gli account esistenti: GoCardless non accetta nuovi account da luglio 2025 |
| Pluggy.ai | Banche brasiliane | Supportato |
| Enable Banking | Banche europee | Funzione sperimentale |
| Akahu | Banche neozelandesi | Funzione sperimentale |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. I bridge SimpleFIN pubblici non richiedono alcuna impostazione.Ogni dispositivo conserva una copia completa dei vostri budget, e il server ne conserva un'altra. Un buon backup copre entrambe: la cartella dei dati del server, e un'esportazione di ogni budget.
| Elemento | Che cosa conserva | Da salvare |
|---|---|---|
server-files/account.sqlite | La password hashata, l'elenco dei budget, le sessioni, gli account OpenID e le credenziali bancarie | Obbligatorio, cifrato |
user-files/ | I file di budget, in formato binario | Obbligatorio |
config.json | La configurazione del server, se ne avete creata una | Raccomandato, cifrato |
| L'esportazione di ogni budget | Un file zip con il database db.sqlite e metadata.json | Raccomandato |
Tutto ciò che il server conserva vive in actual-data. A server fermo, si copia in un colpo solo, con i suoi database SQLite a riposo:
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
Pianificate questa copia sul server, cifratela, e conservatene una altrove. Collocata sul disco del server, rientra anche nei suoi backup notturni.
Da un budget aperto: Settings, sezione Data, Export data. Il file si conserva dove volete, e si riapre senza server. La documentazione usa questa esportazione per tornare da un budget cifrato a un file non cifrato: contiene i vostri dati in chiaro, quindi conservatela in un luogo sicuro.
Un budget vecchio produce un'esportazione voluminosa, perché Actual conserva ogni modifica nel file. La documentazione consiglia allora Reset sync, nelle impostazioni avanzate, prima di esportare: la cronologia viene compattata in un unico file, e la dimensione cala nettamente.
Sugli altri dispositivi, scegliete poi questo budget nell'elenco dei file: si scarica, poi si sincronizza. Le app desktop mantengono inoltre i propri backup automatici, uno per ciascuno degli ultimi dieci giorni di utilizzo, e diversi per il giorno in corso.
La documentazione fornisce il comando, dalla cartella del compose.yaml. La cartella dei dati resta al suo posto:
docker compose pull
docker compose up -d
Le versioni sono numerate per anno e mese: la 26.11.0 è uscita il 1° novembre 2026, e le ultime versioni sono state pubblicate all'inizio di ogni mese. Leggetene le note prima di aggiornare, ed esportate i vostri budget subito prima, come raccomanda la documentazione. Le note segnalano le modifiche da prevedere, come l'elenco delle reti SimpleFIN consentite nella 26.11.0, o il passaggio dell'immagine Ubuntu a Node.js 24 nella 26.9.0, che l'ha tolta dai processori ARM a 32 bit a favore dell'immagine Alpine.
nightly: tornare da nightly a latest può rendere un budget illeggibile per la versione stabile. La documentazione descrive la correzione, e chiede backup dei vostri budget con questi tag.Il self-hosting richiede di occuparsi del server oltre che dell'applicazione. Su un VPS gestito, i nostri team prendono in carico il server e seguono la vostra istanza in modo proattivo; Actual Budget resta il vostro software, con le sue impostazioni e i vostri budget.
| Argomento | I nostri team | Voi |
|---|---|---|
| Il server | Aggiornamenti del sistema e della sicurezza, interventi sul server compresi | Il momento più adatto alla vostra attività |
| La supervisione | Server seguito 24 ore su 24, 7 giorni su 7, con intervento senza attendere la vostra chiamata | La lettura dei log della vostra istanza |
| Actual Budget | Monitoraggio proattivo: errori, rallentamenti e spazio su disco individuati, correzione raccomandata | La sua installazione, i suoi aggiornamenti e le sue impostazioni, che applicate voi o il vostro assistente IA |
| Gli accessi e i budget | Il server che li ospita, sorvegliato e salvato | La password del server, OpenID, gli utenti e la cifratura end-to-end |
| La sincronizzazione bancaria | Il server che ne conserva le credenziali, sorvegliato e salvato | La scelta del fornitore, le sue chiavi e gli account collegati |
| I backup | Ogni notte, cifrati e conservati fuori dalla macchina; ripristino compreso | Le esportazioni dei vostri budget e la richiesta di ripristino, quando ne avete bisogno |
| La migrazione | Il vostro server attuale migrato, in omaggio | Il momento del passaggio |
Se preferite che i nostri team intervengano nell'applicazione stessa, questa prestazione si fattura a ore o a forfait, con un preventivo comunicato prima dell'intervento.
Con un VPS gestito Simafri, i nostri team tengono aggiornato il server della vostra istanza Actual Budget, lo sorvegliano giorno e notte e intervengono senza attendere la vostra chiamata; seguono anche la vostra istanza in modo proattivo e vi raccomandano le correzioni utili, che applicate voi o il vostro assistente IA. I backup sono cifrati ogni notte e conservati fuori dalla macchina, il loro ripristino è compreso e la migrazione del vostro server attuale è in omaggio.
Sì. Actual Budget è pubblicato con licenza MIT: potete usarlo, modificarlo e ridistribuirlo liberamente, per voi stessi o per un'azienda, a condizione che il suo avviso di copyright e di licenza resti nelle copie. Resta il costo del server che lo fa girare.
Le app desktop funzionano da sole. Il server, che la documentazione raccomanda vivamente, aggiunge l'app web e mobile, la sincronizzazione tra dispositivi, la sincronizzazione bancaria e l'API. Ogni dispositivo conserva una copia completa dei vostri budget, sincronizzata con il server.
Create un compose.yaml con l'immagine actualbudget/actual-server, la porta 5006 pubblicata su 127.0.0.1 e una cartella di dati montata su /data, poi lanciate docker compose up -d. Collocate quindi davanti un reverse proxy in HTTPS, e aprite il vostro indirizzo per scegliere la password del server.
L'app ha bisogno di SharedArrayBuffer, che i browser attivano solo su una pagina servita in HTTPS con le intestazioni Cross-Origin-Embedder-Policy e Cross-Origin-Opener-Policy. Il server imposta queste intestazioni; il reverse proxy porta HTTPS. Solo l'accesso tramite localhost ne fa a meno.
Servite l'istanza in HTTPS, scegliete una password del server solida oppure usate OpenID con l'autenticazione a due fattori, e attivate la cifratura end-to-end: il server non può più leggere i vostri budget. Conservate in un luogo sicuro questa seconda password, che non si può recuperare.
Sì, tramite un fornitore di dati bancari, con le vostre credenziali: SimpleFIN Bridge, GoCardless Bank Account Data per gli account esistenti, Pluggy.ai, ed Enable Banking e Akahu come funzioni sperimentali. La sincronizzazione richiede il server, e può essere automatica dalla versione 26.11.0.
Copiate la cartella dei dati del server a server fermo: server-files contiene gli account e le credenziali, user-files i budget. Esportate anche ogni budget da Settings, Export data, e conservate queste copie cifrate. Un'esportazione si ripristina con Import file.
Un VPS gestito copre il server: sistema, sicurezza, supervisione e backup. I nostri team seguono anche la vostra istanza in modo proattivo e vi raccomandano le correzioni utili, che applicate voi. Un intervento nell'applicazione si fattura a ore o a forfait.
Simafri
Parliamo del vostro progetto
Diteci in due parole ciò che vi serve: vi rispondiamo rapidamente.
Grazie! La tua richiesta è stata inviata. Ti risponderemo a breve.
Preferite l'email? Scriveteci a support@simafri.com.