# Wenn etwas nicht klappt

Die typischen Stolperstellen beim Einstieg lassen sich meist selbst prüfen, und wenn das nicht reicht, hilft der Support.

> Source: https://www.application-platform.com/de/docs/get-help/

Verbindet sich ein Remote-Workspace nicht, hilft die [Fehlerbehebung]({{< relref "workspace-vm-troubleshooting" >}}) der Workspaces.

## Die Pipeline ist rot

Öffne in GitLab unter **CI/CD → Pipelines** den rot markierten Job; die Fehlermeldung steht meistens am Ende seines Logs und lässt sich oft lokal mit `ap run-local` nachstellen. Behebe die Ursache und pushe erneut, ohne `.gitlab-ci.yml` zu ändern; hilft das Log nicht, schick den Pipeline-Link an den Support, und den Aufbau erklärt [Was sind Pipelines?]({{< relref "what-are-pipelines" >}}).

## Die Seite ist nicht erreichbar

Prüfe, ob die letzte Pipeline erfolgreich war, ob dem Projekt ein Server zugewiesen ist und ob für Produktion der manuelle Produktions-Job gestartet wurde. Funktioniert die Dev-Adresse, aber nicht deine Domain, fehlt meist der Haken unter **Domains** in der Spalte **Status**; vergleiche dann die DNS-Einträge mit denen bei deinem Domain-Anbieter, siehe [DNS konfigurieren]({{< relref "domain-how-to" >}}).

## Der Agent meldet, dass du nicht angemeldet bist

Gib `ap login` ein, prüfe mit `ap whoami` deinen Account und wiederhole die Anfrage. Fehlt der MCP-Server `application-platform`, wiederhole die Installation aus [Mit einem KI-Agenten arbeiten]({{< relref "work-with-ai-agents" >}}) und lade den Editor neu; wird `ap` nicht gefunden, fehlt die ap CLI von der [Downloads-Seite]({{< relref "/downloads" >}}).

## Die Anwendung startet nicht

Bricht `ap run-local` wegen eines belegten Ports ab, beende den alten Prozess oder Docker-Container; fehlt eine Laufzeit trotz Installation, stehst du nicht im Repository-Ordner mit der passenden `.tool-versions`. Fehlende Werkzeuge zeigen `ap doctor` und das **Entwickler-Setup** der Setup-App; weitere Punkte stehen unter [Projekt öffnen und starten]({{< relref "open-and-run" >}}).

## Support und Feedback

Die [Support-Seite]({{< relref "/support" >}}), in der Plattform unter **Mehr** → **Hilfe**, bietet ein Formular und eine deutsche und eine englische WhatsApp-Gruppe; wir antworten in der Regel innerhalb eines Werktags. Nenne Organisation, Projekt, Erwartung und tatsächliches Verhalten, am besten mit Fehlermeldung oder Pipeline-Link, aber ohne Passwörter oder Zugangsdaten.

Wünsche und Hinweise auf unklare Stellen in der Dokumentation nimmt die [Feedback-Seite]({{< relref "/feedback" >}}) entgegen.