Server verbinden
Damit FlawDesk Code bauen, deployen und einem KI-Client Zugriff geben kann, braucht das Projekt einen Ort, an dem der Code liegt und Befehle laufen. Das ist in der Regel dein eigener Server per SSH. Dein Code bleibt dabei bei dir — FlawDesk spricht nur mit dem Server, den du angibst.
Voraussetzungen
- Ein Projekt vom Typ FlawDesk Code (siehe Erstes Projekt)
- Ein Linux-Server, den du per SSH erreichst (Ubuntu/Debian sind die gängigen Fälle)
- Auf dem Server installiert: git und rsync — beides Pflicht, ohne sie funktionieren Klonen und Deploy nicht
- Für Node-Projekte zusätzlich Node.js und pm2, für PHP-Projekte PHP
Wo die Einstellungen liegen
Projekt → Zahnrad (Projekteinstellungen) → Tab „FlawDesk Code". Der Tab ist in Sektionen gegliedert, die du in dieser Reihenfolge durchgehst:
| Sektion | Inhalt |
|---|---|
| Quelle | Das GitHub-Repository — eigene Anleitung |
| Ziel-Server | Wo Code und Befehle laufen — diese Seite |
| Server-Status | Prüfung, ob der Server alles Nötige hat |
| MySQL | Optional: Datenbank des Projekts für Queries über den Connector |
| Module | Was gebaut und deployt wird — eigene Anleitung |
| Sticky-Files | Dateien, die ein Deploy nie überschreibt (z. B. .env) |
1. Betriebsart wählen
In Ziel-Server stehen drei Karten:
- Self-Hosted (Eigener Server) — der Normalfall, beschrieben auf dieser Seite. Voller Funktionsumfang: Klonen, Bauen, Deployen, Datenbank, Shell.
- Eigener Rechner (FlawDesk Local) — kein Server nötig: Der Code liegt in einem Ordner auf deinem PC, eine kleine Desktop-Anwendung führt die Befehle dort aus, und jeden Befehl gibst du selbst frei. Ohne Deploy und Datenbank; gut zum Ausprobieren oder für lokale Projekte.
- Gehostet von XantoSoft — noch nicht verfügbar.
2. SSH-Zugang eintragen (Self-Hosted)
Fülle die Felder unter der Karte aus:
| Feld | Bedeutung |
|---|---|
| Host | IP-Adresse oder Hostname, z. B. 203.0.113.10 oder server.example.com |
| Port | Standard 22 |
| SSH-User | Der Linux-Benutzer, unter dem FlawDesk arbeitet |
| Authentifizierung | Private Key (empfohlen) oder Passwort |
| Workspace-Pfad auf dem Server | Verzeichnis, in das FlawDesk die Repositories klont, z. B. /var/www/flawdesk-workspace. Der SSH-User braucht dort Schreibrechte. |
Beim Private Key fügst du den privaten Schlüssel in FlawDesk ein; der zugehörige öffentliche Schlüssel muss auf dem Server in ~/.ssh/authorized_keys des SSH-Users stehen. Ein neues Schlüsselpaar erzeugst du auf deinem Rechner mit:
ssh-keygen -t ed25519 -C "flawdesk" -f flawdesk_key
flawdesk_key.pub kommt auf den Server, flawdesk_key in FlawDesk.
root und nicht deinen persönlichen Account. Lege einen eigenen Benutzer an, der nur auf die Projektverzeichnisse Zugriff hat. Wie das geht, steht in SSH absichern — bitte lesen, bevor ein KI-Client Zugriff bekommt.Mehrere Projekte auf demselben Server? Lege den Zugang einmal unter Workspace-Einstellungen → Code als zentrale SSH-Zugangsdaten an und wähle ihn dann im Projekt aus dem Dropdown statt ihn erneut einzutippen.
Mit Verbindung testen prüfst du sofort, ob FlawDesk den Server erreicht. Dann Speichern.
3. Server-Status prüfen
In der Sektion Server-Status auf Jetzt prüfen klicken. FlawDesk meldet sich am Server an und stellt fest:
- Betriebssystem (nur Linux wird unterstützt)
- ob git und rsync vorhanden sind (Pflicht)
- welche Laufzeiten verfügbar sind: Node.js, npm, PHP, Composer, Python 3, .NET — je nachdem, was deine Module brauchen
Fehlt ein Pflicht-Tool, zeigt die Sektion es rot an. Auf Ubuntu/Debian nachinstallieren mit:
sudo apt install git rsync
Danach Erneut prüfen. Erst wenn hier alles grün ist, lohnt sich der nächste Schritt.
npm install -g pm2) — das wird von der Prüfung nicht erfasst, fällt aber spätestens beim ersten Deploy auf.4. MySQL (optional)
Wenn dein Projekt eine MySQL/MariaDB-Datenbank hat und du (oder ein KI-Client) darüber Queries ausführen willst, trage sie unter MySQL ein: Host, Benutzer, Passwort, Datenbank. Darunter legst du fest, welche Statement-Arten erlaubt sind — SELECT allein reicht für Auswertungen, DROP/CREATE solltest du nur bewusst freigeben.