Website aus GitHub oder GitLab veröffentlichen

Website aus GitHub oder GitLab veröffentlichen (AI Launch)

Liegt deine Website in einem Git-Repository – etwa weil Claude Code, Cursor oder Codex sie dort pflegen –, kannst du es mit deinem Tarif AI Launch verbinden. Bei jedem Push auf den eingestellten Branch holen wir den aktuellen Stand, prüfen ihn und erstellen eine Vorschau. Live geht die neue Version erst nach deiner Freigabe – oder automatisch, wenn du das so einstellst.

Voraussetzungen und Prüfung sind dieselben wie beim Zip-Upload: AI Launch: Deine KI-Website veröffentlichen.

Einrichten

1. Öffne im Kundenbereich deinen Vertrag AI Launch → „Website veröffentlichen“ → Abschnitt „Aus Git veröffentlichen“.
2. Wähle den Anbieter (GitHub oder GitLab auf gitlab.com) und trage das Repository als besitzer/name ein, z. B. meinefirma/website. Die vollständige Adresse des Repositorys geht auch.
3. Gib den Branch an (Standard: main).
4. Liegt die fertige Website in einem Unterordner – z. B. dist oder build –, trage ihn unter „Unterordner“ ein. Sonst gilt das ganze Repository als Website.
5. Nur bei einem privaten Repository: Trage ein Zugriffstoken mit Leserecht ein (siehe unten). Es wird verschlüsselt gespeichert.
6. Entscheide, ob jeder Push automatisch veröffentlicht werden soll. Ist der Schalter aus, bekommst du bei jedem Push eine Vorschau und veröffentlichst selbst.
7. Klicke auf „Speichern“. Danach siehst du die Webhook-URL und das Webhook-Secret.

Webhook im Repository eintragen

GitHub

1. Im Repository: Settings → Webhooks → Add webhook.
2. Payload URL = Webhook-URL, Content type = application/json, Secret = Webhook-Secret.
3. Bei den Ereignissen „Just the push event“ wählen und speichern. GitHub schickt sofort einen Test („ping“) – er sollte mit einem grünen Haken bestätigt werden.

GitLab (gitlab.com)

1. Im Projekt: Settings → Webhooks → Add new webhook.
2. URL = Webhook-URL, Secret token = Webhook-Secret, als Trigger „Push events“ wählen und speichern.

Zum Testen klickst du im Kundenbereich auf „Jetzt aus Git laden“. Das Ergebnis erscheint nach meist unter einer Minute unter „Letzter Lauf“ – mit Vorschau-Link und, falls nicht automatisch veröffentlicht wird, der Schaltfläche „Jetzt veröffentlichen“.

Zugriffstoken für private Repositorys

Das Token braucht nur Lesezugriff auf den Inhalt dieses einen Repositorys:

• GitHub: Settings → Developer settings → Fine-grained tokens → nur dieses Repository auswählen → Berechtigung Contents: Read-only.
• GitLab: im Projekt Settings → Access Tokens → Project Access Token mit der Berechtigung read_repository.

Lässt du das Feld beim nächsten Speichern leer, bleibt das hinterlegte Token erhalten. Gib ein Token nie in einen KI-Chat ein.

Was genau passiert bei einem Push?

• Wir prüfen die Signatur des Webhooks und reagieren nur auf Pushes auf deinen Branch in deinem Repository.
• Geladen wird immer der aktuelle Stand des Branches, nicht ein beliebiger Commit aus der Webhook-Nachricht. Selbst wer das Secret kennt, kann so keinen fremden Code auf deine Website bringen.
• Dateien, die nicht auf eine Website gehören – README, .github/, package.json, Quellcode, Skripte –, lassen wir einfach weg.
• Kommen mehrere Pushes kurz hintereinander, entsteht daraus eine Version mit dem neuesten Stand.

Häufige Fragen

Mein Projekt muss erst gebaut werden (npm run build). Geht das?

Wir führen keinen Build aus. Lass den fertigen Stand von deinem Werkzeug oder einer GitHub Action in einen Ordner wie dist committen und trage diesen als Unterordner ein.

„Kein Zugriff auf das Repository“ – was tun?

Prüfe Schreibweise von Repository und Branch. Bei privaten Repositorys fehlt meist das Token oder es hat keinen Lesezugriff auf dieses Repository.

Wie trenne ich die Verbindung?

Klicke auf „Git-Anbindung entfernen“ und lösche den Webhook zusätzlich im Repository. Deine veröffentlichte Website bleibt unverändert.

Wird selbst gehostetes GitLab unterstützt?

Derzeit nur GitHub und gitlab.com.