Cronjob.de › Anleitungen › Firefly III

Firefly III Cronjob einrichten: wiederkehrende Buchungen anlegen

Für Firefly III rufen Sie einmal täglich /api/v1/cron/ mit Ihrem Token auf, die offizielle Doku nimmt dafür 3 Uhr nachts. Als Token dient der „Command line token“ aus Ihrem Profil oder ein selbst gesetzter STATIC_CRON_TOKEN mit genau 32 Zeichen. Bei Cronjob.de tragen Sie nur diese Adresse ein, einen eigenen Cron-Container brauchen Sie nicht.

Stand:

Warum überhaupt

Die Miete bucht sich nicht von allein

Laut Firefly-III-Doku funktionieren einige Funktionen nur mit laufendem Cronjob: automatische Budgets, wiederkehrende Buchungen, Warnungen zu Abonnements und aktuelle Wechselkurse. Eine wiederkehrende Buchung ist zunächst nur eine Vorlage. Zur echten Buchung wird sie erst, wenn der Cron-Lauf sie anlegt.

Bleibt der Lauf aus, steht die Miete zwar als geplant in der Übersicht, erscheint aber nicht auf dem Konto. Firefly III weist auf der Seite der wiederkehrenden Buchungen selbst darauf hin, wenn der Cronjob noch nie oder seit mehr als 36 Stunden nicht gelaufen ist.

Das Docker-Abbild von Firefly III enthält laut Doku keinen Cron. Die Doku schlägt deshalb einen eigenen Cron-Container vor oder einen Aufruf der Adresse von außen. Genau diesen Aufruf übernimmt Cronjob.de.

Aufzurufende Adresse
https://ihre-domain.de/api/v1/cron/IHRTOKEN
Empfohlenes Intervall
einmal täglich
Getestet mit
Firefly III 6.x (6.7.9)
Ausreichender Tarif bei Cronjob.de
Der kostenlose Tarif genügt.

Einrichtung

Schritt für Schritt

Kürzer geht es mit der KI

Sie müssen nichts davon selbst übertragen. Kopieren Sie diese Anleitung – oder die Ihres eigenen Systems – in den Assistenten, und Cronjob.de füllt Adresse, Methode, Zeitplan und Kopfzeilen aus. Bei Unklarheiten fragt er nach, statt zu raten. Am Ende sehen Sie, was eingetragen wurde, und legen den Job mit einem Klick an.

Im kostenlosen Tarif enthalten, ohne Aufpreis. Zu finden nach dem Anmelden unter „Cronjobs“ → „Mit KI anlegen“.

  1. Token wählen

    Der einfachste Weg: Öffnen Sie in Firefly III Ihr Profil (/profile) und kopieren Sie den Wert unter „Command line token“. Alternativ setzen Sie in der .env oder in den Umgebungsvariablen des Containers STATIC_CRON_TOKEN. Dieser Wert muss genau 32 Zeichen lang sein, sonst nimmt Firefly III ihn nicht an. Nach einer Änderung an der .env starten Sie die Anwendung neu.

    STATIC_CRON_TOKEN=abcdefghij0123456789abcdefghij01

  2. Adresse einmal im Browser prüfen

    Das Token gehört in den Pfad, nicht als Parameter dahinter. Richtig ist eine JSON-Antwort mit Abschnitten wie recurring_transactions, auto_budgets und bill_notifications. Beim ersten Lauf steht dort "job_fired": true.

    https://ihre-domain.de/api/v1/cron/abcdefghij0123456789abcdefghij01

  3. Konto bei Cronjob.de anlegen

    Die Registrierung dauert eine Minute und ist kostenlos. Fünf Cronjobs bleiben dauerhaft gratis, die ersten 14 Tage laufen im Unlimited-Tarif.

    Kostenlos starten 14 Tage Unlimited inklusive, keine Zahlungsdaten

  4. Cronjob anlegen, einmal täglich

    Die Beispiele in der Firefly-III-Doku laufen täglich um 3 Uhr. Die wiederkehrenden Buchungen des Tages stehen dann früh am Morgen im Konto. Sie können auch einfach „jeden Tag um 3 Uhr“ eingeben, der Zeitplan wird dann für Sie gesetzt.

    0 3 * * *

    Diesen Ausdruck können Sie bei Cronjob.de direkt so eintragen – das Zeitplanfeld versteht die Crontab-Schreibweise. Sie müssen sie aber nicht kennen: klicken Sie den Takt stattdessen einfach an.

  5. Fehler-Benachrichtigung einschalten

    Hinterlegen Sie unter Benachrichtigungen eine E-Mail-Adresse. Eine fehlende Buchung fällt in einer Haushaltsübersicht sonst oft erst beim Abgleich auf. Die Fehlerbenachrichtigung per E-Mail gibt es ab dem Tarif Plus, in den ersten 14 Tagen ist sie kostenlos dabei.

Was die fünf Felder eines Ausdrucks wie */5 * * * * bedeuten, steht in der Crontab-Referenz – mit Beispielen und den häufigsten Stolpersteinen. Bauen können Sie den Ausdruck im Crontab-Generator. Ob Sie dafür überhaupt einen Dienst von außen brauchen, zeigt der Vergleich der drei Wege.

Kontrolle

Läuft es wirklich?

In Firefly III öffnen Sie die Seite der wiederkehrenden Buchungen. Fehlt dort der Hinweis, dass der Cronjob nie oder seit über 36 Stunden nicht gelaufen ist, kommt der Aufruf an. Ab Plus zeigt das Aufrufprotokoll von Cronjob.de auch die JSON-Antwort mit "job_fired" und "job_succeeded" für jeden Teil.

FAQ

Häufige Fragen zu Firefly III

Wie oft muss der Firefly-III-Cronjob laufen?
Einmal täglich. Alle Beispiele in der offiziellen Doku nutzen 0 3 * * *, also 3 Uhr nachts. Häufiger bringt nichts: Ist der letzte Lauf weniger als zwölf Stunden her, überspringt Firefly III zum Beispiel die wiederkehrenden Buchungen und meldet "job_fired": false.
Was passiert bei zwei Aufrufen kurz hintereinander?
Nichts Doppeltes. Firefly III merkt sich den Zeitpunkt des letzten Laufs und führt die wiederkehrenden Buchungen frühestens nach zwölf Stunden erneut aus. Die Doku sagt außerdem, dass es in Ordnung ist, wenn mehrere Benutzer eigene Cron-Läufe einrichten.
Mein STATIC_CRON_TOKEN wird nicht angenommen.
Meist stimmt die Länge nicht. Es müssen genau 32 Zeichen sein. Prüfen Sie auch, ob die Umgebungsvariable nach dem Neustart wirklich im Container angekommen ist. Zum Test können Sie den „Command line token“ aus Ihrem Profil nehmen; klappt es damit, liegt es am statischen Token.
Ist das Token in der Adresse nicht unsicher?
Das Token in der Adresse ist der Weg, den Firefly III dafür vorsieht. Laut Doku verhindert es, dass Fremde Ihre Cron-Adresse beliebig aufrufen. Behandeln Sie es wie ein Passwort und rufen Sie die Adresse nur über https auf.
Ich bekomme 404 auf die Adresse.
Dann liegt die Installation in einem Unterordner, oder der Webserver reicht den Pfad nicht an Firefly III weiter. Prüfen Sie zuerst, ob die normale Firefly-III-Oberfläche unter derselben Adresse erreichbar ist, und hängen Sie dann /api/v1/cron/ mit dem Token an.
Brauche ich das auch für den Data Importer?
Der Data Importer ist ein eigener Dienst. Für automatische Importe hat er eigene Adressen wie /autoimport, die per POST aufgerufen werden. Dafür braucht er ein eigenes Geheimnis in AUTO_IMPORT_SECRET (mindestens 16 Zeichen) und weitere Einstellungen laut seiner Doku. Wenn Sie das nutzen, legen Sie dafür einen zweiten Cronjob an.
Ihr Server weist unsere Aufrufe ab? Ein Fehler 403 kommt fast immer von einer Firewall, einem Sicherheits-Plugin oder einem Verzeichnisschutz – nicht von Ihrem Skript. Alle unsere Aufrufe tragen die feste Kennung Cronjob.de im User-Agent. Bitten Sie Ihren Hoster um eine Ausnahme dafür; das ist zuverlässiger als eine Freigabe per IP, weil sich unsere Adressen ändern können. Adressen und Einzelheiten in den häufigen Fragen. Andere Fehler wie 401, 404 oder 500 erklärt die Fehlersuche.

Cronjob jetzt anlegen

Konto anlegen, Adresse eintragen, Zeitplan anklicken. Fünf Cronjobs sind dauerhaft kostenlos, die ersten 14 Tage laufen im Unlimited-Tarif.

Kostenlos starten Preise ansehen

Weitere Anleitungen

Offizielle Dokumentation von Firefly III

Die Angaben zu Firefly III stammen aus deren eigener Dokumentation, Stand Oktober 2026. Bitte prüfen Sie dort, ob sich inzwischen etwas geändert hat. Firefly III ist eine Marke des jeweiligen Inhabers. Diese Anleitung stammt von Cronjob.de und steht in keiner geschäftlichen Verbindung zu diesem Anbieter.

Von Joscha Schultze, Betreiber von Cronjob.de · Erstellt mit Unterstützung von KI, Angaben zu Anbietern mit deren offiziellen Seiten abgeglichen.