Actual Budget mit Docker Compose: Eigene Budget-App lokal auf Port 5006 starten

Wenn Budgets ueber Tabellen, Banking-Apps und lose Notizen zerfallen, hilft kein weiterer Produktivitaets-Mythos, sondern eine konkrete, kleine Loesung. Actual Budget ist genau dafuer stark: schnell, datensparsam und komplett selbst hostbar.

Stand 12. April 2026 ist das Projekt als Docker-Setup angenehm klar dokumentiert. Die offizielle Installationsseite beschreibt den Standardweg ueber den Server im Browser, die Docker-Doku nennt Port 5006 und ein persistentes /data-Volume, und die Release-Notes zu v26.3.0 vom 2. Maerz 2026 markieren diese Version zugleich als sinnvolles Ziel fuer ein reproduzierbares Setup. Wichtig dabei: Das Projekt empfiehlt fuer die meisten Nutzer zwar latest, ich pinne hier trotzdem bewusst auf actualbudget/actual-server:v26.3.0, damit der Artikel nicht von spaeteren Aenderungen abhaengt.

Lokal erzeugtes Artikelbild fuer Actual Budget mit Docker Compose

Was du am Ende hast

Actual Budget lokal unter http://127.0.0.1:5006
Einen kleinen Compose-Stack mit persistentem Datenordner
Eine sofort sichtbare Weboberflaeche fuer Budgetplanung im Browser
Pruefschritte mit docker compose, Logs und curl

Voraussetzungen

Docker Engine und docker compose sind installiert
Port 5006 ist frei
Du startest in einem neuen Projektordner statt in einem bestehenden Compose-Verzeichnis

1. Arbeitsordner anlegen

Nicht zwischen alten Projekten starten, sondern sauber isolieren:

mkdir actual-budget-lab && cd actual-budget-lab
mkdir data

Der Unterordner data wird gleich an den Container gebunden. Laut offizieller Docker-Doku legt Actual dort selbst die benoetigten Unterordner fuer Server- und Nutzerdaten an.

2. Compose-Datei erstellen

Die offizielle Doku zeigt den Kern des Setups bereits ueber den Docker-Befehl: Port 5006, ein dauerhaftes /data-Mount und das offizielle Image actualbudget/actual-server. Fuer einen lokalen Start reicht deshalb eine sehr kleine Compose-Datei.

actual-budget-lab/compose.yaml:

services:
  actual:
    image: actualbudget/actual-server:v26.3.0
    container_name: actual-budget
    ports:
      - "127.0.0.1:5006:5006"
    volumes:
      - ./data:/data
    restart: unless-stopped

Die Bindung an 127.0.0.1 ist fuer einen lokalen Start die sichere Voreinstellung. Wenn du Actual spaeter ueber eine Domain veroeffentlichen willst, gehoert ein Reverse Proxy mit HTTPS davor.

3. Stack starten

Jetzt das Image ziehen und den Container im Hintergrund starten:

docker compose pull
docker compose up -d

Danach sollte der Dienst unter dieser Adresse antworten:

http://127.0.0.1:5006

4. Funktion pruefen

Bevor du im Browser klickst, pruefst du einmal den Container und den HTTP-Endpunkt:

docker compose ps
docker compose logs --tail=100 actual
curl -I http://127.0.0.1:5006

Wenn alles sauber laeuft, zeigt docker compose ps einen laufenden Container und curl liefert einen erfolgreichen HTTP-Status. Genau das ist hier das sichtbare Zwischenergebnis: Die Budget-App steht lokal im Browser und verwendet einen persistenten Datenpfad.

5. Erster Start im Browser

Oeffne http://127.0.0.1:5006. Beim ersten Aufruf landest du nicht in einer leeren Shell, sondern direkt in der eigentlichen Web-App. Typischerweise hast du dann zwei sinnvolle Wege:

ein neues Budget frisch anlegen
eine vorhandene Datei importieren, wenn du Actual schon anderswo genutzt hast

Der wichtige Unterschied zu einer rein lokalen Browser-Nutzung ohne Server: Mit dem Server bekommst du die Web-App ueber mehrere Geraete, Sync-Funktionen und die bessere Basis fuer langfristige Nutzung.

6. Warum Actual Budget als Self-Hosting-Projekt taugt

Actual ist nicht einfach "noch eine Finanz-App", sondern fuer ein kleines lokales Setup ungewoehnlich passend:

die App ist sofort im Browser sichtbar
das Setup braucht nur einen Container
die Daten liegen nachvollziehbar in deinem lokalen ./data-Ordner
du kannst klein anfangen und spaeter Reverse Proxy oder weitere Geraete ergaenzen

Gerade fuer Leute, die ihre Finanzen nicht in einer weiteren Blackbox parken wollen, ist diese Kombination aus Browser-Zugriff und eigener Datenhaltung ein echter Nutzwert statt blosses Homelab-Dekor.

7. Sinnvolle Befehle fuer den Alltag

Fuer Logs, Updates und Stoppen brauchst du zunaechst nur diese Kommandos:

docker compose logs -f actual
docker compose pull
docker compose up -d
docker compose down

Die Daten bleiben im lokalen Ordner ./data erhalten.

8. Was du vor externer Freigabe beachten solltest

Die offizielle Reverse-Proxy-Doku ist hier klar: Wenn du Actual nicht nur lokal, sondern ueber das Internet oder dein Heimnetz mit Domain bereitstellen willst, sollte davor ein Reverse Proxy mit SSL laufen.

Fuer einen sauberen Start gilt deshalb:

lokal zuerst bei 127.0.0.1:5006 bleiben
erst danach Caddy, Traefik oder einen anderen Reverse Proxy davorsetzen
keine unnoetig offene Portfreigabe direkt auf den Container legen

Das ist nicht nur sauberer Betrieb, sondern verhindert auch, dass ein an sich kleines Compose-Projekt sofort unnoetig riskant wird.

Fazit

Wenn aktuelle News im Moment nicht sauber genug tragen, muss der Ersatz ein echtes Problem loesen. Genau das schafft Actual Budget: wenig Setup, ein klarer Docker-Start, sichtbares Ergebnis im Browser und Datenhaltung in deiner eigenen Umgebung.

Fuer einen Docker-Compose-Fallback am 12. April 2026 ist das deutlich brauchbarer als ein weiterer abstrakter Grundlagenpost ohne nutzbares Endergebnis.

User Dashboard