Zum Hauptinhalt springen

Dokumentation Hilfe & Referenz

Fehlerbehebung & FAQ

Was zu tun ist, wenn ein Lauf fehlschlägt, eine Website die Wartungsseite zeigt, ein Zertifikat oder Backup Aufmerksamkeit braucht oder ein API-Aufruf abgelehnt wird, dazu häufige Fragen und wie Sie uns erreichen.

Aktualisiert 20.10.2026

Ausführungen und Deployments

Eine Bereitstellung, ein Update oder eine andere Ausführung ist fehlgeschlagen

Öffnen Sie die App und ihr Menü Vorgänge. Der Tab Workflows listet alle Ausführungen der App auf, die neueste zuerst. Öffnen Sie die fehlgeschlagene: Ihre Seite zeigt jeden Schritt, markiert den fehlgeschlagenen und nennt den Grund für den Abbruch. Häufige Ursachen sind ein Branch oder Commit, der sich nicht bauen lässt, ein Modul, das sich nicht installieren oder aktualisieren lässt, oder eine fehlende Abhängigkeit.

Beheben Sie die Ursache und klicken Sie dann im Kopfbereich der App auf Wiederholen. Wiederholen erscheint, solange die App im Status Fehler oder Abgebrochen ist, und startet die fehlgeschlagene Ausführung erneut. Wenn bereits eine neuere Ausführung der App begonnen hat, kann die alte nicht mehr wiederholt werden: Ihre Seite weist darauf hin und bietet Letzten Lauf öffnen an.

Eine als Wird wiederholt markierte Ausführung ist einmal fehlgeschlagen und wird automatisch wiederholt. Warten Sie, bis sie abgeschlossen ist, bevor Sie selbst auf Wiederholen klicken.

"… nicht möglich, während '…' läuft"

Manche Aktionen warten, bis die App im Leerlauf ist: ein Neustart, eine Modulaktualisierung, das Ein- oder Ausschalten des Wartungsmodus und Änderungen über die API. Wird eine davon mit einer Meldung wie v19-0 kann nicht neu gestartet werden, während 'ein Backup' läuft abgelehnt, läuft auf der App noch etwas anderes. Verfolgen Sie es unter Vorgänge und versuchen Sie es erneut, sobald es abgeschlossen ist. Über die API, cw oder einen KI-Assistenten lautet dieselbe Ablehnung Nicht jetzt: … läuft auf der App.

Ich habe eine Einstellung geändert, aber nichts ist passiert

Wenn Sie eine Einstellung im Tab Konfigurationen der App speichern, wird sie gespeichert; die laufende App übernimmt sie erst, wenn die Änderung angewendet wird:

Was Sie geändert habenWodurch es angewendet wird
Benutzerdefinierte Umgebungsvariablen, Datenbank-Manager erlaubt, Suchindexierung und die anderen TLS- und Routing-EinstellungenKonfiguration anwenden in den Aktionen der App. Damit wird die Konfiguration aktualisiert und die App neu gestartet.
Der Odoo-Konfigurations-PatchEine neue Bereitstellung: Build → Bereitstellen. Ein Update allein wendet es nicht an.
Zusätzliche PaketeDas nächste Deployment der App, das ihr Image einmal neu baut.
Code auf den Branches der AppBuild → Aktualisieren oder Schnell-Update für eine Code-Aktualisierung, ohne das Image neu zu bauen.

Eine fehlerhafte Änderung rückgängig machen

Jede Änderung an einer App zeichnet zuerst einen Wiederherstellungspunkt auf. Öffnen Sie das Menü Wiederherstellungspunkte der App und setzen Sie den Code, die Daten oder beides zurück. Siehe Bereitstellungen & Rollback.

Ihre Website und Zertifikate

Besucher sehen eine Wartungsseite

Die Adresse der App zeigt in zwei Fällen eine Wartungsseite: Der Wartungsmodus ist eingeschaltet, oder die App läuft nicht (sie wurde gestoppt, ist abgestürzt oder startet gerade neu). Öffnen Sie die App und prüfen Sie ihren Status. Ist der Wartungsmodus eingeschaltet, verwenden Sie Wartung deaktivieren in den Aktionen der App. Befindet sich die App in einem Fehlerzustand, lesen Sie ihre letzte Ausführung unter Vorgänge, wie oben beschrieben.

Der Browser warnt vor dem Zertifikat

Die Plattform stellt die HTTPS-Zertifikate Ihrer Apps selbst aus und erneuert sie, sobald eine Adresse auf den Server der App zeigt. Bei einer neuen Adresse kann es nach dem Erscheinen ihres DNS-Eintrags einige Minuten dauern. Wenn die Warnung bestehen bleibt:

  • Verwenden Sie SSL erneuern in den Aktionen der App. Damit werden die Routen aller Adressen der App neu eingerichtet, sodass der Router ihre Zertifikate erneut anfordert.
  • Mit dem White-Label-Add-on zeigt der Tab URLs der App für jede Adresse das Zertifikat, wann es abläuft und ob die öffentliche Prüfung die Adresse als Antwortet erkennt. SSL prüfen liest das Zertifikat erneut, und Traefik-Route aktualisieren richtet die Route der Adresse neu ein.

Ein Zertifikat wird als bald ablaufend angezeigt, wenn es noch 14 Tage oder weniger gilt, was normalerweise bedeutet, dass seine Erneuerung fehlgeschlagen ist. Die Warnung Zertifikat läuft ab informiert Sie ebenfalls, bevor es abläuft.

Meine eigene Domain öffnet die App nicht

Adressen auf Ihrer eigenen Domain erfordern das Add-on White Label: Fügen Sie sie auf der Registerkarte URLs der App mit Benutzerdefinierte URL hinzufügen hinzu und stellen Sie sicher, dass der DNS-Eintrag der Domain auf den Server der App zeigt. Ein neuer Eintrag kann ein paar Minuten brauchen, bis er überall ankommt.

Backups und Wiederherstellungen

"Produktions-Backup(s) kritisch oder fehlend"

Die Übersicht zeigt dies an, wenn eine Produktions-App zu lange kein erfolgreiches Backup hatte. Es zählen nur Apps, bei denen Automatisches Backup aktiviert ist. Eine App wechselt nach 36 Stunden ohne Backup auf Warnung und nach 48 auf kritisch.

Öffnen Sie das Menü Backups der App und klappen Sie das neueste Backup auf: Ein fehlgeschlagenes nennt den Grund. Klicken Sie darauf auf Wiederholen, sobald die Ursache behoben ist. Eine häufige Ursache ist zu wenig freier Speicherplatz auf dem eigenen Server der App; mit externem Speicher werden die Backups von dort verlagert. Siehe Backups & Wiederherstellung.

Eine Wiederherstellung dauert lange

Eine große Datenbank oder ein großer Filestore kann eine Weile dauern. Während die Wiederherstellung läuft, zeigt ihre Karte in der Zeile Jetzt, was gerade geschieht, und der Logger der App enthält das vollständige Wiederherstellungsprotokoll unter der Quelle restore. In einem Terminal zeigt cw logs v19-0 --source restore --follow dasselbe Protokoll, während es wächst.

Zugriff und Plätze

"Das Hinzufügen dieses Benutzers würde das Platzkontingent des Namespace '…' überschreiten"

Ihr Workspace hat alle seine Plätze belegt. Geben Sie einen Platz frei, indem Sie unter Einstellungen → Team & Zugriff jemanden deaktivieren, den Sie nicht mehr brauchen, kaufen Sie ein Add-on Zusätzlicher Platz unter Einstellungen → Abrechnung & Tarife, oder stellen Sie ein Projekt auf einen Tarif mit mehr Plätzen um. Tarife addieren sich nicht: Ein Workspace hat die Plätze seines größten Tarifs. Siehe Abrechnung & Preise.

Ein Teammitglied sieht ein Projekt nicht oder kann eine Schaltfläche nicht drücken

Zugriff wird pro Workspace vergeben, und was eine Person tun darf, hängt von ihrer Ebene und von der Umgebung ab. Ein Entwickler kann zum Beispiel in der Entwicklung bereitstellen, aber nicht in der Produktion. Ein Admin legt die Ebenen unter Einstellungen → Team & Zugriff fest. Siehe Berechtigungen & Zugriff.

Ich kann kein Terminal auf einem Server öffnen

Eine Terminal- oder SSH-Sitzung auf einem Produktionsserver erfordert die Ebene Maintainer, auf anderen Servern die Ebene Entwickler Plus. Betrachter können sich nicht mit Servern verbinden. Das Dashboard öffnet nie eine Sitzung als root: siehe Root-Zugriff.

Ein Menü zeigt ein Schloss

Der Tarif des Projekts enthält diese Funktion nicht. Automatisierte Deployments, Backups und Warnungen erfordern einen kostenpflichtigen Tarif, eigene URLs erfordern White Label. Siehe Abrechnung & Preise.

Ich habe mein Passwort vergessen

Verwenden Sie Passwort zurücksetzen auf der Anmeldeseite, um per E-Mail einen Link zum Zurücksetzen zu erhalten.

Fehler bei API, cw und KI-Assistenten

Jede Ablehnung liefert einen Code und eine Meldung, die sagt, was zu tun ist. Die häufigsten:

StatusBedeutet meist
401Das Token fehlt, wurde widerrufen oder ist abgelaufen. Erstellen Sie ein neues unter Meine Einstellungen → API-Tokens.
403Das Token besitzt diese Funktion nicht, Ihre Ebene erlaubt sie in dieser Umgebung nicht, der Tarif des Projekts enthält sie nicht, oder Änderungen über die API sind für Ihr Konto noch nicht freigegeben.
409Nicht jetzt: Auf der App läuft gerade etwas, die App wurde noch nicht deployt, oder die Ausführung kann nicht wiederholt werden (die Meldung nennt den Grund).
429Zu viele Anfragen: 120 pro Minute und Token sowie 10 Änderungen pro Minute. Warten Sie einen Moment und versuchen Sie es erneut.

Jeder Code steht in der Fehlercode-Referenz; Tokens werden erklärt in API, CLI & KI-Assistenten.

FAQ

Welche Odoo-Versionen kann ich betreiben?

Odoo 14.0 und neuer, Community oder Enterprise. Beides wählen Sie beim Erstellen einer App aus den Versionen, die der Erstellungsassistent anbietet. Eine App behält ihre Version, sobald sie deployt ist.

Gehören meine Server und meine Daten mir?

Server, die Sie über Ihren verbundenen Cloud-Anbieter erstellen, liegen in Ihrem eigenen Cloud-Konto, und Ihre Backups können auf Speicher kopiert werden, der Ihnen gehört. Terminal- und SSH-Zugriff auf Ihre Server erhalten Sie entsprechend Ihrer Ebene, root mit Ihrem eigenen SSH-Schlüssel.

Wie funktionieren automatische Backups?

Jede App hat einen Schalter Automatisches Backup auf ihrer Registerkarte Übersicht → Automatisierung, in Produktion standardmäßig aktiviert. Apps, bei denen er aktiviert ist, werden einmal pro Nacht zwischen 00:00 und 05:00 UTC gesichert. Eine App behält ihre 5 neuesten nächtlichen Backups und danach drei Wochen lang eines pro Woche; Backups, die Sie selbst erstellen, werden 30 Tage aufbewahrt.

Was ist der Unterschied zwischen einem Projekt und einer Umgebung?

Ein Projekt gruppiert Ihre Umgebungen (Produktion, Staging, Entwicklung), und jede Umgebung betreibt ihre eigenen Apps. Siehe das Glossar.

Kann ich von Odoo.sh umziehen?

Ja: siehe Migration von Odoo.sh.

Hilfe erhalten

Wenn diese Seite das Problem nicht gelöst hat, schreiben Sie uns. Mit den unten genannten Angaben erhalten Sie schneller eine Antwort.

Was Sie angeben sollten: den Workspace, das Projekt und die App, was Sie erwartet haben und was passiert ist, und bei einem fehlgeschlagenen Lauf dessen Nummer aus Vorgänge und den Grund, den sein fehlgeschlagener Schritt nennt.

War diese Seite hilfreich?

Ihre Antwort hilft uns, Verbesserungen an der Dokumentation zu priorisieren.

Danke — Ihr Feedback hilft uns, besser zu werden.