Att hosta Actual Budget på en Managed VPS innebär att dina budgetar och deras synkronisering stannar på en egen maskin, som våra team håller uppdaterad och bevakar dag och natt. Actual Budget är ett verktyg för privatekonomi som bygger på lokal lagring först, utgivet under MIT-licensen. Den här guiden följer den officiella dokumentationen: serverns roll, installation med Docker Compose, HTTPS, serverlösenordet, OpenID, totalsträckskryptering, banksynkronisering, säkerhetskopior och uppdateringar.
Av Simon Vasconcelos Lee
Publicerad den 17 november 2026Lästid: 14 minuter
SharedArrayBuffer, som webbläsarna bara aktiverar på en sida som serveras med HTTPS. En omvänd proxy sköter det.docker compose pull.Actual Budget är ett verktyg för privatekonomi som bygger på lokal lagring först, skrivet i Node.js, och som README-filen beskriver som helt gratis och med öppen källkod. Det förvarar alla dina data på var och en av dina enheter och synkroniserar dem i bakgrunden med den server du har valt: appen fungerar även utan anslutning, och dina ändringar når dina andra enheter så snart nätverket är tillbaka.
Projektet består av en klient och en server. Servern är valfri, men dokumentationen rekommenderar den starkt, eftersom den låser upp flera funktioner:
| Funktion | Utan server | Med server |
|---|---|---|
| Budgetar, rapporter, scheman | Ja | Ja |
| Import av transaktioner från en fil | Ja | Ja |
| Import och export av budgetfiler | Ja | Ja |
| Appen i en webbläsare och i en telefon | Ja | |
| Synkronisering mellan enheter | Ja | |
| Banksynkronisering | Ja | |
| Actual-API:et | Ja |
Actual Budget ges ut under MIT-licensen, med upphovsrätt för James Long. Texten ger var och en som får en kopia, kostnadsfritt, rätt att använda, kopiera, ändra, slå samman, publicera, distribuera, underlicensiera och sälja kopior av den.
Det finns ett villkor: upphovsrättsmeddelandet och licenstexten följer med alla kopior eller väsentliga delar av programvaran. Du kan alltså köra avbilden som projektet publicerar för dig själv, din familj eller ditt företag, utan att köpa någon licens.
Projektet publicerar servern som en Docker-avbild, actualbudget/actual-server på Docker Hub, och samma avbild i GitHubs register, ghcr.io/actualbudget/actual. På en server där Docker är installerat skapar du en mapp och lägger denna compose.yaml i den, hämtad från filen i förrådet:
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 nås den bara via den omvända proxyn på samma server, som lägger till HTTPS.actual-data innehåller allt som servern förvarar. Den skapar två undermappar där, server-files och user-files, och dokumentationen påpekar att den här monteringen bevarar dina data när containern tas bort.latest följer den senaste officiella versionen, och dokumentationen rekommenderar den för de flesta användare. latest-alpine ger samma version på en lättare Alpine-bas, och en tagg som 26.11.0 låser en version. Taggarna nightly följer utvecklingen, med varje ändring i dess huvudgren.Ditt domännamn pekar mot servern med A- och AAAA-poster, och besökarna kommer in på port 80 och 443. Så länge HTTPS inte är på plats öppnas inte appen: gå direkt till nästa avsnitt.
Projektet anger inga siffror för minne eller processor. Storleken beror på antalet budgetar, deras historik och antalet enheter som synkroniserar. På en Managed VPS beskriver du hur du tänker använda den, så rekommenderar vi lämplig storlek.
Actual Budget bygger på SharedArrayBuffer, en webbläsarteknik som dess dokumentation beskriver som obligatorisk: utan den startar inte appen. Webbläsarna aktiverar den bara på en isolerad sida, vilket kräver två villkor:
localhost.Cross-Origin-Embedder-Policy satt till require-corp och Cross-Origin-Opener-Policy satt till same-origin. Den officiella servern sätter dem alltid själv.För att exponera Actual mot internet ber dokumentationen dig att placera den bakom en omvänd proxy med HTTPS. Servern kan också själv servera HTTPS med ett certifikat som du ger den, via ACTUAL_HTTPS_KEY och ACTUAL_HTTPS_CERT: dokumentationen beskriver den vägen för en server som hålls utanför internet.
Dokumentationen presenterar Caddy som en enkel omvänd proxy, som hämtar och förnyar sina certifikat på egen hand. Här är dess exempel, anpassat till Caddy installerad på servern:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
Det här blocket följer dokumentationens Nginx-konfiguration, begränsat till port 80 så att Certbot kan installera HTTPS. Det döljer de två huvuden som Actual skickar och sätter dem igen, en gång: dokumentationen varnar för att ett dubblerat huvud gör policyn ogiltig, och appen stannar då på felet 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 tar bort Nginx storleksgräns, som i dokumentationens exempel, så att en stor budgetfil når fram till servern. Certbot installerar sedan certifikatet och sköter förnyelsen:
sudo certbot --nginx
Öppna din adress med https, i en ny flik i stället för att ladda om en sida som visade ett fel, som dokumentationen råder. Actuals välkomstskärm visas: HTTPS och huvudena är på plats.
Vid den första starten ber välkomstskärmen dig att välja ett lösenord för servern: det är det som skyddar åtkomsten till dina budgetar. Så länge inget är valt visas skärmen för den första person som öppnar adressen. Öppna den därför så snart HTTPS fungerar, och välj ett långt lösenord som bara används för den här servern.
Servern förvarar lösenordet hashat, med argon2, i filen account.sqlite i server-files, tillsammans med listan över de budgetfiler den känner till och den aktiva sessionstoken.
Dokumentationen tillhandahåller ett kommando som sätter ett nytt lösenord utan att röra dina filer eller data. Det frågar efter lösenordet två gånger:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: password som standard, openid för en identitetsleverantör, eller header.x-actual-password. Dokumentationen varnar för att en felkonfiguration i det steget kan göra instansen tillgänglig för hela internet: reservera den för de tjänsterna.ACTUAL_ALLOWED_LOGIN_METHODS, en lista åtskild med kommatecken.För en autentisering som är robustare än ett lösenord rekommenderar dokumentationen en OpenID-leverantör: de flesta erbjuder tvåfaktorsautentisering. Det är också det som öppnar servern för flera användare. Konfigurationsreferensen presenterar metoden som en förhandsversion.
https://budget.example.com/openid/callback.Samma konfiguration kan också läggas i config.json eller i miljövariabler, med en upptäckts-URL när leverantören publicerar 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"
Hemligheten läggs i en fil .env bredvid compose.yaml. Sedan version 26.10.0 kan ACTUAL_OPENID_CLIENT_SECRET_FILE också läsa den från en fil, vilket passar Docker-hemligheter.
"authMethod": "oauth2", i config.json.ACTUAL_USER_CREATION_MODE satt till login skapar dem vid deras första inloggning.ACTUAL_OPENID_ENFORCE satt till true gör det till den enda godtagna inloggningsmetoden.ACTUAL_TOKEN_EXPIRATION är never som standard. Den kan följa leverantörens, med openid-provider, eller en längd i sekunder.Utöver serverlösenordet kan varje budget krypteras från ände till ände. Dess data krypteras då på din enhet, med en nyckel som härleds ur ett andra lösenord, innan de lämnar den: servern förmedlar bara ändringar som den inte kan läsa.
Dokumentationen är tydlig: ett bortglömt krypteringslösenord går inte att få tillbaka. Om en lokal kopia av budgeten fortfarande finns kan du generera en ny nyckel, vilket nollställer synkroniseringen. Krypteringen går inte heller att stänga av: att gå tillbaka till en okrypterad fil sker via en export och sedan en import.
| Skydd | Vad det ger | Var det ställs in |
|---|---|---|
| HTTPS | Krypterar vägen mellan dina enheter och servern, och låter appen starta | Den omvända proxyn |
| Serverlösenord | Begränsar åtkomsten till budgetarna, hashat med argon2 på servern | Vid den första starten, sedan i inställningarna |
| OpenID | Din leverantörs tvåfaktorsautentisering, och ett konto per person | Hos leverantören, sedan i inställningarna |
| Totalsträckskryptering | Gör budgetarna oläsliga för servern och för dess säkerhetskopior | I varje budget |
| Diskkryptering | Skyddar den lokala kopian, som dokumentationen påpekar är okrypterad | På var och en av dina enheter |
Totalsträckskrypteringen omfattar budgetdata. Inloggningsuppgifterna för banksynkroniseringen förvaras på servern, i account.sqlite, utanför den krypteringen: skydda åtkomsten till servern och till dess säkerhetskopior därefter.
Actual importerar dina transaktioner från en fil, utan någon inställning. Det kan också hämta dem direkt från din bank, via en leverantör av bankdata. Den här synkroniseringen är valfri, kräver servern och bygger på dina egna uppgifter: du öppnar ett konto hos leverantören och skapar där de nycklar som du ger till Actual. Nycklarna förvaras på servern, och du anger dem bara en gång.
| Leverantör | Banker som täcks, enligt dokumentationen | Status i version 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Nordamerikanska banker | Stöds; uppgifter per budget möjliga sedan 26.11.0 |
| GoCardless Bank Account Data | Europeiska banker | Stöds för befintliga konton: GoCardless har inte tagit emot nya konton sedan juli 2025 |
| Pluggy.ai | Brasilianska banker | Stöds |
| Enable Banking | Europeiska banker | Experimentell funktion |
| Akahu | Nyzeeländska banker | Experimentell funktion |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. Publika SimpleFIN-bryggor kräver ingen inställning.Varje enhet har en fullständig kopia av dina budgetar, och servern har en till. En bra säkerhetskopiering täcker båda: serverns datamapp och en export av varje budget.
| Del | Vad den innehåller | Att säkerhetskopiera |
|---|---|---|
server-files/account.sqlite | Det hashade lösenordet, listan över budgetar, sessioner, OpenID-konton och bankuppgifter | Obligatoriskt, krypterad |
user-files/ | Budgetfilerna, som binärfiler | Obligatoriskt |
config.json | Serverns konfiguration, om du har skapat en | Rekommenderas, krypterad |
| Exporten av varje budget | En zip-fil med databasen db.sqlite och metadata.json | Rekommenderas |
Allt som servern förvarar finns i actual-data. Med servern stoppad kan den kopieras i ett svep, med SQLite-databaserna i vila:
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
Schemalägg den här kopian på servern, kryptera den och behåll en på annat håll. Lagd på serverns disk ingår den också i dess nattliga säkerhetskopior.
Från en öppen budget: Settings, avsnittet Data, Export data. Filen kan förvaras var du vill och öppnas igen utan server. Dokumentationen använder den exporten för att gå tillbaka från en krypterad budget till en okrypterad fil: den innehåller dina data i klartext, så förvara den på ett säkert ställe.
En gammal budget ger en stor export, eftersom Actual sparar varje ändring i filen. Dokumentationen råder då till Reset sync, i de avancerade inställningarna, före exporten: historiken komprimeras till en enda fil, och storleken minskar kraftigt.
På dina andra enheter väljer du sedan den här budgeten i fillistan: den laddas ned och synkroniseras sedan. Datorapparna behåller också sina egna automatiska säkerhetskopior, en för var och en av de tio senaste användningsdagarna, och flera för den aktuella dagen.
Dokumentationen anger kommandot, från mappen med compose.yaml. Datamappen ligger kvar:
docker compose pull
docker compose up -d
Versionerna numreras efter år och månad: 26.11.0 kom ut den 1 november 2026, och de senaste versionerna har publicerats i början av varje månad. Läs deras anteckningar innan du uppdaterar, och exportera dina budgetar strax innan, som dokumentationen rekommenderar. Anteckningarna pekar ut de ändringar som behöver planeras, som listan över tillåtna SimpleFIN-nätverk i 26.11.0, eller Ubuntu-avbildens övergång till Node.js 24 i 26.9.0, som tog bort den från 32-bitars ARM-processorer till förmån för Alpine-avbilden.
nightly: att gå tillbaka från nightly till latest kan göra en budget oläslig för den stabila versionen. Dokumentationen beskriver lösningen och ber om säkerhetskopior av dina budgetar med de taggarna.Att självhosta innebär att sköta servern utöver applikationen. På en Managed VPS tar våra team hand om servern och följer din instans proaktivt; Actual Budget förblir din programvara, med sina inställningar och dina budgetar.
| Område | Våra team | Du |
|---|---|---|
| Servern | Uppdateringar av system och säkerhet, ingrepp på servern inräknade | Tidpunkten som passar din verksamhet |
| Övervakningen | Servern följs dygnet runt, alla dagar, med ingrepp utan att vänta på ditt samtal | Läsningen av din instans loggar |
| Actual Budget | Proaktiv uppföljning: fel, långsamma svarstider och diskutrymme upptäcks, med rekommenderad rättelse | Installationen, uppdateringarna och inställningarna, som du genomför själv eller med din AI-assistent |
| Åtkomsten och budgetarna | Servern som bär dem, övervakad och säkerhetskopierad | Serverlösenordet, OpenID, användarna och totalsträckskrypteringen |
| Banksynkroniseringen | Servern som förvarar dess uppgifter, övervakad och säkerhetskopierad | Valet av leverantör, dess nycklar och de kopplade kontona |
| Säkerhetskopiorna | Varje natt, krypterade och förvarade utanför maskinen; återställning ingår | Exporterna av dina budgetar och begäran om återställning, när du behöver den |
| Migreringen | Din nuvarande server migreras kostnadsfritt | Tidpunkten för bytet |
Om du föredrar att våra team ingriper i själva applikationen faktureras den tjänsten per timme eller som fast pris, med en offert som lämnas före ingreppet.
Med en Managed VPS från Simafri håller våra team servern för din Actual Budget-instans uppdaterad, övervakar den dag och natt och griper in utan att vänta på ditt samtal; de följer också din instans proaktivt och rekommenderar de rättelser som är till nytta, som du genomför själv eller med din AI-assistent. Säkerhetskopiorna krypteras varje natt och förvaras utanför maskinen, återställningen ingår, och migreringen av din nuvarande server är kostnadsfri.
Ja. Actual Budget ges ut under MIT-licensen: du kan använda, ändra och vidaredistribuera det fritt, för dig själv eller för ett företag, så länge dess upphovsrätts- och licensmeddelande finns kvar i kopiorna. Kvar blir kostnaden för servern som kör det.
Datorapparna fungerar på egen hand. Servern, som dokumentationen rekommenderar starkt, lägger till webb- och mobilappen, synkronisering mellan enheter, banksynkronisering och API:et. Varje enhet har en fullständig kopia av dina budgetar, synkroniserad med servern.
Skapa en compose.yaml med avbilden actualbudget/actual-server, port 5006 publicerad på 127.0.0.1 och en datamapp monterad på /data, och kör sedan docker compose up -d. Sätt därefter en omvänd proxy med HTTPS framför, och öppna din adress för att välja serverlösenordet.
Appen behöver SharedArrayBuffer, som webbläsarna bara aktiverar på en sida som serveras med HTTPS och med huvudena Cross-Origin-Embedder-Policy och Cross-Origin-Opener-Policy. Servern sätter huvudena; den omvända proxyn står för HTTPS. Bara åtkomst via localhost klarar sig utan.
Servera instansen med HTTPS, välj ett starkt serverlösenord eller använd OpenID med tvåfaktorsautentisering, och slå på totalsträckskrypteringen: servern kan då inte längre läsa dina budgetar. Förvara det andra lösenordet på ett säkert ställe, eftersom det inte går att få tillbaka.
Ja, via en leverantör av bankdata, med dina egna uppgifter: SimpleFIN Bridge, GoCardless Bank Account Data för befintliga konton, Pluggy.ai, samt Enable Banking och Akahu som experimentella funktioner. Synkroniseringen kräver servern och kan köras automatiskt sedan version 26.11.0.
Kopiera serverns datamapp med servern stoppad: server-files innehåller kontona och uppgifterna, user-files budgetarna. Exportera också varje budget från Settings, Export data, och förvara kopiorna krypterade. En export återställs med Import file.
En Managed VPS täcker servern: system, säkerhet, övervakning och säkerhetskopior. Våra team följer också din instans proaktivt och rekommenderar de rättelser som är till nytta, som du genomför själv. Ett ingrepp i själva applikationen faktureras per timme eller som fast pris.
Simafri
Låt oss prata om din webbplats
Berätta om ditt projekt med några ord: vi återkommer snabbt.
Tack! Din förfrågan har skickats. Vi återkommer till dig inom kort.
Föredrar du e-post? Skriv till oss på support@simafri.com.