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.
Door Simon Vasconcelos Lee
Gepubliceerd op 17 november 2026Leestijd: 14 minuten
SharedArrayBuffer nodig, dat browsers alleen inschakelen op een pagina die via HTTPS wordt aangeboden. Een reverse proxy zorgt daarvoor.docker compose pull.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:
| Functie | Zonder server | Met server |
|---|---|---|
| Budgetten, rapporten, planningen | Ja | Ja |
| Transacties importeren uit een bestand | Ja | Ja |
| Budgetbestanden importeren en exporteren | Ja | Ja |
| De app in een browser en op een telefoon | Ja | |
| Synchronisatie tussen apparaten | Ja | |
| Banksynchronisatie | Ja | |
| De API van Actual | Ja |
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.
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:
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 is ze alleen bereikbaar via de reverse proxy op dezelfde server, die HTTPS toevoegt.actual-data bevat alles wat de server bewaart. Hij maakt er twee submappen in aan, server-files en user-files, en de documentatie wijst erop dat deze koppeling uw gegevens behoudt wanneer de container wordt verwijderd.latest volgt de recentste officiële versie, en de documentatie raadt hem aan voor de meeste gebruikers. latest-alpine geeft dezelfde versie op een lichtere Alpine-basis, en een tag zoals 26.11.0 legt een versie vast. De tags nightly volgen de ontwikkeling, met elke wijziging op de hoofdtak.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.
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:
localhost.Cross-Origin-Embedder-Policy op require-corp en Cross-Origin-Opener-Policy op same-origin. De officiële server zet ze altijd zelf.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.
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:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
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.
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:
sudo certbot --nginx
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.
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.
De documentatie levert een opdracht die een nieuw wachtwoord instelt zonder uw bestanden of gegevens aan te raken. Ze vraagt het twee keer:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: standaard password, openid voor een identiteitsprovider, of header.x-actual-password. De documentatie waarschuwt dat een verkeerde instelling bij deze stap de instantie voor het hele internet beschikbaar kan maken: behoud het voor die diensten.ACTUAL_ALLOWED_LOGIN_METHODS, een lijst gescheiden door komma's.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.
https://budget.example.com/openid/callback.Dezelfde configuratie kan ook in config.json of in omgevingsvariabelen staan, met een discovery-URL wanneer de provider er een publiceert:
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.
"authMethod": "oauth2", in config.json.ACTUAL_USER_CREATION_MODE op login maakt ze aan bij hun eerste aanmelding.ACTUAL_OPENID_ENFORCE op true maakt het de enige aanvaarde aanmeldmethode.ACTUAL_TOKEN_EXPIRATION staat standaard op never. Ze kan die van de provider volgen, met openid-provider, of een duur in seconden.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.
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.
| Bescherming | Wat ze oplevert | Waar ze wordt ingesteld |
|---|---|---|
| HTTPS | Versleutelt het traject tussen uw apparaten en de server, en laat de app starten | De reverse proxy |
| Serverwachtwoord | Beperkt de toegang tot de budgetten, gehasht met argon2 op de server | Bij de eerste start, daarna in de instellingen |
| OpenID | De tweestapsverificatie van uw provider, en één account per persoon | Bij de provider, daarna in de instellingen |
| End-to-endversleuteling | Maakt de budgetten onleesbaar voor de server en voor zijn back-ups | In elk budget |
| Schijfversleuteling | Beschermt de lokale kopie, die volgens de documentatie onversleuteld is | Op 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.
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.
| Aanbieder | Gedekte banken, volgens de documentatie | Status in versie 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Noord-Amerikaanse banken | Ondersteund; toegangsgegevens per budget mogelijk sinds 26.11.0 |
| GoCardless Bank Account Data | Europese banken | Ondersteund voor bestaande accounts: GoCardless aanvaardt sinds juli 2025 geen nieuwe accounts meer |
| Pluggy.ai | Braziliaanse banken | Ondersteund |
| Enable Banking | Europese banken | Experimentele functie |
| Akahu | Nieuw-Zeelandse banken | Experimentele functie |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. Openbare SimpleFIN-bridges vragen geen instelling.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.
| Onderdeel | Wat het bewaart | Back-up |
|---|---|---|
server-files/account.sqlite | Het gehashte wachtwoord, de lijst van budgetten, de sessies, de OpenID-accounts en de toegangsgegevens voor de bank | Verplicht, versleuteld |
user-files/ | De budgetbestanden, als binaire bestanden | Verplicht |
config.json | De configuratie van de server, als u er een hebt aangemaakt | Aanbevolen, versleuteld |
| De export van elk budget | Een zipbestand met de database db.sqlite en metadata.json | Aanbevolen |
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:
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.
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.
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 documentatie geeft de opdracht, vanuit de map van compose.yaml. De gegevensmap blijft ongemoeid:
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.
nightly: teruggaan van nightly naar latest kan een budget onleesbaar maken voor de stabiele versie. De documentatie beschrijft de oplossing, en vraagt back-ups van uw budgetten met deze tags.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.
| Onderwerp | Ons team | U |
|---|---|---|
| De server | Systeem- en beveiligingsupdates, ingrepen op de server inbegrepen | Het moment dat bij uw activiteit past |
| De monitoring | Server 24 uur per dag en 7 dagen per week bewaakt, met ingrijpen zonder op uw oproep te wachten | Het lezen van de logboeken van uw instantie |
| Actual Budget | Proactief toezicht: fouten, vertragingen en schijfruimte opgespoord, correctie aangeraden | De installatie, de updates en de instellingen, die u toepast, zelf of via uw AI-assistent |
| De toegang en de budgetten | De server die ze draagt, bewaakt en geback-upt | Het serverwachtwoord, OpenID, de gebruikers en de end-to-endversleuteling |
| De banksynchronisatie | De server die haar toegangsgegevens bewaart, bewaakt en geback-upt | De keuze van de aanbieder, zijn sleutels en de gekoppelde rekeningen |
| De back-ups | Elke nacht, versleuteld en buiten de machine bewaard; terugzetten inbegrepen | De exports van uw budgetten, en het verzoek om terug te zetten, wanneer u dat nodig hebt |
| De migratie | Uw huidige server gemigreerd, gratis | Het 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Laten we het over uw website hebben
Vertel ons in een paar woorden over uw project: wij nemen snel contact met u op.
Bedankt! Uw aanvraag is verzonden. We nemen spoedig contact met u op.
Liever per e-mail? Schrijf ons op support@simafri.com.