At hoste Actual Budget på en Managed VPS betyder, at dine budgetter og deres synkronisering bliver på en maskine, der er din egen, og som vores teams holder opdateret og overvåger dag og nat. Actual Budget er et local-first-værktøj til privatøkonomi, udgivet under MIT-licensen. Denne guide følger den officielle dokumentation: serverens rolle, installation med Docker Compose, HTTPS, serveradgangskoden, OpenID, end-to-end-kryptering, banksynkronisering, backup og opdateringer.
Af Simon Vasconcelos Lee
Udgivet den 17. november 2026Læsetid: 14 minutter
SharedArrayBuffer, som browserne kun slår til på en side, der serveres over HTTPS. En reverse proxy klarer det.docker compose pull.Actual Budget er et local-first-værktøj til privatøkonomi, skrevet i Node.js, som dens README beskriver som helt gratis og med åben kildekode. Det opbevarer alle dine data på hver af dine enheder og synkroniserer dem i baggrunden med den server, du har valgt: appen virker også uden forbindelse, og dine ændringer når dine andre enheder, så snart netværket er tilbage.
Projektet består af en klient og en server. Serveren er valgfri, men dokumentationen anbefaler den kraftigt, da den åbner for flere funktioner:
| Funktion | Uden server | Med server |
|---|---|---|
| Budgetter, rapporter, planlagte transaktioner | Ja | Ja |
| Import af transaktioner fra en fil | Ja | Ja |
| Import og eksport af budgetfiler | Ja | Ja |
| Appen i en browser og på en telefon | Ja | |
| Synkronisering mellem enheder | Ja | |
| Banksynkronisering | Ja | |
| Actual-API'et | Ja |
Actual Budget udgives under MIT-licensen, copyright James Long. Teksten giver enhver, der får en kopi, gratis ret til at bruge, kopiere, ændre, sammenflette, udgive, distribuere, underlicensere og sælge kopier af den.
Der er én betingelse: copyrightmeddelelsen og licensteksten følger med alle kopier eller væsentlige dele af softwaren. Du kan altså køre det image, projektet udgiver, til dig selv, din familie eller din virksomhed uden at skulle købe en licens.
Projektet udgiver serveren som et Docker-image, actualbudget/actual-server på Docker Hub, og det samme image i GitHubs registry, ghcr.io/actualbudget/actual. På en server, hvor Docker er installeret, opretter du en mappe og lægger denne compose.yaml i den, hentet fra den fil, repositoryet leverer:
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 kan den kun nås via reverse proxyen på samme server, som tilføjer HTTPS.actual-data rummer alt, hvad serveren gemmer. Den opretter to undermapper der, server-files og user-files, og dokumentationen påpeger, at denne montering bevarer dine data, når containeren fjernes.latest følger den seneste officielle version, og dokumentationen anbefaler det til de fleste brugere. latest-alpine giver samme version på en lettere Alpine-base, og et tag som 26.11.0 fastlåser en version. Tags af typen nightly følger udviklingen med hver ændring i dens hovedgren.Dit domænenavn peger på serveren med A- og AAAA-records, og de besøgende kommer ind på port 80 og 443. Så længe HTTPS ikke er på plads, åbner appen ikke: gå direkte videre til næste afsnit.
Projektet opgiver ingen tal for hukommelse eller CPU. Størrelsen afhænger af antallet af budgetter, deres historik og antallet af enheder, der synkroniserer. På en Managed VPS beskriver du blot din brug for os, og vi anbefaler den størrelse, der passer.
Actual Budget bygger på SharedArrayBuffer, en browserteknologi, som dens dokumentation beskriver som påkrævet: uden den starter appen ikke. Browserne slår den kun til på en isoleret side, hvilket kræver to betingelser:
localhost.Cross-Origin-Embedder-Policy sat til require-corp og Cross-Origin-Opener-Policy sat til same-origin. Den officielle server sætter dem altid selv.For at gøre Actual tilgængelig på internettet beder dokumentationen dig om at placere den bag en reverse proxy med HTTPS. Serveren kan også selv servere HTTPS med et certifikat, du giver den, via ACTUAL_HTTPS_KEY og ACTUAL_HTTPS_CERT: dokumentationen beskriver denne vej til en server, der holdes væk fra internettet.
Dokumentationen præsenterer Caddy som en nem reverse proxy, der selv henter og fornyer sine certifikater. Her er dens eksempel, tilpasset til Caddy installeret på serveren:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
Denne blok følger dokumentationens Nginx-konfiguration, begrænset til port 80, så Certbot kan sætte HTTPS op. Den skjuler de to headere, Actual sender, og sætter dem igen, én gang: dokumentationen advarer om, at en dobbelt header gør politikken ugyldig, og appen stopper så med fejlen 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 ophæver Nginx' størrelsesgrænse, som i dokumentationens eksempel, så en stor budgetfil kan komme igennem til serveren. Certbot installerer derefter certifikatet og sørger for at forny det:
sudo certbot --nginx
Åbn din adresse over https i en ny fane frem for ved at genindlæse en side, der viste en fejl, som dokumentationen råder til. Actuals velkomstskærm vises: HTTPS og headerne er på plads.
Ved første start beder velkomstskærmen dig om at vælge en adgangskode til serveren: det er den, der beskytter adgangen til dine budgetter. Så længe der ikke er valgt nogen, vises denne skærm for den første, der åbner adressen. Åbn den derfor, så snart HTTPS virker, og vælg en lang adgangskode, der kun bruges til denne server.
Serveren gemmer denne adgangskode hashet med argon2 i filen account.sqlite i server-files sammen med listen over de budgetfiler, den kender, og det aktive sessionstoken.
Dokumentationen leverer en kommando, der angiver en ny adgangskode uden at røre dine filer eller data. Den spørger efter den to gange:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: password som standard, openid for en identitetsudbyder eller header.x-actual-password. Dokumentationen advarer om, at en fejlkonfiguration på dette trin kan gøre instansen tilgængelig for hele internettet: forbehold den disse tjenester.ACTUAL_ALLOWED_LOGIN_METHODS, en kommasepareret liste.For en godkendelse, der er mere robust end en adgangskode, anbefaler dokumentationen en OpenID-udbyder: de fleste tilbyder tofaktorgodkendelse. Det er også den, der åbner serveren for flere brugere. Konfigurationsreferencen præsenterer denne metode som en forhåndsversion.
https://budget.example.com/openid/callback.Den samme konfiguration kan også lægges i config.json eller i miljøvariabler, med en discovery-URL, når udbyderen udgiver en:
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"
Hemmeligheden lægges i en fil .env ved siden af compose.yaml. Siden version 26.10.0 kan ACTUAL_OPENID_CLIENT_SECRET_FILE også læse den fra en fil, hvilket passer til Docker-secrets.
"authMethod": "oauth2" i config.json.ACTUAL_USER_CREATION_MODE sat til login opretter brugerne ved deres første login.ACTUAL_OPENID_ENFORCE sat til true gør den til den eneste accepterede loginmetode.ACTUAL_TOKEN_EXPIRATION er never som standard. Den kan følge udbyderens med openid-provider eller en varighed i sekunder.Ud over serveradgangskoden kan hvert budget krypteres end-to-end. Dets data krypteres så på din enhed med en nøgle, der er afledt af en anden adgangskode, før de sendes: serveren videregiver kun ændringer, den ikke kan læse.
Dokumentationen er klar: en glemt krypteringsadgangskode kan ikke genskabes. Hvis der stadig findes en lokal kopi af budgettet, kan du generere en ny nøgle, hvilket nulstiller synkroniseringen. Krypteringen kan heller ikke slås fra: for at vende tilbage til en ukrypteret fil går man via en eksport og derefter en import.
| Beskyttelse | Hvad den giver | Hvor den indstilles |
|---|---|---|
| HTTPS | Krypterer vejen mellem dine enheder og serveren og lader appen starte | Reverse proxyen |
| Serveradgangskode | Begrænser adgangen til budgetterne, hashet med argon2 på serveren | Ved første start og derefter i indstillingerne |
| OpenID | Din udbyders tofaktorgodkendelse og én konto pr. person | Hos udbyderen og derefter i indstillingerne |
| End-to-end-kryptering | Gør budgetterne ulæselige for serveren og for dens backups | I hvert budget |
| Diskkryptering | Beskytter den lokale kopi, som dokumentationen bemærker er ukrypteret | På hver af dine enheder |
End-to-end-krypteringen dækker budgetternes data. Adgangsoplysningerne til banksynkronisering opbevares på serveren i account.sqlite, uden for denne kryptering: beskyt adgangen til serveren og til dens backups i overensstemmelse hermed.
Actual importerer dine transaktioner fra en fil uden nogen opsætning. Den kan også hente dem direkte fra din bank via en udbyder af bankdata. Denne synkronisering er valgfri, kræver serveren og bygger på dine egne adgangsoplysninger: du opretter en konto hos udbyderen og opretter der de nøgler, du giver Actual. Disse nøgler opbevares på serveren, og du indtaster dem kun én gang.
| Udbyder | Dækkede banker ifølge dokumentationen | Status i version 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Nordamerikanske banker | Understøttet; adgangsoplysninger pr. budget mulige siden 26.11.0 |
| GoCardless Bank Account Data | Europæiske banker | Understøttet for eksisterende konti: GoCardless har ikke taget imod nye konti siden juli 2025 |
| Pluggy.ai | Brasilianske banker | Understøttet |
| Enable Banking | Europæiske banker | Eksperimentel funktion |
| Akahu | New Zealandske banker | Eksperimentel funktion |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. Offentlige SimpleFIN-broer kræver ingen indstilling.Hver enhed har en fuld kopi af dine budgetter, og serveren har en anden. En god backup dækker begge: serverens datamappe og en eksport af hvert budget.
| Element | Hvad det rummer | Skal der tages backup |
|---|---|---|
server-files/account.sqlite | Den hashede adgangskode, listen over budgetter, sessioner, OpenID-konti og bankadgangsoplysninger | Obligatorisk, krypteret |
user-files/ | Budgetfilerne som binære filer | Obligatorisk |
config.json | Serverens konfiguration, hvis du har oprettet en | Anbefalet, krypteret |
| Eksporten af hvert budget | En zip-fil med databasen db.sqlite og metadata.json | Anbefalet |
Alt, hvad serveren gemmer, ligger i actual-data. Med serveren stoppet kan den kopieres i ét hug, med SQLite-databaserne i hvile:
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
Planlæg denne kopi på serveren, kryptér den, og opbevar en et andet sted. Lagt på serverens disk indgår den også i dens natlige backup.
Fra et åbent budget: Settings, afsnittet Data, Export data. Filen kan opbevares, hvor du vil, og åbnes igen uden server. Dokumentationen bruger denne eksport til at gå fra et krypteret budget tilbage til en ukrypteret fil: den rummer dine data i klartekst, så opbevar den et sikkert sted.
Et gammelt budget giver en stor eksport, fordi Actual gemmer hver ændring i filen. Dokumentationen råder så til Reset sync i de avancerede indstillinger før eksporten: historikken komprimeres til én fil, og størrelsen falder markant.
På dine andre enheder vælger du derefter dette budget i fillisten: det hentes og synkroniseres derefter. Skrivebordsappene har også deres egne automatiske backups, én for hver af de sidste ti brugsdage og flere for den aktuelle dag.
Dokumentationen giver kommandoen, fra mappen med compose.yaml. Datamappen bliver, hvor den er:
docker compose pull
docker compose up -d
Versionerne nummereres efter år og måned: 26.11.0 udkom den 1. november 2026, og de seneste versioner er udgivet i begyndelsen af hver måned. Læs deres noter før opdateringen, og eksportér dine budgetter lige før, som dokumentationen anbefaler. Noterne gør opmærksom på de ændringer, du skal forberede dig på, som listen over tilladte SimpleFIN-netværk i 26.11.0 eller Ubuntu-imagets overgang til Node.js 24 i 26.9.0, som fjernede det fra 32-bit ARM-processorer til fordel for Alpine-imaget.
nightly: at gå tilbage fra nightly til latest kan efterlade et budget ulæseligt for den stabile version. Dokumentationen beskriver løsningen og beder om backup af dine budgetter med disse tags.Selvhosting kræver, at du holder serveren ud over selve applikationen. På en Managed VPS tager vores teams sig af serveren og følger din instans proaktivt; Actual Budget forbliver din software, med dens indstillinger og dine budgetter.
| Emne | Vores teams | Dig |
|---|---|---|
| Serveren | Opdateringer af system og sikkerhed, indgreb på serveren inkluderet | Det tidspunkt, der passer til din drift |
| Overvågningen | Serveren følges døgnet rundt, alle ugens dage, med indgreb uden at vente på dit opkald | Gennemlæsning af din instans' logfiler |
| Actual Budget | Proaktiv opfølgning: fejl, langsomme svartider og diskplads opdages, og en rettelse anbefales | Installation, opdateringer og indstillinger, som du gennemfører, selv eller med din AI-assistent |
| Adgange og budgetter | Den server, der bærer dem, overvåget og sikkerhedskopieret | Serveradgangskoden, OpenID, brugerne og end-to-end-krypteringen |
| Banksynkronisering | Den server, der opbevarer adgangsoplysningerne, overvåget og sikkerhedskopieret | Valget af udbyder, dens nøgler og de forbundne konti |
| Backup | Hver nat, krypteret og opbevaret uden for maskinen; gendannelse inkluderet | Eksporterne af dine budgetter og anmodningen om gendannelse, når du får brug for den |
| Migreringen | Din nuværende server flyttes, uden beregning | Tidspunktet for omlægningen |
Hvis du foretrækker, at vores teams griber ind i selve applikationen, faktureres den ydelse pr. time eller som fast pris, med et overslag oplyst før indgrebet.
Med en Managed VPS fra Simafri holder vores teams serveren bag din Actual Budget-instans opdateret, overvåger den dag og nat og griber ind uden at vente på dit opkald; de følger også din instans proaktivt og anbefaler dig de nyttige rettelser, som du gennemfører, selv eller med din AI-assistent. Backup krypteres hver nat og opbevares uden for maskinen, gendannelsen er inkluderet, og migreringen af din nuværende server sker uden beregning.
Ja. Actual Budget udgives under MIT-licensen: du kan bruge, ændre og videredistribuere det frit, til dig selv eller til en virksomhed, så længe dets copyright- og licensmeddelelse følger med i kopierne. Tilbage er udgiften til den server, der kører det.
Skrivebordsappene virker alene. Serveren, som dokumentationen anbefaler kraftigt, tilføjer web- og mobilappen, synkronisering mellem enheder, banksynkronisering og API'et. Hver enhed har en fuld kopi af dine budgetter, synkroniseret med serveren.
Opret en compose.yaml med imaget actualbudget/actual-server, port 5006 publiceret på 127.0.0.1 og en datamappe monteret på /data, og kør derefter docker compose up -d. Sæt så en reverse proxy med HTTPS foran, og åbn din adresse for at vælge serveradgangskoden.
Appen har brug for SharedArrayBuffer, som browserne kun slår til på en side, der serveres over HTTPS med headerne Cross-Origin-Embedder-Policy og Cross-Origin-Opener-Policy. Serveren sætter disse headere; reverse proxyen leverer HTTPS. Kun adgang via localhost klarer sig uden.
Server instansen over HTTPS, vælg en stærk serveradgangskode eller brug OpenID med tofaktorgodkendelse, og slå end-to-end-kryptering til: serveren kan så ikke længere læse dine budgetter. Opbevar den anden adgangskode et sikkert sted, da den ikke kan genskabes.
Ja, via en udbyder af bankdata med dine egne adgangsoplysninger: SimpleFIN Bridge, GoCardless Bank Account Data for eksisterende konti, Pluggy.ai samt Enable Banking og Akahu som eksperimentelle funktioner. Synkroniseringen kræver serveren og kan køre automatisk siden version 26.11.0.
Kopiér serverens datamappe med serveren stoppet: server-files rummer konti og adgangsoplysninger, user-files budgetterne. Eksportér også hvert budget fra Settings, Export data, og opbevar disse kopier krypteret. En eksport gendannes med Import file.
En Managed VPS dækker serveren: system, sikkerhed, overvågning og backup. Vores teams følger også din instans proaktivt og anbefaler dig de nyttige rettelser, som du gennemfører. Et indgreb i selve applikationen faktureres pr. time eller som fast pris.
Simafri
Lad os tale om din hjemmeside
Fortæl os om dit projekt med få ord: vi vender hurtigt tilbage til dig.
Tak! Din forespørgsel er sendt. Vi vender tilbage til dig hurtigst muligt.
Foretrækker du e-mail? Skriv til os på support@simafri.com.