Actual Budget hosten op een Managed VPS: uw budgetten op uw eigen server

Actual Budget hosten op een Managed VPS betekent dat uw budgetten en hun synchronisatie op een machine blijven die van u is, en die ons team bijwerkt en dag en nacht in de gaten houdt. Actual Budget is een local-first hulpmiddel voor persoonlijke financiën, gepubliceerd onder de MIT-licentie. Deze gids volgt de officiële documentatie: de rol van de server, de installatie met Docker Compose, HTTPS, het serverwachtwoord, OpenID, end-to-endversleuteling, de banksynchronisatie, back-ups en updates.

Simon Vasconcelos Lee Door Gepubliceerd op 17 november 2026Leestijd: 14 minuten

Alle gidsen

In het kort

  1. Dankzij de MIT-licentie gebruikt, wijzigt en verspreidt u Actual Budget vrij, op voorwaarde dat de copyright- en licentievermelding in de kopieën blijft.
  2. De server synchroniseert uw budgetten tussen uw apparaten en biedt de webapp aan: installeer hem met Docker Compose, één image en een gegevensmap.
  3. HTTPS is onmisbaar: de app heeft SharedArrayBuffer nodig, dat browsers alleen inschakelen op een pagina die via HTTPS wordt aangeboden. Een reverse proxy zorgt daarvoor.
  4. Open uw adres zodra de server voor het eerst start, om het serverwachtwoord te kiezen. OpenID voegt de tweestapsverificatie van uw provider en meerdere gebruikers toe.
  5. De optionele end-to-endversleuteling maakt uw budgetten onleesbaar voor de server. Maak een back-up van de gegevensmap en exporteer uw budgetten, en werk daarna bij met docker compose pull.

Wat Actual Budget doet, en de rol van zijn server

Actual Budget is een local-first hulpmiddel voor persoonlijke financiën, geschreven in Node.js, dat de README omschrijft als volledig gratis en opensource. Het bewaart al uw gegevens op elk van uw apparaten en synchroniseert ze op de achtergrond met de server die u hebt gekozen: de app werkt ook zonder verbinding, en uw wijzigingen bereiken uw andere apparaten zodra het netwerk terug is.

Het project bestaat uit een client en een server. De server is optioneel, maar de documentatie raadt hem sterk aan, want hij ontgrendelt verschillende functies:

FunctieZonder serverMet server
Budgetten, rapporten, planningenJaJa
Transacties importeren uit een bestandJaJa
Budgetbestanden importeren en exporterenJaJa
De app in een browser en op een telefoonJa
Synchronisatie tussen apparatenJa
BanksynchronisatieJa
De API van ActualJa

Wat de MIT-licentie toestaat

Actual Budget wordt gepubliceerd onder de MIT-licentie, copyright James Long. De tekst kent iedereen die een kopie verkrijgt kosteloos het recht toe om er kopieën van te gebruiken, te kopiëren, te wijzigen, samen te voegen, te publiceren, te verspreiden, in sublicentie te geven en te verkopen.

Er is één voorwaarde: de copyrightvermelding en de tekst van de licentie gaan mee met alle kopieën of wezenlijke delen van de software. U kunt de image die het project publiceert dus draaien voor uzelf, uw gezin of uw bedrijf, zonder een licentie te kopen.

De installatie met Docker Compose

Het project publiceert de server als Docker-image, actualbudget/actual-server op Docker Hub, en dezelfde image in het register van GitHub, ghcr.io/actualbudget/actual. Maak op een server waar Docker is geïnstalleerd een map aan en plaats daarin dit compose.yaml, overgenomen uit het bestand in de 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
Terminal
docker compose up -d

Uw domeinnaam wijst met A- en AAAA-records naar de server, en de bezoekers komen binnen op de poorten 80 en 443. Zolang HTTPS er niet staat, opent de app niet: ga rechtstreeks naar de volgende sectie.

Het project noemt geen cijfers voor geheugen of CPU. De grootte hangt af van het aantal budgetten, hun geschiedenis en het aantal apparaten dat synchroniseert. Beschrijf op een managed VPS uw gebruik aan ons, dan raden wij u de passende grootte aan.

HTTPS: een voorwaarde om de app te starten

Actual Budget steunt op SharedArrayBuffer, een browsertechnologie die de documentatie als vereist omschrijft: zonder haar start de app niet. Browsers schakelen haar alleen in op een geïsoleerde pagina, wat twee voorwaarden vraagt:

Om Actual aan het internet bloot te stellen, vraagt de documentatie het achter een reverse proxy met HTTPS te zetten. De server kan HTTPS ook zelf aanbieden met een certificaat dat u hem geeft, via ACTUAL_HTTPS_KEY en ACTUAL_HTTPS_CERT: de documentatie beschrijft die weg voor een server die buiten het internet blijft.

Met Caddy

De documentatie stelt Caddy voor als een eenvoudige reverse proxy, die zijn certificaten zelf verkrijgt en vernieuwt. Hier is haar voorbeeld, aangepast aan een Caddy die op de server is geïnstalleerd:

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

Met Nginx en Certbot

Dit blok volgt de Nginx-configuratie uit de documentatie, teruggebracht tot poort 80 zodat Certbot HTTPS kan plaatsen. Het verbergt de twee headers die Actual stuurt en zet ze opnieuw, één keer: de documentatie waarschuwt dat een dubbele header het beleid ongeldig maakt, waarna de app stopt op de fout SharedArrayBufferMissing.

Nginx-blok
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 heft de groottelimiet van Nginx op, zoals in het voorbeeld uit de documentatie, zodat een groot budgetbestand de server bereikt. Certbot plaatst daarna het certificaat en zorgt voor de vernieuwing ervan:

Terminal
sudo certbot --nginx

Controleren

Open uw adres via https, in een nieuw tabblad in plaats van een pagina met een fout opnieuw te laden, zoals de documentatie aanraadt. Het welkomstscherm van Actual verschijnt: HTTPS en de headers staan goed.

Het serverwachtwoord

Bij de eerste start vraagt het welkomstscherm een wachtwoord voor de server te kiezen: dat beschermt de toegang tot uw budgetten. Zolang er geen is ingesteld, verschijnt dit scherm voor de eerste persoon die het adres opent. Open het dus zodra HTTPS werkt, en kies een lang wachtwoord dat u alleen voor deze server gebruikt.

De server bewaart dit wachtwoord gehasht, met argon2, in het bestand account.sqlite van server-files, samen met de lijst van budgetbestanden die hij kent en het actieve sessietoken.

Een vergeten wachtwoord opnieuw instellen

De documentatie levert een opdracht die een nieuw wachtwoord instelt zonder uw bestanden of gegevens aan te raken. Ze vraagt het twee keer:

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

OpenID en meerdere gebruikers

Voor een sterkere authenticatie dan een wachtwoord raadt de documentatie een OpenID-provider aan: de meeste bieden tweestapsverificatie. Het is ook wat de server voor meerdere gebruikers openstelt. De configuratiereferentie stelt deze methode voor als preview.

  1. Registreer Actual bij uw provider, met de redirect-URI https://budget.example.com/openid/callback.
  2. Ga in een geopend budget naar de instellingen en klik op Start using OpenID, en vul daarna de provider, het client-ID en zijn geheim in.
  3. Meld u aan met OpenID. De documentatie waarschuwt dat de eerste persoon die zich aanmeldt, de beheerder en eigenaar van de server wordt, een rol die niet meer vanuit de interface te wijzigen is: zorg dat u zich als eerste aanmeldt.

Dezelfde configuratie kan ook in config.json of in omgevingsvariabelen staan, met een discovery-URL wanneer de provider er een publiceert:

compose.yaml, in de dienst
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"

Het geheim komt in een bestand .env naast compose.yaml. Sinds versie 26.10.0 kan ACTUAL_OPENID_CLIENT_SECRET_FILE het ook uit een bestand lezen, wat goed past bij Docker-secrets.

De end-to-endversleuteling

Bovenop het serverwachtwoord kan elk budget end-to-end worden versleuteld. Zijn gegevens worden dan op uw apparaat versleuteld, met een sleutel afgeleid van een tweede wachtwoord, voordat ze vertrekken: de server geeft alleen wijzigingen door die hij niet kan lezen.

  1. Open het budget, ga naar de instellingen, sectie Encryption, en klik op Enable encryption.
  2. Kies een ander wachtwoord dan het serverwachtwoord.
  3. Voer op elk ander apparaat één keer ditzelfde wachtwoord in, wanneer het budget voor het eerst wordt gedownload.

De documentatie is duidelijk: een vergeten versleutelingswachtwoord is niet te herstellen. Bestaat er nog een lokale kopie van het budget, dan kunt u een nieuwe sleutel genereren, wat de synchronisatie opnieuw instelt. De versleuteling is ook niet uit te schakelen: terug naar een onversleuteld bestand gaat via een export, en daarna een import.

BeschermingWat ze oplevertWaar ze wordt ingesteld
HTTPSVersleutelt het traject tussen uw apparaten en de server, en laat de app startenDe reverse proxy
ServerwachtwoordBeperkt de toegang tot de budgetten, gehasht met argon2 op de serverBij de eerste start, daarna in de instellingen
OpenIDDe tweestapsverificatie van uw provider, en één account per persoonBij de provider, daarna in de instellingen
End-to-endversleutelingMaakt de budgetten onleesbaar voor de server en voor zijn back-upsIn elk budget
SchijfversleutelingBeschermt de lokale kopie, die volgens de documentatie onversleuteld isOp elk van uw apparaten

De end-to-endversleuteling dekt de gegevens van de budgetten. De toegangsgegevens voor de banksynchronisatie worden op de server bewaard, in account.sqlite, buiten deze versleuteling: bescherm de toegang tot de server en tot zijn back-ups dienovereenkomstig.

De banksynchronisatie

Actual importeert uw transacties uit een bestand, zonder enige instelling. Het kan ze ook rechtstreeks bij uw bank ophalen, via een aanbieder van bankgegevens. Deze synchronisatie is optioneel, vraagt de server en steunt op uw eigen toegangsgegevens: u opent een account bij de aanbieder en maakt daar de sleutels aan die u aan Actual geeft. Die sleutels worden op de server bewaard, en u voert ze maar één keer in.

AanbiederGedekte banken, volgens de documentatieStatus in versie 26.11.0
SimpleFIN BridgeNoord-Amerikaanse bankenOndersteund; toegangsgegevens per budget mogelijk sinds 26.11.0
GoCardless Bank Account DataEuropese bankenOndersteund voor bestaande accounts: GoCardless aanvaardt sinds juli 2025 geen nieuwe accounts meer
Pluggy.aiBraziliaanse bankenOndersteund
Enable BankingEuropese bankenExperimentele functie
AkahuNieuw-Zeelandse bankenExperimentele functie

De back-ups

Elk apparaat bewaart een volledige kopie van uw budgetten, en de server bewaart er nog een. Een goede back-up dekt beide: de gegevensmap van de server, en een export van elk budget.

OnderdeelWat het bewaartBack-up
server-files/account.sqliteHet gehashte wachtwoord, de lijst van budgetten, de sessies, de OpenID-accounts en de toegangsgegevens voor de bankVerplicht, versleuteld
user-files/De budgetbestanden, als binaire bestandenVerplicht
config.jsonDe configuratie van de server, als u er een hebt aangemaaktAanbevolen, versleuteld
De export van elk budgetEen zipbestand met de database db.sqlite en metadata.jsonAanbevolen

De map van de server

Alles wat de server bewaart, staat in actual-data. Met de server gestopt kunt u haar in één keer kopiëren, met de SQLite-databases in rust:

Terminal, in de map van compose.yaml
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d

Plan deze kopie op de server in, versleutel haar, en bewaar er een elders. Staat ze op de schijf van de server, dan valt ze ook onder de nachtelijke back-ups.

De export van elk budget

Vanuit een geopend budget: Settings, sectie Data, Export data. Het bestand kunt u bewaren waar u wilt, en het opent opnieuw zonder server. De documentatie gebruikt deze export om van een versleuteld budget terug te gaan naar een onversleuteld bestand: het bevat uw gegevens leesbaar, dus bewaar het op een veilige plek.

Een oud budget geeft een grote export, omdat Actual elke wijziging in het bestand bewaart. De documentatie raadt dan Reset sync aan, in de geavanceerde instellingen, vóór de export: de geschiedenis wordt samengevoegd tot één bestand, en de grootte daalt sterk.

Terugzetten

  1. Sluit het geopende budget: klik op de naam ervan linksboven, en daarna op Switch file.
  2. Klik op Import file, kies Actual, en daarna het zipbestand van de export.
  3. Het geïmporteerde budget verschijnt naast het origineel: controleer het, hernoem het indien nodig, en verwijder daarna de oude kopie.

Kies daarna op uw andere apparaten dit budget in de lijst met bestanden: het wordt gedownload en daarna gesynchroniseerd. De desktopapps houden ook hun eigen automatische back-ups bij, één voor elk van de laatste tien dagen van gebruik, en meerdere voor de huidige dag.

De updates

De documentatie geeft de opdracht, vanuit de map van compose.yaml. De gegevensmap blijft ongemoeid:

Terminal
docker compose pull
docker compose up -d

De versies worden genummerd naar jaar en maand: 26.11.0 verscheen op 1 november 2026, en de laatste versies zijn telkens aan het begin van de maand gepubliceerd. Lees hun opmerkingen vóór de update, en exporteer uw budgetten vlak ervoor, zoals de documentatie aanraadt. De opmerkingen melden de wijzigingen waarop u zich voorbereidt, zoals de lijst van toegelaten SimpleFIN-netwerken in 26.11.0, of de overstap van de Ubuntu-image naar Node.js 24 in 26.9.0, waardoor die image van 32-bits ARM-processors verdween ten gunste van de Alpine-image.

Wie doet wat op een managed VPS

Self-hosting vraagt dat u naast de applicatie ook de server beheert. Op een managed VPS neemt ons team de server voor zijn rekening en houdt het uw instantie proactief in de gaten; Actual Budget blijft uw software, met zijn instellingen en uw budgetten.

OnderwerpOns teamU
De serverSysteem- en beveiligingsupdates, ingrepen op de server inbegrepenHet moment dat bij uw activiteit past
De monitoringServer 24 uur per dag en 7 dagen per week bewaakt, met ingrijpen zonder op uw oproep te wachtenHet lezen van de logboeken van uw instantie
Actual BudgetProactief toezicht: fouten, vertragingen en schijfruimte opgespoord, correctie aangeradenDe installatie, de updates en de instellingen, die u toepast, zelf of via uw AI-assistent
De toegang en de budgettenDe server die ze draagt, bewaakt en geback-uptHet serverwachtwoord, OpenID, de gebruikers en de end-to-endversleuteling
De banksynchronisatieDe server die haar toegangsgegevens bewaart, bewaakt en geback-uptDe keuze van de aanbieder, zijn sleutels en de gekoppelde rekeningen
De back-upsElke nacht, versleuteld en buiten de machine bewaard; terugzetten inbegrepenDe exports van uw budgetten, en het verzoek om terug te zetten, wanneer u dat nodig hebt
De migratieUw huidige server gemigreerd, gratisHet moment van de overschakeling

Wilt u liever dat ons team in de applicatie zelf ingrijpt, dan wordt die dienstverlening per uur of tegen een vast bedrag gefactureerd, met een offerte voordat het werk begint.

Actual Budget, op een server die voor u wordt beheerd

Met een Managed VPS van Simafri houdt ons team de server van uw Actual Budget-instantie up-to-date, bewaakt hem dag en nacht en grijpt in zonder op uw oproep te wachten; het houdt ook uw instantie proactief in de gaten en raadt u de nuttige correcties aan, die u toepast, zelf of via uw AI-assistent. De back-ups worden elke nacht versleuteld en buiten de machine bewaard, het terugzetten is inbegrepen, en de migratie van uw huidige server is gratis.

Ontdek Managed VPS

Veelgestelde vragen

Is Actual Budget gratis?

Ja. Actual Budget wordt gepubliceerd onder de MIT-licentie: u mag het vrij gebruiken, wijzigen en verspreiden, voor uzelf of voor een bedrijf, op voorwaarde dat de copyright- en licentievermelding in de kopieën blijft. Wat overblijft, zijn de kosten van de server waarop het draait.

Heb ik een server nodig om Actual Budget te gebruiken?

De desktopapps werken op zichzelf. De server, die de documentatie sterk aanraadt, voegt de web- en mobiele app toe, de synchronisatie tussen apparaten, de banksynchronisatie en de API. Elk apparaat bewaart een volledige kopie van uw budgetten, gesynchroniseerd met de server.

Hoe installeer ik Actual Budget met Docker Compose?

Maak een compose.yaml met de image actualbudget/actual-server, poort 5006 gepubliceerd op 127.0.0.1 en een gegevensmap gekoppeld op /data, en voer docker compose up -d uit. Zet er daarna een reverse proxy met HTTPS voor, en open uw adres om het serverwachtwoord te kiezen.

Waarom vraagt Actual Budget HTTPS?

De app heeft SharedArrayBuffer nodig, dat browsers alleen inschakelen op een pagina die via HTTPS wordt aangeboden, met de headers Cross-Origin-Embedder-Policy en Cross-Origin-Opener-Policy. De server zet die headers; de reverse proxy brengt HTTPS. Alleen toegang via localhost kan zonder.

Hoe bescherm ik de gegevens van een budget in Actual?

Bied de instantie via HTTPS aan, kies een sterk serverwachtwoord of gebruik OpenID met tweestapsverificatie, en schakel de end-to-endversleuteling in: de server kan uw budgetten dan niet meer lezen. Bewaar dat tweede wachtwoord op een veilige plek, want het is niet te herstellen.

Maakt Actual Budget verbinding met mijn bank?

Ja, via een aanbieder van bankgegevens, met uw eigen toegangsgegevens: SimpleFIN Bridge, GoCardless Bank Account Data voor bestaande accounts, Pluggy.ai, en Enable Banking en Akahu als experimentele functies. De synchronisatie vraagt de server, en kan sinds versie 26.11.0 automatisch draaien.

Hoe maak ik een back-up van Actual Budget?

Kopieer de gegevensmap van de server met de server gestopt: server-files bevat de accounts en de toegangsgegevens, user-files de budgetten. Exporteer ook elk budget via Settings, Export data, en bewaar deze kopieën versleuteld. Een export zet u terug met Import file.

Dekt een managed VPS ook Actual Budget?

Een managed VPS dekt de server: systeem, beveiliging, monitoring en back-ups. Ons team houdt ook uw instantie proactief in de gaten en raadt u de nuttige correcties aan, die u toepast. Een ingreep in de applicatie wordt per uur of tegen een vast bedrag gefactureerd.

Bronnen en officiële documentatie

Gerelateerde gidsen

Verschil tussen managed en unmanaged VPS: wie doet watHet verschil tussen een managed en een unmanaged VPS draait om één vraag: wie zorgt voor de server zodra hij draait. Toch heeft “managed” geen officiële definitie: van de ene hostingprovider tot de andere gaat het woord van een eenvoudige installatie van het systeem tot de volledige exploitatie van de server. Deze gids laat zien wie wat doet, regel voor regel, met het tussenniveau van ondersteuning, en geeft de vragen die de onduidelijkheid wegnemen voordat u tekent.Back-ups van een VPS: wat u controleert voordat u tekentEen VPS-aanbod vermeldt bijna altijd “back-ups inbegrepen”. Achter die twee woorden kan een kopie zitten die elke nacht wordt gemaakt, buiten de machine wordt bewaard en door experts wordt teruggezet, of een snapshot op dezelfde schijf als de server. Deze gids geeft de vragen die het verschil maken, wat elk antwoord betekent, en de manier om te controleren dat een back-up terug te zetten is.Vaultwarden hosten op een Managed VPS: uw wachtwoorden op uw eigen serverVaultwarden hosten op een Managed VPS betekent dat u uw wachtwoorden en die van uw team bewaart op een machine die van u is, en die ons team bijwerkt en dag en nacht in de gaten houdt. Vaultwarden is opensourcesoftware onder de AGPL-3.0-licentie. Deze gids volgt de officiële documentatie: de installatie met Docker Compose, HTTPS, het sluiten van de registraties, het beheerderstoken, wat de kluis beschermt, de database, e-mails, back-ups en updates.
Neem contact op