Actual Budget op engem Managed VPS hosten heescht, Är Budgeten an hir Synchronisatioun op enger Maschinn ze halen, déi Iech gehéiert a vun eisen Equippen Dag an Nuecht aktuell gehal a verfollegt gëtt. Actual Budget ass e Local-first-Tool fir déi perséinlech Finanzen, ënner der MIT-Lizenz publizéiert. Dëse Guide follegt senger offizieller Dokumentatioun: d’Roll vum Server, d’Installatioun mat Docker Compose, HTTPS, d’Serverpasswuert, OpenID, d’End-to-End-Verschlësselung, d’Bankesynchronisatioun, d’Backups an d’Aktualiséierungen.
Auteur: Simon Vasconcelos Lee
Publizéiert de 17. November 2026Lieszäit: 14 Minutten
SharedArrayBuffer, wat d’Browser nëmmen op enger Säit aktivéieren, déi iwwer HTTPS servéiert gëtt. E Reverse Proxy këmmert sech drëm.docker compose pull.Actual Budget ass e Local-first-Tool fir déi perséinlech Finanzen, an Node.js geschriwwen, dat säi README als komplett gratis an Open Source beschreift. Et hält all Är Donnéeën op jidderengem vun Ären Apparater a synchroniséiert se am Hannergrond mam Server, deen Dir gewielt hutt: d’App funktionéiert och ouni Verbindung, an Är Ännerunge kommen op Är aner Apparater, soubal d’Netz erëm do ass.
De Projet besteet aus engem Client an engem Server. De Server ass fakultativ, mä d’Dokumentatioun recommandéiert en dréngend, well en e puer Funktiounen opmécht:
| Funktioun | Ouni Server | Mat Server |
|---|---|---|
| Budgeten, Berichter, Zäitpläng | Jo | Jo |
| Transaktiounen aus engem Fichier importéieren | Jo | Jo |
| Budgetsfichieren importéieren an exportéieren | Jo | Jo |
| D’App an engem Browser an um Handy | Jo | |
| Synchronisatioun tëscht den Apparater | Jo | |
| Bankesynchronisatioun | Jo | |
| D’Actual-API | Jo |
Actual Budget gëtt ënner der MIT-Lizenz publizéiert, Copyright James Long. Den Text gëtt jidderengem, deen eng Kopie kritt, gratis d’Recht, se ze notzen, ze kopéieren, z’änneren, ze fusionéieren, ze publizéieren, ze verdeelen, ënnerzelizenzéieren a Kopien dovun ze verkafen.
Et gëtt eng eenzeg Bedingung: den Urheberrechtshiweis an den Text vun der Lizenz ginn mat alle Kopien oder wesentlechen Deeler vun der Software mat. Dir kënnt also d’Image, déi de Projet publizéiert, fir Iech, Är Famill oder Är Entreprise lafe loossen, ouni eng Lizenz ze kafen.
De Projet publizéiert de Server als Docker-Image, actualbudget/actual-server um Docker Hub, an déiselwecht Image an der Registry vu GitHub, ghcr.io/actualbudget/actual. Op engem Server, wou Docker installéiert ass, erstellt Dir en Dossier a leet dës compose.yaml dran of, aus dem Fichier geholl, deen am Repository geliwwert gëtt:
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 publizéiert, ass en nëmmen iwwer de Reverse Proxy z’erreechen, deen um selwechte Server steet an HTTPS derbäisetzt.actual-data hält alles, wat de Server behält. En erstellt do zwee Ënnerdossieren, server-files an user-files, an d’Dokumentatioun weist drop hin, datt dës Montage Är Donnéeën behält, wann de Container ewechgeholl gëtt.latest follegt der leschter offizieller Versioun, an d’Dokumentatioun recommandéiert en fir déi meescht Benotzer. latest-alpine gëtt déiselwecht Versioun op enger méi liichter Alpine-Basis, an en Tag wéi 26.11.0 fixéiert eng Versioun. D’Tags nightly verfollegen d’Entwécklung, mat all Ännerung vun hirer Haaptbranche.Äre Domainnumm weist mat A- an AAAA-Enregistremente op de Server, an d’Besucher kommen op de Ports 80 an 443 un. Soulaang HTTPS net op der Plaz ass, mécht d’App sech net op: gitt direkt an déi nächst Sektioun weider.
De Projet gëtt weder Aarbechtsspäicher nach Prozessor un. D’Gréisst hänkt vun der Zuel vun de Budgeten, hirer Geschicht an der Zuel vun den Apparater of, déi synchroniséieren. Op engem Managed VPS beschreift eis Äre Gebrauch, a mir recommandéieren Iech déi passend Gréisst.
Actual Budget baséiert op SharedArrayBuffer, enger Browsertechnologie, déi seng Dokumentatioun als obligatoresch beschreift: ouni si start d’App net. D’Browser aktivéieren se nëmmen op enger isoléierter Säit, wat zwou Bedingunge verlaangt:
localhost opgemaach gëtt.Cross-Origin-Embedder-Policy op require-corp an Cross-Origin-Opener-Policy op same-origin. Den offizielle Server setzt se ëmmer selwer.Fir Actual um Internet z’exposéieren, freet d’Dokumentatioun Iech, en hannert e Reverse Proxy mat HTTPS ze setzen. De Server kann HTTPS och selwer servéieren, mat engem Zertifikat, dat Dir him iwwer ACTUAL_HTTPS_KEY an ACTUAL_HTTPS_CERT gitt: d’Dokumentatioun beschreift dëse Wee fir e Server, deen net um Internet hänkt.
D’Dokumentatioun stellt Caddy als einfache Reverse Proxy duer, deen seng Zertifikater selwer kritt an erneiert. Hei ass hiert Beispill, ugepasst un e Caddy, deen um Server installéiert ass:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
Dëse Block follegt der Nginx-Konfiguratioun aus der Dokumentatioun, op de Port 80 reduzéiert, fir Certbot HTTPS ariichten ze loossen. E verstoppt déi zwee Header, déi Actual schéckt, a setzt se eng eenzeg Kéier nei: d’Dokumentatioun warnt, datt en duebelen Header d’Politik ongëlteg mécht, an d’App bleift dann um Feeler SharedArrayBufferMissing stoen.
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 hieft d’Gréisstelimit vun Nginx op, wéi am Beispill vun der Dokumentatioun, fir datt e grousse Budgetsfichier bis bei de Server kënnt. Certbot setzt duerno d’Zertifikat a këmmert sech drëms, et ze erneieren:
sudo certbot --nginx
Mécht Är Adress a https op, an engem neie Reiter amplaz eng Säit nei ze lueden, déi e Feeler ugewisen huet, wéi d’Dokumentatioun et rotet. De Begréissungsbildschierm vun Actual erschéngt: HTTPS an d’Header sinn op der Plaz.
Beim éischte Start freet de Begréissungsbildschierm Iech, e Passwuert fir de Server ze wielen: et schützt den Zougang zu Äre Budgeten. Soulaang keent gesat ass, erschéngt dëse Bildschierm bei där éischter Persoun, déi d’Adress opmécht. Mécht se also op, soubal HTTPS funktionéiert, a wielt e laangt Passwuert, dat Dir nëmme fir dëse Server notzt.
De Server hält dëst Passwuert gehasht, mat argon2, am Fichier account.sqlite vun server-files, zesumme mat der Lëscht vun de Budgetsfichieren, déi en kennt, an dem aktiven Sessiounstoken.
D’Dokumentatioun liwwert e Befehl, deen en neit Passwuert setzt, ouni Är Fichieren oder Donnéeën unzepaken. En freet zweemol dono:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD agestallt: password standardméisseg, openid fir en Identitéitsprovider, oder header.x-actual-password weiderginn. D’Dokumentatioun warnt, datt eng falsch Konfiguratioun an dësem Schrëtt d’Instanz dem ganzen Internet zougänglech maache kéint: behaalt se fir dës Servicer.ACTUAL_ALLOWED_LOGIN_METHODS limitéieren, enger Lëscht mat Kommaen.Fir eng méi robust Authentifiséierung wéi e Passwuert recommandéiert d’Dokumentatioun en OpenID-Provider: déi meescht vun hinne bidden d’Zwee-Faktor-Authentifiséierung un. Et ass och dat, wat de Server fir méi Benotzer opmécht. D’Konfiguratiounsreferenz stellt dës Method als Virschau duer.
https://budget.example.com/openid/callback.Déiselwecht Konfiguratioun kann och an config.json oder an Ëmfeldvariabele stoen, mat enger Discovery-URL, wann de Provider eng publizéiert:
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"
D’Geheimnis kënnt an e Fichier .env niewent der compose.yaml. Zënter der Versioun 26.10.0 kann ACTUAL_OPENID_CLIENT_SECRET_FILE et och aus engem Fichier liesen, wat zu den Docker-Secrets passt.
"authMethod": "oauth2", an config.json.ACTUAL_USER_CREATION_MODE op login erstellt se bei hirer éischter Umeldung.ACTUAL_OPENID_ENFORCE op true mécht et zur eenzeger akzeptéierter Umeldemethod.ACTUAL_TOKEN_EXPIRATION ass standardméisseg never. Si kann där vum Provider nogoen, mat openid-provider, oder enger Dauer a Sekonnen.Zousätzlech zum Serverpasswuert kann all Budget End-to-End verschlësselt ginn. Seng Donnéeë ginn dann op Ärem Apparat verschlësselt, mat engem Schlëssel, dee vun engem zweete Passwuert ofgeleet gëtt, ier se en verloossen: de Server gëtt just Ännerunge weider, déi en net liese kann.
D’Dokumentatioun ass kloer: e vergiessent Verschlësselungspasswuert léisst sech net erëmfannen. Wann nach eng lokal Kopie vum Budget existéiert, kënnt Dir en neie Schlëssel generéieren, wat d’Synchronisatioun zerécksetzt. D’Verschlësselung léisst sech och net ofschalten: de Wee zréck op en onverschlësselte Fichier geet iwwer en Export an duerno en Import.
| Schutz | Wat et bréngt | Wou et agestallt gëtt |
|---|---|---|
| HTTPS | Verschlësselt de Wee tëscht Ären Apparater an dem Server, a léisst d’App starten | De Reverse Proxy |
| Serverpasswuert | Limitéiert den Zougang zu de Budgeten, mat argon2 um Server gehasht | Beim éischte Start, dann an den Astellungen |
| OpenID | D’Zwee-Faktor-Authentifiséierung vun Ärem Provider, an ee Kont pro Persoun | Beim Provider, dann an den Astellungen |
| End-to-End-Verschlësselung | Mécht d’Budgete fir de Server a fir seng Backups onliesbar | An all Budget |
| Diskverschlësselung | Schützt déi lokal Kopie, déi laut der Dokumentatioun net verschlësselt ass | Op jidderengem vun Ären Apparater |
D’End-to-End-Verschlësselung deckt d’Donnéeë vun de Budgeten of. D’Zougäng fir d’Bankesynchronisatioun ginn um Server gehalen, an account.sqlite, ausserhalb vun dëser Verschlësselung: schützt den Zougang zum Server an zu senge Backups deementspriechend.
Actual importéiert Är Transaktiounen aus engem Fichier, ouni eppes anzeriichten. Et kann se och direkt vun Ärer Bank ofruffen, iwwer e Provider vu Bankdonnéeën. Dës Synchronisatioun ass fakultativ, brauch de Server a baséiert op Ären eegenen Zougäng: Dir maacht e Kont beim Provider op an erstellt do d’Schlësselen, déi Dir Actual gitt. Dës Schlëssele ginn um Server gehalen, an Dir gitt se nëmmen eemol an.
| Provider | Ofgedeckte Banken, laut der Dokumentatioun | Status an der Versioun 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Nordamerikanesch Banken | Ënnerstëtzt; Zougäng pro Budget zënter 26.11.0 méiglech |
| GoCardless Bank Account Data | Europäesch Banken | Ënnerstëtzt fir bestoend Konten: GoCardless hëlt zënter Juli 2025 keng nei Konte méi un |
| Pluggy.ai | Brasilianesch Banken | Ënnerstëtzt |
| Enable Banking | Europäesch Banken | Experimentell Funktioun |
| Akahu | Banken aus Neiséiland | Experimentell Funktioun |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS opgelëscht sinn. Ëffentlech SimpleFIN-Bréckë brauche keng Astellung.All Apparat hält eng komplett Kopie vun Äre Budgeten, an de Server hält eng aner. Eng gutt Backup deckt béid of: den Dossier fir d’Donnéeë vum Server, an en Export vun all Budget.
| Element | Wat et hält | Ze séchere |
|---|---|---|
server-files/account.sqlite | D’gehasht Passwuert, d’Lëscht vun de Budgeten, d’Sessiounen, d’OpenID-Konten an d’Bankzougäng | Obligatoresch, verschlësselt |
user-files/ | D’Budgetsfichieren, als binär Fichieren | Obligatoresch |
config.json | D’Konfiguratioun vum Server, wann Dir eng erstallt hutt | Recommandéiert, verschlësselt |
| Den Export vun all Budget | E Zip-Fichier mat der Datebank db.sqlite an metadata.json | Recommandéiert |
Alles, wat de Server hält, läit an actual-data. Bei gestoppte Server kann en an engem Coup kopéiert ginn, mat sengen SQLite-Datebanken a Rou:
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
Plangt dës Kopie um Server, verschlësselt se, a behaalt eng anzwousch anescht. Um Disk vum Server geluecht, kënnt si och an seng Backups vun der Nuecht.
Vun engem oppene Budget aus: Settings, Sektioun Data, Export data. De Fichier kann do behale ginn, wou Dir wëllt, a mécht sech ouni Server nei op. D’Dokumentatioun notzt dësen Export, fir vun engem verschlësselte Budget zréck op en onverschlësselte Fichier ze goen: en hält Är Donnéeën am Klartext, haalt en also op enger sécherer Plaz.
En alen Budget gëtt e groussen Export, well Actual all Ännerung am Fichier behält. D’Dokumentatioun rotet dann zu Reset sync, an den erweiderten Astellungen, ier Dir exportéiert: d’Geschicht gëtt an ee Fichier kompriméiert, an d’Gréisst geet däitlech erof.
Op Ären aneren Apparater wielt Dir duerno dëse Budget an der Lëscht vun de Fichieren: en gëtt erofgelueden, an dann synchroniséiert. D’Desktop-Appen halen och hir eege automatesch Backups, eng fir all eenzelen Dag vun de leschten zéng Deeg Benotzung, an e puer fir den aktuellen Dag.
D’Dokumentatioun gëtt de Befehl, aus dem Dossier vun der compose.yaml. Den Dossier fir d’Donnéeë bleift op senger Plaz:
docker compose pull
docker compose up -d
D’Versioune sinn no Joer a Mount nummeréiert: d’26.11.0 ass den 1. November 2026 erauskomm, an déi lescht Versioune goufen all Ufank vum Mount publizéiert. Liest hir Notizen, ier Dir aktualiséiert, an exportéiert Är Budgete just virdrun, wéi d’Dokumentatioun et recommandéiert. D’Notize weisen op d’Ännerungen hin, déi een amplange muss, wéi d’Lëscht vun den erlaabte SimpleFIN-Netzer an der 26.11.0, oder de Wiessel vun der Ubuntu-Image op Node.js 24 an der 26.9.0, deen d’32-Bit-ARM-Prozessoren zugonschte vun der Alpine-Image ewechgelooss huet.
nightly: vun nightly zréck op latest ze goen, kann e Budget fir déi stabil Versioun onliesbar maachen. D’Dokumentatioun beschreift d’Korrektur, a freet mat dësen Tags no Backups vun Äre Budgeten.Selwer hosten heescht, de Server zousätzlech zur Applikatioun ze halen. Op engem Managed VPS huelen eis Equippen de Server an d’Hand a verfollegen Är Instanz proaktiv; Actual Budget bleift Är Software, mat senge Astellungen an Äre Budgeten.
| Thema | Eis Equippen | Dir |
|---|---|---|
| De Server | System- a Sécherheetsupdates, Interventioune um Server abegraff | De Moment, deen zu Ärer Aktivitéit passt |
| D’Iwwerwaachung | Server 24 Stonnen op 24 a 7 Deeg op 7 verfollegt, mat Interventioun, ouni op Ären Uruff ze waarden | D’Lektür vun de Logbicher vun Ärer Instanz |
| Actual Budget | Proaktiv Suivi: Feeler, lues Äntwertzäiten a Späicherplaz erkannt, Korrektur recommandéiert | Seng Installatioun, seng Aktualiséierungen a seng Astellungen, déi Dir ëmsetzt, selwer oder mat Ärem KI-Assistent |
| D’Zougäng an d’Budgeten | De Server, deen se dréit, iwwerwaacht a gesécheert | D’Serverpasswuert, OpenID, d’Benotzer an d’End-to-End-Verschlësselung |
| D’Bankesynchronisatioun | De Server, deen hir Zougäng hält, iwwerwaacht a gesécheert | D’Wiel vum Provider, seng Schlësselen an déi verbonne Konten |
| D’Backups | All Nuecht, verschlësselt a baussent der Maschinn gelagert; Restauratioun abegraff | D’Exporter vun Äre Budgeten, an d’Ufro fir eng Restauratioun, wann Dir se braucht |
| D’Migratioun | Äre bestoende Server migréiert, offréiert | De Moment vum Wiessel |
Wann Dir léiwer wëllt, datt eis Equippen an der Applikatioun selwer intervenéieren, gëtt dës Prestatioun op Stonnebasis oder pauschal verrechent, mat engem Käschtevirschlag, deen Iech virun der Interventioun matgedeelt gëtt.
Mat engem Managed VPS vu Simafri halen eis Equippen de Server vun Ärer Actual-Budget-Instanz aktuell, iwwerwaachen en Dag an Nuecht a gräifen an, ouni op Ären Uruff ze waarden; si verfollegen och Är Instanz proaktiv a recommandéieren Iech déi nëtzlech Korrekturen, déi Dir ëmsetzt, selwer oder mat Ärem KI-Assistent. D’Backups ginn all Nuecht verschlësselt a baussent der Maschinn gelagert, hir Restauratioun ass abegraff, an d’Migratioun vun Ärem aktuelle Server ass offréiert.
Jo. Actual Budget ass ënner der MIT-Lizenz: Dir kënnt en fräi notzen, änneren an nei verdeelen, fir Iech oder fir eng Entreprise, soulaang säin Urheberrechts- a Lizenzhiweis an de Kopien bleift. Et bleiwen d’Käschte vum Server, deen en hält.
D’Desktop-Appe funktionéieren eleng. De Server, deen d’Dokumentatioun dréngend recommandéiert, bréngt d’Web- an d’Mobil-App, d’Synchronisatioun tëscht den Apparater, d’Bankesynchronisatioun an d’API derbäi. All Apparat hält eng komplett Kopie vun Äre Budgeten, mam Server synchroniséiert.
Erstellt eng compose.yaml mat der Image actualbudget/actual-server, dem Port 5006, deen op 127.0.0.1 publizéiert ass, an engem Dossier fir d’Donnéeën, deen op /data gemount ass, a lancéiert dann docker compose up -d. Setzt duerno e Reverse Proxy mat HTTPS dervir, a mécht Är Adress op, fir d’Serverpasswuert ze wielen.
D’App brauch SharedArrayBuffer, wat d’Browser nëmmen op enger Säit aktivéieren, déi iwwer HTTPS mat den Headeren Cross-Origin-Embedder-Policy an Cross-Origin-Opener-Policy servéiert gëtt. De Server setzt dës Header; de Reverse Proxy bréngt HTTPS. Nëmmen den Zougang iwwer localhost kënnt ouni aus.
Servéiert d’Instanz iwwer HTTPS, wielt e staarkt Serverpasswuert oder notzt OpenID mat Zwee-Faktor-Authentifiséierung, an aktivéiert d’End-to-End-Verschlësselung: de Server kann Är Budgeten dann net méi liesen. Haalt dat zweet Passwuert op enger sécherer Plaz, well et sech net erëmfanne léisst.
Jo, iwwer e Provider vu Bankdonnéeën, mat Ären eegenen Zougäng: SimpleFIN Bridge, GoCardless Bank Account Data fir bestoend Konten, Pluggy.ai, an Enable Banking an Akahu als experimentell Funktiounen. D’Synchronisatioun brauch de Server, a kann zënter der Versioun 26.11.0 automatesch lafen.
Kopéiert den Dossier fir d’Donnéeë vum Server bei gestoppte Server: server-files hält d’Konten an d’Zougäng, user-files d’Budgeten. Exportéiert och all Budget iwwer Settings, Export data, an haalt dës Kopien verschlësselt. En Export gëtt mat Import file restauréiert.
E Managed VPS deckt de Server of: System, Sécherheet, Iwwerwaachung a Backups. Eis Equippen verfollegen och Är Instanz proaktiv a recommandéieren Iech déi nëtzlech Korrekturen, déi Dir ëmsetzt. Eng Interventioun an der Applikatioun gëtt op Stonnebasis oder pauschal verrechent.
Simafri
Loosst eis iwwer Är Websäit schwätzen
Erzielt eis vun Ärem Projet a wéinege Wierder: mir mellen eis séier bei Iech.
Merci! Är Ufro gouf geschéckt. Mir mellen eis séier bei Iech.
Léiwer per E-Mail? Schreift eis op support@simafri.com.