# Nextcloud-Ordner als Live-Mount auf Ubuntu Server (rclone)

Diese Anleitung richtet einen ausgewählten Nextcloud-Ordner (z. B. `AI`) als
echtes, dauerhaft eingebundenes Dateisystem auf einem Ubuntu-Server ein –
per WebDAV über `rclone mount`. Änderungen werden nahezu in Echtzeit
zwischen Server und Nextcloud abgeglichen (kein Polling-Sync, kein
Desktop-Client, kein Xvfb nötig).

**Einsatzzweck:** Verteiltes Gedächtnis / Datenordner für Anwendungen
(z. B. KI-Agenten), die kontinuierlich lesend und schreibend auf einen
Nextcloud-Ordner zugreifen sollen, auf Servern ohne Desktop-Umgebung.

---

## Voraussetzungen

- Ubuntu Server mit SSH-Zugriff
- Ein Nextcloud-Account mit App-Passwort (siehe Schritt 1)
- `rclone` und `fuse3`

---

## Schritt 1: App-Passwort in Nextcloud erstellen

1. Nextcloud im Browser öffnen und normal einloggen (Login + ggf. OTP).
2. Profilbild oben rechts → **Persönliche Einstellungen**.
3. Reiter **Sicherheit** (links).
4. Ganz nach unten scrollen zu **App-Passwörter**.
5. Namen vergeben (z. B. `Ubuntu-Server-AI-Mount`) → **Neues App-Passwort
   erstellen**.
6. Generiertes Passwort kopieren – wird in Schritt 3 benötigt.

---

## Schritt 2: Pakete installieren

```bash
sudo apt update
sudo apt install -y rclone fuse3
```

> Kein `nextcloud-desktop`, kein `xvfb` nötig – rclone kommt ohne
> GUI-Abhängigkeiten aus.

---

## Schritt 3: rclone-Remote konfigurieren

Interaktive Einrichtung:

```bash
rclone config
```

- `n` (New remote)
- Name: `Nextcloud` (Groß-/Kleinschreibung beachten – wird später exakt so
  referenziert, inkl. Doppelpunkt: `Nextcloud:`)
- Typ: `webdav`
- URL:
  ```
  https://DEINE-NEXTCLOUD-DOMAIN/remote.php/dav/files/DEIN_USERNAME/
  ```
- Vendor: `nextcloud`
- User: dein Nextcloud-Login
- Password: das App-Passwort aus Schritt 1 (rclone verschlüsselt es
  automatisch in der Config)
- Rest mit Enter bestätigen, am Ende mit `y` speichern

**Alternative – nicht-interaktiv:**

```bash
rclone config create Nextcloud webdav \
  url=https://DEINE-NEXTCLOUD-DOMAIN/remote.php/dav/files/DEIN_USERNAME/ \
  vendor=nextcloud \
  user=DEIN_USERNAME \
  pass=DEIN_APP_PASSWORT
```

**Verbindung testen:**

```bash
rclone lsd Nextcloud:
```

Sollte die Ordnerliste deiner Nextcloud anzeigen (Doppelpunkt nicht
vergessen – ohne `:` interpretiert rclone den Namen als lokalen Pfad statt
als Remote!).

---

## Schritt 4: Mount-Punkt anlegen

```bash
mkdir -p "/pfad/zu/deinem/mount-ordner"
```

Beispiel für den `AI`-Ordner:

```bash
mkdir -p "/home/DEIN_USER/nextcloud-ai"
```

---

## Schritt 5: Manuell testen

```bash
rclone mount Nextcloud:AI "/home/DEIN_USER/nextcloud-ai/" \
  --vfs-cache-mode writes \
  --daemon
```

- `Nextcloud:AI` → nur dieser Unterordner wird gemountet (beliebiger Pfad
  möglich, auch verschachtelt: `Nextcloud:AI/Unterordner`, oder `Nextcloud:`
  für den kompletten Account)
- `--daemon` → läuft im Hintergrund, Terminal bleibt frei (nur für
  manuelle Tests; im systemd-Service **ohne** `--daemon`, siehe Schritt 6)

Prüfen:

```bash
ls -la "/home/DEIN_USER/nextcloud-ai/"
```

Test-Datei anlegen und in der Nextcloud-Weboberfläche prüfen, ob sie
ankommt (kurze Verzögerung durch VFS-Cache ist normal):

```bash
echo "test" > "/home/DEIN_USER/nextcloud-ai/server-test.txt"
```

Zum Beenden des Test-Mounts:

```bash
fusermount -u "/home/DEIN_USER/nextcloud-ai/"
```

---

## Schritt 6: Als systemd-User-Dienst dauerhaft einrichten

Damit der Mount Server-Neustarts übersteht und automatisch wieder da ist.

**1. Service-Datei anlegen:**

```bash
mkdir -p ~/.config/systemd/user
nano ~/.config/systemd/user/nextcloud-ai-mount.service
```

**2. Inhalt einfügen** (Pfade und Remote-Ordner anpassen):

```ini
[Unit]
Description=Nextcloud AI-Ordner als WebDAV-Mount
After=network-online.target
Wants=network-online.target

[Service]
Type=notify
ExecStart=/usr/bin/rclone mount Nextcloud:AI "/home/DEIN_USER/nextcloud-ai/" --vfs-cache-mode writes --vfs-cache-max-age 24h
ExecStop=/bin/fusermount -u "/home/DEIN_USER/nextcloud-ai/"
Restart=always
RestartSec=10

[Install]
WantedBy=default.target
```

> Kein `--daemon`-Flag hier: Der Prozess muss im Vordergrund bleiben,
> damit systemd ihn korrekt als laufenden Dienst überwachen kann. Dass
> der Befehl "blockiert" (nicht ins Terminal zurückkehrt), ist bei
> `rclone mount` ohne `--daemon` normales, gewolltes Verhalten.

**3. Aktivieren:**

```bash
systemctl --user daemon-reload
systemctl --user enable --now nextcloud-ai-mount
```

**4. Sicherstellen, dass der Dienst auch ohne aktive SSH-Session
weiterläuft** (Linger – einmalig nötig):

```bash
sudo loginctl enable-linger $USER
```

Prüfen:

```bash
loginctl show-user $USER | grep Linger
```

Sollte `Linger=yes` zeigen.

---

## Schritt 7: Status & Logs prüfen

```bash
systemctl --user status nextcloud-ai-mount
ls -la "/home/DEIN_USER/nextcloud-ai/"
```

Live-Logs:

```bash
journalctl --user -u nextcloud-ai-mount -f
```

> Falls `journalctl --user` ohne Ergebnisse bleibt oder Berechtigungsfehler
> zeigt: `sudo journalctl --user-unit=nextcloud-ai-mount -f` verwenden,
> oder sich einmal komplett neu per SSH einloggen, nachdem man mit
> `sudo usermod -aG systemd-journal $USER` zur Gruppe hinzugefügt wurde.

---

## Wichtige Hinweise

- **`--vfs-cache-mode writes`**: Schreibzugriffe werden lokal gepuffert
  und zuverlässig hochgeladen, auch bei kurzen Netzwerkausfällen.
- **Kein Polling-Sync**: Änderungen gehen nahezu in Echtzeit über WebDAV,
  nicht erst beim nächsten Sync-Zyklus wie bei `rclone sync`/`bisync`.
- **`rclone bisync` bewusst vermieden**: Ist offiziell als Beta-Feature
  eingestuft – für ein produktiv genutztes, kontinuierlich beschriebenes
  Verzeichnis ist `mount` die robustere Wahl.
- **Mehrere Ordner**: Für weitere Nextcloud-Ordner einfach ein zweites
  Service-Paar mit anderem Namen (z. B. `nextcloud-technik-mount.service`)
  und anderem `targetPath` (`Nextcloud:Technik`) anlegen – läuft
  unabhängig parallel.
- **Remote-Name ist case-sensitive**: `Nextcloud:` ≠ `nextcloud:`.

---

## Troubleshooting-Kurzreferenz

| Symptom | Ursache | Lösung |
|---|---|---|
| `rclone lsd` zeigt nichts | Remote-Name falsch geschrieben / Doppelpunkt vergessen | `rclone listremotes` prüfen, exakte Schreibweise verwenden |
| `didn't find section in config file` | Remote-Name in Config weicht ab | `rclone config show` bzw. `cat ~/.config/rclone/rclone.conf` prüfen |
| Mount-Befehl "hängt" im Terminal | Normales Verhalten ohne `--daemon` | Für Tests `--daemon` nutzen, im systemd-Service bewusst weglassen |
| `journalctl --user` verweigert Zugriff | Fehlende Gruppenmitgliedschaft `systemd-journal` | `sudo usermod -aG systemd-journal $USER`, neu einloggen |