Bank mit Ghostfolio synchronisieren: automatische EU/UK-Salden

Ghostfolio ist ein schönes, selbst hostbares Dashboard, um Ihr Nettovermögen und Ihre Investments zu verfolgen. Doch es gibt eine Lücke: Bank- und Bargeldkonten sind manuell. Sie geben einen Saldo ein und aktualisieren ihn von Hand, wann immer Sie daran denken. Wenn Sie neben Ihrem Portfolio auch Spar- und Girokonten haben, ist Ihr Nettovermögen immer ein wenig veraltet.

Diese Anleitung behebt das. Mit open-banking.io und einer kleinen quelloffenen Bridge können Sie Ihre echten EU/UK-Bankguthaben automatisch in Ghostfolio holen — von über 2.600 Banken, ohne PSD2-/eIDAS-Zertifikat und mit Zero-Knowledge-Verschlüsselung, sodass Ihre Transaktionsdaten lokal mit einem Schlüssel entschlüsselt werden, den nur Sie besitzen.

Sie läuft vollständig neben Ghostfolio über dessen öffentliche API — ohne Änderungen am Ghostfolio-Kern. Der Ghostfolio-Maintainer hat genau diesen Ansatz in Diskussion #7308 vorgeschlagen, und dies ist das Tool, das ihn umsetzt.

Was Sie benötigen

  • Eine laufende Ghostfolio-Instanz (selbst gehostet oder ghostfol.io).
  • Ein open-banking.io-Konto mit mindestens einer verbundenen Bank. Die Preise beginnen bei etwa 3 €/Monat und sinken, während die Nutzerbasis wächst.
  • Node.js 20+ (oder Docker).

So funktioniert es

open-banking.io ──(balances, decrypted locally)──► sync bridge ──(POST /api/v1/account-balance)──► Ghostfolio

open-banking.io ist Ende-zu-Ende-verschlüsselt: Der Dienst speichert nur Chiffretext, den er nicht lesen kann. Die Bridge entschlüsselt Ihre Salden auf Ihrem eigenen Rechner mit dem privaten Schlüssel aus Ihrem Zugangsdaten-Bundle und schreibt sie dann über die dokumentierte öffentliche API in Ghostfolio — genau so, wie es ein Nutzer mit einem Security Token tun würde. Ihr Schlüssel und Ihr Klartext verlassen niemals Ihren Rechner.

Schritt 1 — Bank verbinden und Zugangsdaten exportieren

Verbinden Sie in der open-banking.io-App Ihre Bank(en) und exportieren Sie dann Ihre credentials.json (sie enthält Ihren API key und Ihren Verschlüsselungsschlüssel). Halten Sie diese Datei privat — sie ist der Schlüssel zu Ihren Daten.

Schritt 2 — Ghostfolio Security Token abrufen

Öffnen Sie in Ghostfolio die Einstellungen und kopieren Sie Ihr Security Token. Damit authentifiziert sich die Bridge gegenüber der API von Ghostfolio.

Schritt 3 — Bridge installieren

git clone https://github.com/open-banking-io/ghostfolio-openbanking-sync
cd ghostfolio-openbanking-sync
npm install
npm run build

Lieber Docker? Springen Sie unten zu Mit Docker automatisieren.

Schritt 4 — Konfigurieren

Erstellen Sie eine config.json:

{
  "ghostfolio": {
    "host": "https://your-ghostfolio-host",
    "securityToken": "your-security-token"
  },
  "openBanking": { "credentials": "./credentials.json" },
  "accounts": []
}

Schritt 5 — Ihre Konten ermitteln

Führen Sie --list aus, um Ihre open-banking.io-Konten und Ihre Ghostfolio-Konten nebeneinander zu sehen:

node dist/cli.js --config config.json --list

Sie erhalten etwa Folgendes:

open-banking.io accounts:
  id=ob-abc123  Drift (…4927)  828.13 EUR [ITBD]
Ghostfolio accounts:
  id=gf-def456  Checking  0 EUR

Fügen Sie dem "accounts"-Array Ihrer Konfiguration pro Konto eine Zuordnung hinzu:

{ "openBankingId": "ob-abc123", "ghostfolioAccountId": "gf-def456" }

Sie haben noch keine Ghostfolio-Konten? Lassen Sie das Tool pro Bankkonto automatisch eines anlegen:

node dist/cli.js --config config.json --create

Es gibt die Zuordnungszeilen aus, die Sie zurück in Ihre Konfiguration einfügen.

Schritt 6 — Synchronisieren

Zunächst eine Vorschau (es wird nichts geschrieben):

node dist/cli.js --config config.json --dry-run

Führen Sie es dann tatsächlich aus:

node dist/cli.js --config config.json

- Drift (…4927): set 828.13 EUR [ITBD @ 2026-07-18] → gf-def456

Done: 1 balance snapshot(s) written to Ghostfolio.

Ihr Ghostfolio-Bargeldkonto spiegelt nun Ihren echten Bankguthaben wider. Fügen Sie --refresh hinzu, um open-banking.io zu bitten, zuerst frische Daten von der Bank abzurufen.

Die Bridge bevorzugt gebuchte Salden (CLBD/ITBD) gegenüber verfügbaren, sodass Ghostfolio abgerechnetes Geld widerspiegelt. Sie können dies pro Konto mit "balanceType": "ITAV" überschreiben.

Mit Docker oder cron automatisieren

Halten Sie Salden automatisch aktuell. Mit Host-cron:

0 6 * * *  cd /opt/gf-sync && node dist/cli.js --config config.json --refresh >> sync.log 2>&1

Oder mit Docker Compose (synchronisiert alle 24 h):

mkdir -p data && cp config.example.json data/config.json   # then edit it
docker compose -f docker-compose.example.yml up -d

Ein vorgefertigtes Image wird unter ghcr.io/open-banking-io/ghostfolio-openbanking-sync veröffentlicht.

Datenschutz, in einem Absatz

Ihre Bankdaten sind in einem Umschlag pro Feld versiegelt (ECDH-P256 → HKDF-SHA256 → AES-256-GCM), den nur Ihr privater Schlüssel öffnen kann. open-banking.io hält Chiffretext; die Bridge entschlüsselt auf Ihrem Rechner; Ghostfolio erhält nur die Zahlen, die Sie zu synchronisieren wählen (Salden). Das Tool ist MIT-lizenziert und quelloffen — lesen Sie jede Zeile auf github.com/open-banking-io/ghostfolio-openbanking-sync.

Warum open-banking.io

  • Über 2.600 EU/UK-Banken — einschließlich des langen Endes, das Plaid/Aggregatoren auslassen.
  • Keine Zertifikate. Keine PSD2-Lizenz, kein eIDAS-QWAC. Sie verbinden sich mit einer Zugangsdaten-Datei, Punkt.
  • Zero-Knowledge. Der Dienst kann Ihre Transaktionen nicht lesen; nur Sie können es.
  • Ab ca. 3 €/Monat, kalkuliert für Privatpersonen und Selbsthoster, nicht für Unternehmen.

Legen Sie mit open-banking.io los →