GitHub verbinden
FlawDesk hält den Code eines Projekts in einem GitHub-Repository. Von dort klont es auf deinen Server, dorthin gehen Pushes, und daraus entstehen die Verknüpfungen zwischen Tickets und Commits.
1. Zugang wählen
In Projekteinstellungen → FlawDesk Code → Quelle gibt es drei Wege:
| Weg | Wann |
|---|---|
| FlawDesk App (empfohlen) | Du installierst die FlawDesk-App in deinem GitHub-Account oder deiner Organisation. Commits laufen als flawdesk[bot], Zugangsdaten erneuern sich automatisch, die Rechte sind auf das Nötige begrenzt. |
| Mein GitHub-Account | Du meldest dich einmal per GitHub-Login an. Für Repositories in deinem persönlichen Account. Commits laufen unter deinem Namen. |
| Personal Access Token (Legacy) | Manueller Fallback, wenn die beiden anderen Wege nicht möglich sind. Token musst du selbst anlegen und erneuern. |
2. FlawDesk App installieren
Die Installation passiert einmal pro GitHub-Account bzw. Organisation, nicht pro Projekt:
1. Zahnrad unten in der Sidebar → Einstellungen → Tab GitHub. 2. FlawDesk App installieren klicken. Du wirst zu GitHub weitergeleitet. 3. Bei GitHub wählst du, wo die App installiert wird (dein Account oder eine Organisation) und auf welche Repositories sie zugreifen darf — alle oder ausgewählte. Bestätigen. 4. GitHub leitet dich zurück; die Installation erscheint in der Liste. Über In GitHub verwalten kannst du später Repositories hinzufügen oder die App entfernen.
3. Repository verknüpfen
Zurück im Projekt, Quelle → FlawDesk App:
1. Account — die Installation wählen (falls du mehrere hast). 2. Repository — ein bestehendes aus der Liste wählen.
Oder + Neues Repo anlegen: FlawDesk erstellt es direkt bei GitHub. Das geht nur in Organisationen; ein neues Repository in deinem persönlichen Account legst du über den Weg „Mein GitHub-Account" an. 3. Optional den Standard-Branch festlegen (sonst main). 4. Speichern.
4. Repository klonen oder erstmalig füllen
Das Repository ist verknüpft, aber noch nicht auf deinem Server. Öffne die Ansicht Filetree in der linken Leiste:
- Repository hat schon Inhalt → Repo jetzt klonen, den Branch wählen, bestätigen. FlawDesk klont in den Workspace-Pfad, den du beim Server verbinden angegeben hast.
- Repository ist leer (frisch angelegt) → Initial Push. FlawDesk legt ein Startgerüst an, committet es und pusht auf GitHub. Danach ist der Workspace auf dem Server angelegt.
Beides darf nur der Workspace-Owner auslösen.
Ab hier siehst du im Filetree die Dateien auf dem Server, kannst sie ansehen und bearbeiten, und ein KI-Client mit Connector arbeitet im selben Verzeichnis.
Häufige Probleme
„Repo-Zugriff fehlgeschlagen" — Die App hat auf dieses Repository kein Recht (siehe Warnung oben) oder das Repository wurde umbenannt. Im Zweifel unter Quelle neu auswählen.
Klonen bricht ab — Meist fehlt git auf dem Server oder der SSH-User hat keine Schreibrechte im Workspace-Pfad. Server-Status → Jetzt prüfen zeigt es.
Commits erscheinen als flawdesk[bot] — Das ist bei der FlawDesk App beabsichtigt: Es ist sichtbar, was über FlawDesk und was von Hand kam. Wer Commits unter eigenem Namen will, nutzt „Mein GitHub-Account".