Dolibarr Cronjob einrichten: geplante Aufgaben ausführen

Einrichtung

Schritt für Schritt

1. Modul einschalten und die Adresse kopieren

   Unter Start → Einstellungen → Module/Anwendungen schalten Sie „Geplante Jobs“ ein und öffnen das Zahnrad daneben. Dort steht der „Sicherheitsschlüssel für URL zum Starten von Cron-Jobs“. Über das Symbol daneben können Sie einen Zufallswert erzeugen lassen; danach speichern Sie. Darunter zeigt Dolibarr die fertige „URL zum Überprüfen und Starten qualifizierter Cron-Jobs über einen Browser“. Kopieren Sie diese Adresse vollständig.

   https://ihre-domain.de/public/cron/cron_run_jobs_by_url.php?securitykey=IHRSCHLUESSEL&userlogin=admin

2. Adresse einmal im Browser prüfen

   Rufen Sie die Adresse einmal selbst auf. Richtig ist eine Textausgabe, die mit „Result:“ endet, etwa Result: 3 jobs - 1 launched = 1 OK + 0 KO. „Securitykey is wrong.“ heißt: Der Schlüssel stimmt nicht. Bei Fehler 404 stimmt der Pfad nicht; bei manchen Installationen liegt Dolibarr in einem Unterordner /htdocs/. Ältere Anleitungen nennen noch cron_run_jobs.php. Diese Datei gibt es seit Dolibarr 14 nicht mehr.

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 mit dieser Adresse anlegen

   Fügen Sie die Adresse ein und wählen Sie einen Takt von fünf Minuten. Diesen Takt nennt auch das Dolibarr-Wiki. Sie können auch einfach den Satz „alle 5 Minuten“ eingeben, der Zeitplan wird dann für Sie gesetzt.

   */5 * * * *

   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. Bleiben wiederkehrende Rechnungen unbemerkt liegen, fällt das oft erst auf, wenn ein Kunde nachfragt. 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 Dolibarr öffnen Sie Start → Admin-Tools → Geplante Jobs. Bei jedem Job stehen „Startdatum der letzten Ausführung“ und „Nächste Ausführung“. Beide sollten sich nach wenigen Minuten bewegen. Ab Plus zeigt das Aufrufprotokoll von Cronjob.de zusätzlich die Ausgabe jedes Laufs, also die „Result“-Zeile mit der Zahl der gestarteten Jobs.

FAQ

Häufige Fragen zu Dolibarr

Wie oft muss der Dolibarr-Cronjob laufen?

Alle fünf Minuten, so steht es im Dolibarr-Wiki. Der Aufruf prüft nur, welche Jobs fällig sind, und startet diese. Der kurze Takt sorgt dafür, dass ein für 8:00 Uhr geplanter Job auch kurz nach 8 läuft und nicht viel später.

Der Schlüssel steht in der Adresse. Ist das ein Problem?

Behandeln Sie ihn wie ein Passwort: Wer ihn kennt, kann Ihre geplanten Jobs auslösen. Dolibarr sieht die Adresse so vor. Zwei Dinge helfen: einen langen Zufallswert verwenden (das Symbol neben dem Feld erzeugt einen) und ihn bei Verdacht erneuern. Danach muss die neue Adresse auch bei Cronjob.de eingetragen werden.

Wozu dient der Parameter userlogin?

Dolibarr führt die Jobs im Namen dieses Benutzers aus. Die Adresse in den Moduleinstellungen enthält den Benutzer, mit dem Sie gerade angemeldet sind. Nehmen Sie einen Benutzer mit den nötigen Rechten. Gibt es den Benutzer nicht, meldet Dolibarr „User login: … do not exists“.

Ich bekomme „Securitykey is wrong.“

Der Schlüssel in der Adresse passt nicht zu dem im Modul. Häufige Ursache ist ein abgeschnittener Wert beim Kopieren. Kopieren Sie die Adresse noch einmal vollständig aus den Moduleinstellungen. Fehlt der Schlüssel ganz, lautet die Meldung „Securitykey is required.“

Kann ich einen einzelnen Dolibarr-Job gezielt anstoßen?

Ja. Hängen Sie &id= mit der Nummer des Jobs an die Adresse. Dolibarr zeigt dafür in den Moduleinstellungen eine zweite Adresse an. Das ist praktisch, wenn ein Job einen anderen Takt braucht als der Rest. Legen Sie dafür einen zweiten Cronjob an.