o

Cronjob.de › Anleitungen › Firefly III

Firefly III Cronjob einrichten: wiederkehrende Buchungen anlegen

Firefly III legt wiederkehrende Buchungen nicht selbst an. Es wartet auf einen täglichen Anstoß von außen – bei einer Installation im Container ist das der übliche Weg. Diese Anleitung zeigt ihn.

Warum überhaupt

Die Miete bucht sich nicht von allein

Eine wiederkehrende Buchung in Firefly III ist eine Vorlage mit einem Datum. Damit daraus eine echte Buchung wird, muss der Cron-Lauf sie anlegen. Bleibt er aus, steht die Miete zwar als geplant in der Übersicht, aber sie erscheint nie auf dem Konto.

Dasselbe gilt für drei weitere Dinge: die automatischen Budgets, die zum Monatsanfang neu gefüllt werden, die Warnungen zu fälligen Verträgen und die Wechselkurse für Konten in fremder Währung.

Wer Firefly III als Container betreibt, hat oft gar keine Kommandozeile zur Hand, auf der ein klassischer Cron laufen könnte. Genau dafür gibt es die Adresse.

Aufzurufende Adresse
https://ihre-domain.de/api/v1/cron/IHRTOKEN
Empfohlenes Intervall
einmal täglich
Getestet mit
Firefly III 5.x, 6.x
Ausreichender Tarif
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 setzen – genau 32 Zeichen

    Tragen Sie in Ihrer .env beziehungsweise in den Umgebungsvariablen des Containers STATIC_CRON_TOKEN ein. Firefly III verlangt exakt 32 Zeichen; ein kürzerer oder längerer Wert wird abgelehnt. Danach die Anwendung neu starten.

    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, in der zu jedem Teil "job_fired": true steht.

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

  3. Konto bei Cronjob.de anlegen

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

  4. Cronjob anlegen, einmal täglich

    Nachts um drei ist eine gute Wahl: die wiederkehrenden Buchungen des Tages stehen dann früh am Morgen bereits im Konto.

    0 3 * * *

  5. Fehler-Benachrichtigung einschalten

    Hinterlegen Sie in den Einstellungen des Ordners eine E-Mail-Adresse. Eine fehlende Buchung fällt in einer Haushaltsübersicht sonst erst beim Abgleich auf.

Kontrolle

Läuft es wirklich?

Im Aufrufprotokoll von Cronjob.de steht die JSON-Antwort mit "job_fired": true und "job_succeeded": true für jeden Teil. In Firefly III selbst sehen Sie unter „Automatisierung → Wiederkehrende Buchungen“ bei jeder Vorlage, wann sie zuletzt angewendet wurde.

FAQ

Häufige Fragen zu Firefly III

Was passiert bei zwei Aufrufen am selben Tag?
Nichts Doppeltes. Firefly III merkt sich je Aufgabe den Tag der letzten Ausführung und überspringt sie beim zweiten Aufruf. Die Dokumentation sagt ausdrücklich, dass mehrere Läufe unbedenklich sind – Sie können also gefahrlos häufiger aufrufen, wenn Sie einen ausgefallenen Lauf nachholen wollen.
Mein Token wird nicht angenommen.
Fast immer stimmt die Länge nicht. Es müssen genau 32 Zeichen sein. Prüfen Sie auch, ob die Umgebungsvariable nach dem Neustart wirklich angekommen ist – bei Docker Compose braucht es dafür ein docker compose up -d, ein Neustart des Containers allein reicht nicht immer.
Ist das Token in der Adresse nicht unsicher?
Es ist der von Firefly III vorgesehene Weg und es kann damit nur der Cron-Lauf ausgelöst werden – Ihre Daten sind darüber nicht lesbar. Wer trotzdem vorsichtig sein will, erneuert das Token gelegentlich; es steht ja nur an einer Stelle.
Ich bekomme 404 auf die Adresse.
Dann sitzt die Installation in einem Unterordner oder der Webserver reicht den Pfad nicht durch. Prüfen Sie, ob /api/v1/about antwortet. Kommt auch dort 404, liegt es an der Konfiguration des Webservers, nicht am Cronjob.
Brauche ich das auch für den Data Importer?
Das ist ein eigener Dienst mit einer eigenen Adresse und einem eigenen Token. Wenn Sie Kontoumsätze automatisch einlesen lassen, richten Sie dafür einen zweiten Cronjob ein.

Cronjob jetzt anlegen

Konto anlegen, Adresse eintragen, Zeitplan anklicken. Drei 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 September 2026. Bitte prüfen Sie dort, ob sich inzwischen etwas geändert hat.