Actual Budget auf einem Managed VPS zu hosten heißt, Ihre Budgets und ihre Synchronisierung auf einer Maschine zu bewahren, die Ihnen gehört und die unsere Teams aktuell halten und Tag und Nacht beaufsichtigen. Actual Budget ist ein Local-first-Werkzeug für persönliche Finanzen, veröffentlicht unter der MIT-Lizenz. Dieser Leitfaden folgt der offiziellen Dokumentation: die Rolle des Servers, die Installation mit Docker Compose, HTTPS, das Serverpasswort, OpenID, die Ende-zu-Ende-Verschlüsselung, die Bank-Synchronisierung, Backups und Updates.
Von Simon Vasconcelos Lee
Veröffentlicht am 17. November 2026Lesezeit: 14 Minuten
SharedArrayBuffer, das Browser nur auf einer über HTTPS ausgelieferten Seite aktivieren. Ein Reverse Proxy übernimmt das.docker compose pull.Actual Budget ist ein Local-first-Werkzeug für persönliche Finanzen, geschrieben in Node.js, das sein README als vollständig kostenlos und quelloffen beschreibt. Es bewahrt alle Ihre Daten auf jedem Ihrer Geräte und synchronisiert sie im Hintergrund mit dem Server Ihrer Wahl: Die App funktioniert auch ohne Verbindung, und Ihre Änderungen erreichen Ihre anderen Geräte, sobald das Netzwerk zurück ist.
Das Projekt besteht aus einem Client und einem Server. Der Server ist optional, doch die Dokumentation empfiehlt ihn ausdrücklich, denn er schaltet mehrere Funktionen frei:
| Funktion | Ohne Server | Mit Server |
|---|---|---|
| Budgets, Berichte, Zeitpläne | Ja | Ja |
| Buchungen aus einer Datei importieren | Ja | Ja |
| Budgetdateien importieren und exportieren | Ja | Ja |
| Die App im Browser und auf dem Telefon | Ja | |
| Synchronisierung zwischen Geräten | Ja | |
| Bank-Synchronisierung | Ja | |
| Die Actual-API | Ja |
Actual Budget wird unter der MIT-Lizenz veröffentlicht, Copyright James Long. Der Text gewährt jedem, der eine Kopie erhält, kostenlos das Recht, sie zu nutzen, zu kopieren, zu ändern, zusammenzuführen, zu veröffentlichen, zu verbreiten, unterzulizenzieren und Kopien davon zu verkaufen.
Es gibt eine Bedingung: Der Urheberrechtshinweis und der Lizenztext begleiten alle Kopien oder wesentlichen Teile der Software. Sie können also das vom Projekt veröffentlichte Image für sich, Ihre Familie oder Ihr Unternehmen betreiben, ohne eine Lizenz zu kaufen.
Das Projekt veröffentlicht den Server als Docker-Image, actualbudget/actual-server auf Docker Hub, und dasselbe Image in der Registry von GitHub, ghcr.io/actualbudget/actual. Legen Sie auf einem Server, auf dem Docker installiert ist, einen Ordner an und speichern Sie darin diese compose.yaml, entnommen aus der Datei im 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 veröffentlicht, ist er nur über den Reverse Proxy auf demselben Server erreichbar, der HTTPS ergänzt.actual-data enthält alles, was der Server aufbewahrt. Er legt dort zwei Unterordner an, server-files und user-files, und die Dokumentation weist darauf hin, dass diese Einbindung Ihre Daten erhält, wenn der Container entfernt wird.latest folgt der jüngsten offiziellen Version, und die Dokumentation empfiehlt es den meisten Nutzern. latest-alpine liefert dieselbe Version auf einer leichteren Alpine-Basis, und ein Tag wie 26.11.0 legt eine Version fest. Die Tags nightly folgen der Entwicklung, mit jeder Änderung an ihrem Hauptzweig.Ihr Domainname zeigt mit A- und AAAA-Einträgen auf den Server, und die Besucher kommen über die Ports 80 und 443. Solange HTTPS nicht steht, öffnet sich die App nicht: Gehen Sie direkt zum nächsten Abschnitt.
Das Projekt nennt weder Arbeitsspeicher noch Prozessor. Die Größe hängt von der Zahl der Budgets, ihrem Verlauf und der Zahl der Geräte ab, die synchronisieren. Auf einem Managed VPS beschreiben Sie uns Ihren Einsatz, und wir empfehlen Ihnen die passende Größe.
Actual Budget stützt sich auf SharedArrayBuffer, eine Browsertechnik, die seine Dokumentation als erforderlich beschreibt: Ohne sie startet die App nicht. Browser aktivieren sie nur auf einer isolierten Seite, wofür zwei Bedingungen nötig sind:
localhost geöffnet wird.Cross-Origin-Embedder-Policy auf require-corp und Cross-Origin-Opener-Policy auf same-origin. Der offizielle Server setzt sie immer selbst.Um Actual im Internet erreichbar zu machen, bittet die Dokumentation darum, es hinter einen Reverse Proxy mit HTTPS zu stellen. Der Server kann HTTPS auch selbst ausliefern, mit einem Zertifikat, das Sie ihm über ACTUAL_HTTPS_KEY und ACTUAL_HTTPS_CERT geben: Die Dokumentation beschreibt diesen Weg für einen Server, der nicht im Internet steht.
Die Dokumentation stellt Caddy als einfachen Reverse Proxy vor, der seine Zertifikate selbstständig bezieht und erneuert. Hier ihr Beispiel, angepasst an ein auf dem Server installiertes Caddy:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
Dieser Block folgt der Nginx-Konfiguration der Dokumentation, auf Port 80 reduziert, damit Certbot HTTPS einrichten kann. Er blendet die beiden von Actual gesendeten Header aus und setzt sie einmal neu: Die Dokumentation warnt, dass ein doppelter Header die Richtlinie ungültig macht, und die App bricht dann mit dem Fehler SharedArrayBufferMissing ab.
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 hebt die Größenbegrenzung von Nginx auf, wie im Beispiel der Dokumentation, damit eine große Budgetdatei den Server erreicht. Certbot richtet anschließend das Zertifikat ein und kümmert sich um die Erneuerung:
sudo certbot --nginx
Öffnen Sie Ihre Adresse über https, in einem neuen Tab statt durch Neuladen einer Seite, die einen Fehler gezeigt hat, wie es die Dokumentation rät. Der Begrüßungsbildschirm von Actual erscheint: HTTPS und die Header sind eingerichtet.
Beim ersten Start bittet der Begrüßungsbildschirm Sie, ein Passwort für den Server festzulegen: Es schützt den Zugang zu Ihren Budgets. Solange keines gesetzt ist, erscheint dieser Bildschirm der ersten Person, die die Adresse öffnet. Öffnen Sie sie also, sobald HTTPS funktioniert, und wählen Sie ein langes Passwort, das nur für diesen Server gilt.
Der Server bewahrt dieses Passwort als Hash mit argon2 in der Datei account.sqlite von server-files auf, zusammen mit der Liste der ihm bekannten Budgetdateien und dem aktiven Sitzungstoken.
Die Dokumentation liefert einen Befehl, der ein neues Passwort setzt, ohne Ihre Dateien oder Daten anzurühren. Er fragt es zweimal ab:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD eingestellt: standardmäßig password, openid für einen Identitätsanbieter, oder header.x-actual-password übergeben. Die Dokumentation warnt, dass eine Fehlkonfiguration an dieser Stelle die Instanz für das ganze Internet zugänglich machen könnte: Behalten Sie sie diesen Diensten vor.ACTUAL_ALLOWED_LOGIN_METHODS einschränken, einer kommagetrennten Liste.Für eine robustere Authentifizierung als ein Passwort empfiehlt die Dokumentation einen OpenID-Anbieter: Die meisten bieten eine Zwei-Faktor-Authentifizierung an. Über ihn öffnet sich der Server auch für mehrere Nutzer. Die Konfigurationsreferenz stellt diese Methode als Vorschau vor.
https://budget.example.com/openid/callback.Dieselbe Konfiguration kann auch in config.json oder in Umgebungsvariablen stehen, mit einer Discovery-URL, wenn der Anbieter eine veröffentlicht:
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"
Das Geheimnis kommt in eine Datei .env neben der compose.yaml. Seit Version 26.10.0 kann ACTUAL_OPENID_CLIENT_SECRET_FILE es auch aus einer Datei lesen, was zu Docker Secrets passt.
"authMethod": "oauth2", in config.json.ACTUAL_USER_CREATION_MODE auf login legt die Nutzer bei ihrer ersten Anmeldung an.ACTUAL_OPENID_ENFORCE auf true macht es zur einzigen akzeptierten Anmeldemethode.ACTUAL_TOKEN_EXPIRATION steht standardmäßig auf never. Sie kann der des Anbieters folgen, mit openid-provider, oder einer Dauer in Sekunden.Zusätzlich zum Serverpasswort lässt sich jedes Budget Ende-zu-Ende verschlüsseln. Seine Daten werden dann auf Ihrem Gerät verschlüsselt, mit einem Schlüssel, der aus einem zweiten Passwort abgeleitet wird, bevor sie es verlassen: Der Server reicht nur Änderungen weiter, die er nicht lesen kann.
Die Dokumentation ist eindeutig: Ein vergessenes Verschlüsselungspasswort lässt sich nicht wiederherstellen. Existiert noch eine lokale Kopie des Budgets, können Sie einen neuen Schlüssel erzeugen, was die Synchronisierung zurücksetzt. Die Verschlüsselung lässt sich auch nicht ausschalten: Der Weg zurück zu einer unverschlüsselten Datei führt über einen Export und dann einen Import.
| Schutz | Was er bringt | Wo er eingestellt wird |
|---|---|---|
| HTTPS | Verschlüsselt den Weg zwischen Ihren Geräten und dem Server und lässt die App starten | Der Reverse Proxy |
| Serverpasswort | Beschränkt den Zugang zu den Budgets, auf dem Server mit argon2 gehasht | Beim ersten Start, danach in den Einstellungen |
| OpenID | Die Zwei-Faktor-Authentifizierung Ihres Anbieters und ein Konto pro Person | Beim Anbieter, danach in den Einstellungen |
| Ende-zu-Ende-Verschlüsselung | Macht die Budgets für den Server und seine Backups unlesbar | In jedem Budget |
| Festplattenverschlüsselung | Schützt die lokale Kopie, die laut Dokumentation unverschlüsselt ist | Auf jedem Ihrer Geräte |
Die Ende-zu-Ende-Verschlüsselung umfasst die Daten der Budgets. Die Zugangsdaten der Bank-Synchronisierung werden auf dem Server aufbewahrt, in account.sqlite, außerhalb dieser Verschlüsselung: Schützen Sie den Zugang zum Server und zu seinen Backups entsprechend.
Actual importiert Ihre Buchungen ohne Einrichtung aus einer Datei. Es kann sie auch direkt bei Ihrer Bank abrufen, über einen Anbieter von Bankdaten. Diese Synchronisierung ist optional, braucht den Server und stützt sich auf Ihre eigenen Zugangsdaten: Sie eröffnen ein Konto beim Anbieter und legen dort die Schlüssel an, die Sie Actual geben. Diese Schlüssel werden auf dem Server aufbewahrt, und Sie geben sie nur einmal ein.
| Anbieter | Abgedeckte Banken laut Dokumentation | Stand in Version 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Nordamerikanische Banken | Unterstützt; Zugangsdaten pro Budget seit 26.11.0 möglich |
| GoCardless Bank Account Data | Europäische Banken | Für bestehende Konten unterstützt: GoCardless nimmt seit Juli 2025 keine neuen Konten mehr an |
| Pluggy.ai | Brasilianische Banken | Unterstützt |
| Enable Banking | Europäische Banken | Experimentelle Funktion |
| Akahu | Neuseeländische Banken | Experimentelle Funktion |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS aufgeführt sein. Öffentliche SimpleFIN-Bridges brauchen keine Einstellung.Jedes Gerät bewahrt eine vollständige Kopie Ihrer Budgets, und der Server eine weitere. Ein gutes Backup umfasst beides: den Datenordner des Servers und einen Export jedes Budgets.
| Element | Was es enthält | Zu sichern |
|---|---|---|
server-files/account.sqlite | Das gehashte Passwort, die Liste der Budgets, die Sitzungen, die OpenID-Konten und die Bankzugangsdaten | Pflicht, verschlüsselt |
user-files/ | Die Budgetdateien, als Binärdateien | Pflicht |
config.json | Die Konfiguration des Servers, falls Sie eine angelegt haben | Empfohlen, verschlüsselt |
| Der Export jedes Budgets | Eine ZIP-Datei mit der Datenbank db.sqlite und metadata.json | Empfohlen |
Alles, was der Server aufbewahrt, liegt in actual-data. Bei gestopptem Server lässt er sich in einem Zug kopieren, mit ruhenden SQLite-Datenbanken:
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
Planen Sie diese Kopie auf dem Server, verschlüsseln Sie sie und bewahren Sie eine an einem anderen Ort auf. Auf der Festplatte des Servers abgelegt, fließt sie auch in dessen nächtliche Backups ein.
Aus einem geöffneten Budget: Settings, Abschnitt Data, Export data. Die Datei lässt sich aufbewahren, wo Sie möchten, und öffnet sich auch ohne Server wieder. Die Dokumentation nutzt diesen Export, um von einem verschlüsselten Budget zu einer unverschlüsselten Datei zurückzukehren: Er enthält Ihre Daten im Klartext, bewahren Sie ihn also sicher auf.
Ein altes Budget ergibt einen großen Export, weil Actual jede Änderung in der Datei aufbewahrt. Die Dokumentation rät dann zu Reset sync, in den erweiterten Einstellungen, vor dem Export: Der Verlauf wird in eine einzige Datei verdichtet, und die Größe sinkt deutlich.
Wählen Sie dieses Budget anschließend auf Ihren anderen Geräten in der Dateiliste: Es wird heruntergeladen und dann synchronisiert. Die Desktop-Apps führen außerdem ihre eigenen automatischen Backups, eines für jeden der letzten zehn Nutzungstage und mehrere für den aktuellen Tag.
Die Dokumentation nennt den Befehl, auszuführen im Ordner der compose.yaml. Der Datenordner bleibt dabei erhalten:
docker compose pull
docker compose up -d
Die Versionen sind nach Jahr und Monat nummeriert: 26.11.0 ist am 1. November 2026 erschienen, und die jüngsten Versionen wurden jeweils zu Monatsbeginn veröffentlicht. Lesen Sie ihre Notizen vor dem Update und exportieren Sie Ihre Budgets unmittelbar davor, wie es die Dokumentation empfiehlt. Die Notizen weisen auf Änderungen hin, die einzuplanen sind, etwa die Liste der erlaubten SimpleFIN-Netzwerke in 26.11.0 oder den Wechsel des Ubuntu-Images auf Node.js 24 in 26.9.0, der es von 32-Bit-ARM-Prozessoren zugunsten des Alpine-Images entfernt hat.
nightly: Der Wechsel von nightly zurück zu latest kann ein Budget für die stabile Version unlesbar machen. Die Dokumentation beschreibt die Abhilfe und verlangt bei diesen Tags Backups Ihrer Budgets.Beim Selbsthosting müssen Sie neben der Anwendung auch den Server betreuen. Auf einem Managed VPS übernehmen unsere Teams den Server und betreuen Ihre Instanz proaktiv; Actual Budget bleibt Ihre Software, mit ihren Einstellungen und Ihren Budgets.
| Thema | Unsere Teams | Sie |
|---|---|---|
| Der Server | System- und Sicherheitsupdates, Eingriffe am Server inbegriffen | Der Zeitpunkt, der zu Ihrem Betrieb passt |
| Die Überwachung | Server rund um die Uhr im Blick, mit Eingriff, ohne auf Ihren Anruf zu warten | Das Lesen der Protokolle Ihrer Instanz |
| Actual Budget | Proaktive Betreuung: Fehler, lange Antwortzeiten und Speicherplatz erkannt, Korrektur empfohlen | Installation, Updates und Einstellungen, die Sie umsetzen, selbst oder mit Ihrem KI-Assistenten |
| Die Zugänge und die Budgets | Der Server, der sie trägt, überwacht und gesichert | Das Serverpasswort, OpenID, die Nutzer und die Ende-zu-Ende-Verschlüsselung |
| Die Bank-Synchronisierung | Der Server, der ihre Zugangsdaten aufbewahrt, überwacht und gesichert | Die Wahl des Anbieters, seine Schlüssel und die verknüpften Konten |
| Die Backups | Jede Nacht, verschlüsselt und außerhalb der Maschine aufbewahrt; Wiederherstellung inbegriffen | Die Exporte Ihrer Budgets und die Wiederherstellungsanfrage, wenn Sie sie brauchen |
| Die Migration | Ihr aktueller Server wird kostenlos migriert | Der Zeitpunkt der Umstellung |
Wenn unsere Teams lieber in der Anwendung selbst eingreifen sollen, wird diese Leistung nach Stunden oder pauschal abgerechnet, mit einem Kostenvoranschlag vor dem Eingriff.
Mit einem Managed VPS von Simafri halten unsere Teams den Server Ihrer Actual-Budget-Instanz aktuell, überwachen ihn Tag und Nacht und greifen ein, ohne auf Ihren Anruf zu warten; sie betreuen auch Ihre Instanz proaktiv und empfehlen Ihnen die sinnvollen Korrekturen, die Sie umsetzen, selbst oder mit Ihrem KI-Assistenten. Die Backups werden jede Nacht verschlüsselt und außerhalb der Maschine aufbewahrt, ihre Wiederherstellung ist inbegriffen, und die Migration Ihres aktuellen Servers ist kostenlos.
Ja. Actual Budget wird unter der MIT-Lizenz veröffentlicht: Sie können es frei nutzen, ändern und weitergeben, für sich oder für ein Unternehmen, sofern sein Urheberrechts- und Lizenzhinweis in den Kopien erhalten bleibt. Bleiben die Kosten für den Server, auf dem es läuft.
Die Desktop-Apps funktionieren für sich allein. Der Server, den die Dokumentation ausdrücklich empfiehlt, ergänzt die Web- und Mobil-App, die Synchronisierung zwischen Geräten, die Bank-Synchronisierung und die API. Jedes Gerät bewahrt eine vollständige Kopie Ihrer Budgets, synchronisiert mit dem Server.
Legen Sie eine compose.yaml mit dem Image actualbudget/actual-server an, mit Port 5006 auf 127.0.0.1 veröffentlicht und einem auf /data eingebundenen Datenordner, und starten Sie docker compose up -d. Stellen Sie dann einen Reverse Proxy mit HTTPS davor und öffnen Sie Ihre Adresse, um das Serverpasswort festzulegen.
Die App braucht SharedArrayBuffer, das Browser nur auf einer über HTTPS ausgelieferten Seite mit den Headern Cross-Origin-Embedder-Policy und Cross-Origin-Opener-Policy aktivieren. Der Server setzt diese Header; der Reverse Proxy bringt HTTPS. Nur der Zugriff über localhost kommt ohne aus.
Liefern Sie die Instanz über HTTPS aus, wählen Sie ein starkes Serverpasswort oder nutzen Sie OpenID mit Zwei-Faktor-Authentifizierung, und schalten Sie die Ende-zu-Ende-Verschlüsselung ein: Der Server kann Ihre Budgets dann nicht mehr lesen. Bewahren Sie dieses zweite Passwort sicher auf, denn es lässt sich nicht wiederherstellen.
Ja, über einen Anbieter von Bankdaten, mit Ihren eigenen Zugangsdaten: SimpleFIN Bridge, GoCardless Bank Account Data für bestehende Konten, Pluggy.ai sowie Enable Banking und Akahu als experimentelle Funktionen. Die Synchronisierung braucht den Server und kann seit Version 26.11.0 automatisch laufen.
Kopieren Sie den Datenordner des Servers bei gestopptem Server: server-files enthält die Konten und Zugangsdaten, user-files die Budgets. Exportieren Sie außerdem jedes Budget über Settings, Export data, und bewahren Sie diese Kopien verschlüsselt auf. Ein Export wird mit Import file wiederhergestellt.
Ein Managed VPS deckt den Server ab: System, Sicherheit, Überwachung und Backups. Unsere Teams betreuen auch Ihre Instanz proaktiv und empfehlen Ihnen die sinnvollen Korrekturen, die Sie umsetzen. Ein Eingriff in der Anwendung wird nach Stunden oder pauschal abgerechnet.
Simafri
Sprechen wir über Ihr Vorhaben
Sagen Sie uns in wenigen Worten, was Sie brauchen: Wir melden uns schnell bei Ihnen.
Vielen Dank! Ihre Anfrage wurde gesendet. Wir melden uns in Kürze bei Ihnen.
Sie schreiben lieber eine E-Mail? Schreiben Sie uns an support@simafri.com.