Volumes (Laufwerke)

Erfahren Sie, wie Sie Ordner Ihres Betriebssystems auf den RoqueOS-Server zuordnen, sodass sie als echte Laufwerke im Dateimanager des Web-Desktops erscheinen.

---

Wie es funktioniert?

Der RoqueOS-Server läuft innerhalb eines isolierten Docker-Containers. Aus Sicherheitsgründen hat er nicht automatisch Zugriff auf die Dateien auf Ihrem Computer oder Host-Server.

Damit der Dateimanager Ihre Downloads, Dokumente oder Medienordner anzeigen, bearbeiten und organisieren kann, müssen Sie diese Volumes in Docker "mounten" (einhängen) — genau wie das Anschließen eines USB-Laufwerks.

---

Wie man konfiguriert

Ändern Sie die Datei docker-compose.yml, indem Sie Zeilen im Abschnitt volumes: hinzufügen.

Syntax:

Pfad-auf-Ihrem-Computer : /app/disks/Laufwerksname

WICHTIGE REGEL

Der Pfad auf der rechten Seite (innerhalb von RoqueOS) muss immer mit /app/disks/ beginnen, damit der Dateimanager den Ordner erkennt und als Laufwerk anzeigt.

Praktische Beispiele

📁 Dokumente

# Linux/macOS
volumes:
  - /home/benutzer/Dokumente:/app/disks/Dokumente

# Windows
volumes:
  - C:\Users\benutzer\Documents:/app/disks/Dokumente

🎬 Medien / Filme

# Linux/macOS
volumes:
  - /mnt/externe-festplatte/PlexMedia:/app/disks/Medien

# Windows
volumes:
  - D:\PlexMedia:/app/disks/Medien

⬇️ Downloads

# Linux/macOS
volumes:
  - /home/benutzer/Downloads:/app/disks/Downloads

# Windows
volumes:
  - C:\Users\benutzer\Downloads:/app/disks/Downloads

---

Vollständiges docker-compose.yml Beispiel

version: '3.8'

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    container_name: roqueos-server
    restart: unless-stopped
    ports:
      - '27021:27021'
    volumes:
      - ./data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock
      # Ihre benutzerdefinierten Laufwerke:
      - /mnt/externe-festplatte/Filme:/app/disks/Filme
      - /home/benutzer/Downloads:/app/disks/Downloads
      - /home/benutzer/Projekte:/app/disks/Projekte
    environment:
      - TZ=America/Sao_Paulo

---

Nach der Konfiguration

Den Server neu starten

Jedes Mal, wenn Sie die docker-compose.yml ändern und ein Volume hinzufügen oder entfernen, müssen Sie den Container neu erstellen:

docker compose down && docker compose up -d

Laufwerke im Frontend überprüfen

Sobald der Server neu gestartet ist, öffnen Sie den Dateimanager in RoqueOS. Sie werden sehen, dass im linken Bereich neue virtuelle Laufwerke erscheinen, und zwar mit genau dem Namen, den Sie unter /app/disks/NAME gewählt haben.

---

Häufige Probleme

Fehler "Zugriff verweigert" beim Bearbeiten von Dateien

Wenn Sie beim Versuch, Dateien in einem zugeordneten Laufwerk zu erstellen oder zu löschen, einen Berechtigungsfehler erhalten, hat der Docker-Container keine Berechtigung, in den lokalen Ordner zu schreiben. Im Terminal des Host-Servers:

# Lese- und Schreibberechtigung für den Eigentümer
chmod -R 755 /pfad/zu/ihrem/lokalen/ordner

# Wenn Sie vollen Zugriff benötigen (seien Sie vorsichtig)
chmod -R 777 /pfad/zu/ihrem/lokalen/ordner

Laufwerk erscheint nicht im Dateimanager

Überprüfen Sie, ob:

1. Der Pfad im Container mit /app/disks/ beginnt
2. Der Container nach der Änderung an der Compose-Datei neu gestartet wurde
3. Der Host-Pfad existiert und Leseberechtigungen hat