Getting Started de

Erste Schritte

EN: English → Getting Started

FlutLink ist der Desktop-Client für den FlutCloud-Server, gebaut mit Tauri v2 — ein Rust-Backend, das direkt WebDAV und OCS spricht, und ein Vue-3 + TypeScript + Tailwind-Frontend. FlutLink verbindet sich nur mit dem FlutCloud-Server (der die flutcloud-Nextcloud-App ausführen muss); er ist kein generischer Nextcloud-Client.

FlutLink installieren

Am einfachsten installierst du die neueste FlutLink-Version auf Windows, macOS oder Linux mit dem Installationsskript (PowerShell 7+):

iex (irm https://raw.githubusercontent.com/OseMine/FlutLink/main/scripts/install-flutlink.ps1)

oder mit curl:

curl.exe -sL https://raw.githubusercontent.com/OseMine/FlutLink/main/scripts/install-flutlink.ps1 | iex

Auf macOS und Linux funktioniert auch das native Bash-Installationsskript ohne PowerShell:

curl -sL https://raw.githubusercontent.com/OseMine/FlutLink/main/scripts/install-flutlink.sh | bash

Die Skripte laden den Installer für deine Plattform vom letzten GitHub-Release herunter, prüfen die SHA-256-Checksumme und führen ihn aus. Um eine bestimmte Version zu wählen oder den Installer nur herunterzuladen, speichere das Skript und übergib Parameter:

irm https://raw.githubusercontent.com/OseMine/FlutLink/main/scripts/install-flutlink.ps1 -OutFile install-flutlink.ps1
./install-flutlink.ps1 -Tag v0.1.0 -NoRun

curl -sL https://raw.githubusercontent.com/OseMine/FlutLink/main/scripts/install-flutlink.sh -o install-flutlink.sh
./install-flutlink.sh --tag v0.1.0 --no-run

Wie die curl | iex- / curl | bash-Einzeiler funktionieren, welche Optionen es gibt und wie du Probleme behebst, findest du unter Installationsskripte.

Der Server muss die flutcloud-Nextcloud-App ausführen — installiere sie mit install-flutcloud-app.ps1 (PowerShell) oder install-flutcloud-app.sh (Bash, Ubuntu/Debian) — und die FlutCloud-Server-URL muss über FLUTCLOUD_URL gesetzt sein (siehe FlutCloud-Konto hinzufügen).

Voraussetzungen

Werkzeug	Version	Hinweis
Node.js	20+	npm für das Frontend
Rust	1.85+ (stable)	über rustup
Tauri-Voraussetzungen	—	Plattform-Tooling, siehe tauri.app

Unter Windows gehören dazu die MSVC-Buildtools und WebView2. Unter Linux sind die webkit2gtk-Systempakete erforderlich.

Entwicklungssetup

npm install          # Frontend-Abhängigkeiten
npm run tauri dev    # startet Vite (Port 1420) + die Rust-App

Die App öffnet ein 1200×800-Fenster. Beim ersten Start kannst du dich direkt anmelden oder erst einmal den Willkommensbildschirm erkunden.

FlutCloud-Konto hinzufügen

1. Erstelle ein App-Passwort in FlutCloud: Einstellungen → Sicherheit → App-Passwörter.
2. Öffne FlutLink → Anmelden.
3. Gib Benutzername und App-Passwort ein. Der Server ist fest auf die FLUTCLOUD_URL aus deiner lokalen .env gesetzt.
4. Das Token wird im OS-Schlüsselbund gespeichert (Windows Anmeldeinformationsverwaltung, macOS-Schlüsselbund, Linux Secret Service).

Das Konto wird gegen ocs/v2.php/cloud/user geprüft und als Admin markiert, wenn der Benutzer einer Admin-Gruppe angehört.

Was du als Nächstes ausprobieren kannst

• Durchsuche deine Cloud-Dateien im Dateien-Tab.
• Füge im Sync-Tab einen lokalen Ordner hinzu — er wird nach /FlutLink/<Ordner> gespiegelt.
• Nutze die Kommandozeile: flutlink --sync oder flutlink --path <Ordner> (siehe Tray-and-CLI-de).
• Verbinde ein Admin-Konto und öffne den Admin-Tab.

Produktionsbuild

npm run build             # vue-tsc + vite build (Frontend-Check)
cargo build --release --manifest-path src-tauri/Cargo.toml
npm run tauri build       # fertige gebündelte App