Markdown

Für Einsteiger

Wenn etwas nicht klappt

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

Auf dieser Seite

Verbindet sich ein Remote-Workspace nicht, hilft die Fehlerbehebung 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?.

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.

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 und lade den Editor neu; wird ap nicht gefunden, fehlt die ap CLI von der Downloads-Seite.

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.

Support und Feedback

Die Support-Seite, in der Plattform unter MehrHilfe, 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 entgegen.