Ospitare Actual Budget su un VPS gestito: i vostri budget sul vostro server

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.

Simon Vasconcelos Lee Di Pubblicato il 17 novembre 2026Lettura: 14 minuti

Tutte le guide

In breve

  1. La licenza MIT consente di usare, modificare e ridistribuire Actual Budget liberamente, a condizione che il suo avviso di copyright e di licenza resti nelle copie.
  2. Il server sincronizza i vostri budget tra i vostri dispositivi e serve l'app web: installatelo con Docker Compose, un'immagine e una cartella di dati.
  3. HTTPS è indispensabile: l'app ha bisogno di SharedArrayBuffer, che i browser attivano solo su una pagina servita in HTTPS. Se ne occupa un reverse proxy.
  4. Aprite il vostro indirizzo fin dal primo avvio del server per scegliere la password del server. OpenID aggiunge l'autenticazione a due fattori del vostro provider e più utenti.
  5. La cifratura end-to-end, facoltativa, rende i vostri budget illeggibili per il server. Salvate la cartella dei dati ed esportate i vostri budget, poi aggiornate con docker compose pull.

Che cosa fa Actual Budget, e il ruolo del suo server

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:

FunzioneSenza serverCon un server
Budget, report, pianificazioniSìSì
Importazione delle transazioni da un fileSìSì
Importazione ed esportazione dei file di budgetSìSì
L'app in un browser e su un telefonoSì
La sincronizzazione tra dispositiviSì
La sincronizzazione bancariaSì
L'API di ActualSì

Che cosa consente la licenza MIT

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.

L'installazione con Docker Compose

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:

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
Terminale
docker compose up -d

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.

HTTPS: una condizione per l'avvio dell'app

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:

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.

Con Caddy

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:

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

Con Nginx e Certbot

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.

Blocco 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 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:

Terminale
sudo certbot --nginx

Verificare

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.

La password del server

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.

Reimpostare una password dimenticata

La documentazione fornisce un comando che imposta una nuova password senza toccare i vostri file né i vostri dati. La chiede due volte:

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

OpenID e più utenti

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.

  1. Registrate Actual presso il vostro provider, con l'URI di reindirizzamento https://budget.example.com/openid/callback.
  2. In un budget aperto, andate nelle impostazioni e fate clic su Start using OpenID, poi indicate il provider, l'ID client e il relativo segreto.
  3. Accedete con OpenID. La documentazione avverte che la prima persona che accede diventa amministratore e proprietario del server, un ruolo che non si può più cambiare dall'interfaccia: assicuratevi di accedere per primi.

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:

compose.yaml, nel servizio
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.

La cifratura end-to-end

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.

  1. Aprite il budget, andate nelle impostazioni, sezione Encryption, e fate clic su Enable encryption.
  2. Scegliete una password diversa dalla password del server.
  3. Su ogni altro dispositivo, inserite questa stessa password una volta, al primo download del budget.

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.

ProtezioneChe cosa offreDove si imposta
HTTPSCifra il tragitto tra i vostri dispositivi e il server, e permette all'app di avviarsiIl reverse proxy
Password del serverLimita l'accesso ai budget, hashata con argon2 sul serverAl primo avvio, poi nelle impostazioni
OpenIDL'autenticazione a due fattori del vostro provider, e un account per personaPresso il provider, poi nelle impostazioni
Cifratura end-to-endRende i budget illeggibili per il server e per i suoi backupIn ogni budget
Cifratura del discoProtegge la copia locale, che la documentazione segnala come non cifrataSu 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.

La sincronizzazione bancaria

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.

FornitoreBanche coperte, secondo la documentazioneStato alla versione 26.11.0
SimpleFIN BridgeBanche nordamericaneSupportato; credenziali per budget possibili dalla 26.11.0
GoCardless Bank Account DataBanche europeeSupportato per gli account esistenti: GoCardless non accetta nuovi account da luglio 2025
Pluggy.aiBanche brasilianeSupportato
Enable BankingBanche europeeFunzione sperimentale
AkahuBanche neozelandesiFunzione sperimentale

I backup

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.

ElementoChe cosa conservaDa salvare
server-files/account.sqliteLa password hashata, l'elenco dei budget, le sessioni, gli account OpenID e le credenziali bancarieObbligatorio, cifrato
user-files/I file di budget, in formato binarioObbligatorio
config.jsonLa configurazione del server, se ne avete creata unaRaccomandato, cifrato
L'esportazione di ogni budgetUn file zip con il database db.sqlite e metadata.jsonRaccomandato

La cartella del server

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:

Terminale, nella cartella del compose.yaml
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.

L'esportazione di ogni budget

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.

Ripristinare

  1. Chiudete il budget aperto: fate clic sul suo nome in alto a sinistra, poi su Switch file.
  2. Fate clic su Import file, scegliete Actual, poi il file zip dell'esportazione.
  3. Il budget importato compare accanto all'originale: verificatelo, rinominatelo se serve, poi eliminate la vecchia copia.

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.

Gli aggiornamenti

La documentazione fornisce il comando, dalla cartella del compose.yaml. La cartella dei dati resta al suo posto:

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

Chi fa che cosa su un VPS gestito

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.

ArgomentoI nostri teamVoi
Il serverAggiornamenti del sistema e della sicurezza, interventi sul server compresiIl momento più adatto alla vostra attività
La supervisioneServer seguito 24 ore su 24, 7 giorni su 7, con intervento senza attendere la vostra chiamataLa lettura dei log della vostra istanza
Actual BudgetMonitoraggio proattivo: errori, rallentamenti e spazio su disco individuati, correzione raccomandataLa sua installazione, i suoi aggiornamenti e le sue impostazioni, che applicate voi o il vostro assistente IA
Gli accessi e i budgetIl server che li ospita, sorvegliato e salvatoLa password del server, OpenID, gli utenti e la cifratura end-to-end
La sincronizzazione bancariaIl server che ne conserva le credenziali, sorvegliato e salvatoLa scelta del fornitore, le sue chiavi e gli account collegati
I backupOgni notte, cifrati e conservati fuori dalla macchina; ripristino compresoLe esportazioni dei vostri budget e la richiesta di ripristino, quando ne avete bisogno
La migrazioneIl vostro server attuale migrato, in omaggioIl 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.

Actual Budget, su un server gestito per voi

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.

Scoprire i VPS gestiti

Domande frequenti

Actual Budget è gratuito?

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.

Serve un server per usare Actual Budget?

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.

Come installare Actual Budget con Docker Compose?

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.

Perché Actual Budget richiede HTTPS?

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.

Come proteggere i dati di un budget Actual?

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.

Actual Budget si collega alla mia banca?

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.

Come fare il backup di Actual Budget?

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 Actual Budget?

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.

Fonti e documentazione ufficiale

Guide correlate

Differenza tra VPS gestito e non gestito: chi fa che cosaLa differenza tra un VPS gestito e un VPS non gestito si riduce a una domanda: chi si occupa del server una volta che è in funzione. La parola «gestito», o «managed», non ha però una definizione ufficiale: da un provider all'altro, va dalla semplice installazione del sistema alla gestione completa del server. Questa guida mostra chi fa che cosa, voce per voce, con il livello intermedio dell'assistenza, e indica le domande che chiariscono ogni ambiguità prima di firmare.Backup di un VPS: che cosa verificare prima di firmareUn'offerta di VPS annuncia quasi sempre «backup compresi». Dietro queste due parole può esserci una copia ogni notte, conservata fuori dalla macchina e ripristinata da esperti, oppure uno snapshot posato sullo stesso disco del server. Questa guida indica le domande che fanno la differenza, che cosa significa ogni risposta, e il modo di verificare che un backup si possa ripristinare.Ospitare Vaultwarden su un VPS gestito: le vostre password sul vostro serverOspitare Vaultwarden su un VPS gestito significa custodire le vostre password e quelle del vostro team su una macchina tutta vostra, che i nostri team tengono aggiornata e supervisionano giorno e notte. Vaultwarden è un software libero con licenza AGPL-3.0. Questa guida segue la sua documentazione ufficiale: l'installazione con Docker Compose, HTTPS, la chiusura delle registrazioni, il token di amministrazione, ciò che protegge la cassaforte, il database, le e-mail, i backup e gli aggiornamenti.
Contattaci