How2-Host

Actual Budget auf Debian 13 installieren – Schritt-für-Schritt-Anleitung

Actual Budget ist eine datenschutzfreundliche Open-Source-App zur Finanzverwaltung unter Debian – lokal, offline oder selbst gehostet.

1 min Lesezeit
Actual Budget auf Debian 13 installieren – Schritt-für-Schritt-Anleitung

Wer seine Finanzen selbst verwalten möchte, ohne persönliche Daten in der Cloud zu speichern, findet mit Actual Budget (kurz: Actual) die perfekte Open-Source-Lösung. Das Tool kombiniert modernes Design mit Datenschutz und ermöglicht dir, dein Budget lokal oder selbst gehostet zu verwalten.

In dieser Anleitung zeige ich, wie du Actual auf einem Debian-Server oder lokal unter Debian 13 installierst, einrichtest und dein erstes Budget anlegst.

Was ist Actual Budget?

Actual ist eine moderne, quelloffene App zur persönlichen Finanzverwaltung. Das Besondere: Sie funktioniert komplett offline („Local-First“) oder – falls gewünscht – mit Synchronisation über deinen eigenen Server.

💡 Ideal für alle, die Tools wie YNAB oder Monarch Money kennen, aber ihre Daten selbst hosten möchten.

Voraussetzungen

Bevor du startest, stelle sicher, dass dein Debian-System folgende Bedingungen erfüllt:

| Komponente | Empfehlung | | ----------------- | ------------------------------- | | Betriebssystem | Debian 12 oder 13 | | RAM | mindestens 1 GB | | Speicherplatz | ca. 1 GB frei | | Benutzerrechte | sudo oder Root | | Netzwerk | Internetzugang für den Download | | Docker (optional) | Für Self-Hosting Variante |

Schritt 1: System aktualisieren

Zuerst dein System auf den neuesten Stand bringen:

``bash sudo apt update && sudo apt upgrade -y ``

Schritt 2: Docker und Docker Compose installieren

Die empfohlene Methode für Self-Hosting ist Docker, da es alle Komponenten sauber isoliert.

``bash sudo apt install docker.io docker-compose -y sudo systemctl enable --now docker ``

Prüfen, ob Docker läuft:

``bash sudo docker ps ``

Schritt 3: Projektverzeichnis anlegen

Erstelle ein neues Verzeichnis, in dem dein Actual-Server liegen soll:

``bash mkdir /opt/actual && cd /opt/actual ``

Schritt 4: Docker-Compose-Datei erstellen

Erstelle eine Datei namens docker-compose.yml:

``bash sudo nano docker-compose.yml ``

Füge diesen Inhalt ein:

``yaml version: '3' services: actual-server: image: actualbudget/actual-server:latest container_name: actual-server ports: - "5006:5006" volumes: - ./data:/data restart: unless-stopped ``

  • Port 5006 ist der Standardport von Actual.
  • Das Datenverzeichnis ./data enthält später alle Budgetdaten.

Speichere mit CTRL + O und beende mit CTRL + X.

Schritt 5: Server starten

Starte den Container mit:

``bash sudo docker-compose up -d ``

Prüfe, ob alles läuft:

``bash sudo docker ps ``

Wenn du alles richtig gemacht hast, siehst du etwas wie:

`` CONTAINER ID IMAGE STATUS PORTS a1b2c3d4e5f6 actualbudget/actual-server Up 10 seconds 0.0.0.0:5006->5006/tcp ``

Schritt 6: Weboberfläche aufrufen

Öffne nun deinen Browser und gehe auf:

`` http://:5006 ``

Beispiel:

`` http://192.168.1.50:5006 ``

Du siehst die Startseite von Actual – schlicht, modern und ohne Werbung.

Schritt 7: Konto anlegen und Budget starten

  1. Klicke auf „Start Local File“, um ein lokales Budget zu erstellen.
  2. Gib deinem Budget einen Namen, z. B. Mein Haushalt.
  3. Wähle, ob du lokal arbeitest oder dich später mit einem Sync-Server verbinden möchtest.
  4. Erstelle deine ersten Konten (z. B. Girokonto, Kreditkarte).
  5. Beginne, Kategorien zu definieren (z. B. Lebensmittel, Miete, Freizeit).

Das Besondere: Du kannst nur Geld „budgetieren“, das du wirklich besitzt – das Konzept nennt sich Envelope Budgeting (Umschlagmethode).

Schritt 8: (Optional) End-to-End-Sync zwischen Geräten

Möchtest du Actual auf mehreren Geräten synchronisieren (z. B. Laptop + Smartphone), geht das über den integrierten Sync-Server.

  1. In den Einstellungen (Settings → Sync) siehst du die Server-URL:

`` http://:5006 ``

  1. Optional kannst du ein Passwort und Verschlüsselung aktivieren.
  2. Gib auf dem zweiten Gerät dieselbe Serveradresse ein.
  3. Nach wenigen Sekunden werden beide Instanzen synchronisiert.

Alle Daten bleiben auf deinem Server – keine Cloud!

Schritt 9: Sicherung (Backup)

Um deine Budgetdaten zu sichern, kannst du das data-Verzeichnis regelmäßig exportieren:

``bash sudo tar czf actual-backup.tar.gz /opt/actual/data ``

Oder automatisch via Cronjob:

``bash crontab -e ``

Einfügen:

`` 0 2 * tar czf /opt/actual/backup-$(date +\%F).tar.gz /opt/actual/data ``

Das erstellt jeden Tag um 2 Uhr nachts ein Backup.

Schritt 10: Logs prüfen & Container aktualisieren

Logs anzeigen:

``bash sudo docker-compose logs -f ``

Update durchführen:

``bash cd /opt/actual sudo docker-compose pull sudo docker-compose up -d ``

Der Server startet automatisch mit der neuen Version.

Schritt 11: Erste Schritte im Budget

Jetzt wird’s spannend! Du kannst beginnen, deine Finanzen strukturiert zu verwalten:

  • Einnahmen und Ausgaben erfassen
  • Kategorien zuweisen
  • Monatsweise Budgets planen
  • Berichte und Diagramme ansehen

Alles läuft in deinem Browser — schnell, offlinefähig und modern.

Tipps & Tricks

  • Dark Mode aktivieren: In den Einstellungen unter „Theme“.
  • CSV-Import: Du kannst Bankdaten aus CSV-Dateien importieren.
  • Shortcuts: Ctrl + K öffnet die Befehlsleiste.
  • Selbst hosten im LAN: Füge eine lokale Domain über NGINX hinzu, z. B. https://budget.meinserver.de.

Mit Actual Budget holst du dir ein vollwertiges, modernes Budget-Tool auf deinen eigenen Server – ganz ohne Cloudabhängigkeit oder Gebühren. Die Docker-Variante macht die Installation kinderleicht, und dank des „local-first“-Prinzips behältst du volle Kontrolle über deine Finanzen.

Ideal für:

  • Privatanwender, die Datenschutz ernst nehmen
  • Familien- oder Haushaltsbudgets
  • Selbstständige, die Einnahmen und Ausgaben tracken wollen

Nützliche Links