Volumes (Disques)

Apprenez à mapper des dossiers de votre système d'exploitation vers le Serveur RoqueOS, afin qu'ils apparaissent comme de véritables disques dans le Gestionnaire de Fichiers du bureau web.

---

Comment ça marche ?

Le Serveur RoqueOS s'exécute dans un conteneur Docker isolé. Pour des raisons de sécurité, il n'a pas accès automatiquement aux fichiers de votre ordinateur ou du serveur hôte.

Pour que le Gestionnaire de Fichiers puisse voir, éditer et organiser vos dossiers de téléchargements, documents ou médias, vous devez "monter" ces volumes dans Docker — tout comme vous brancheriez une clé USB.

---

Comment Configurer

Modifiez le fichier docker-compose.yml en ajoutant des lignes dans la section volumes:.

Syntaxe :

Chemin-sur-Votre-Ordinateur : /app/disks/NomDuDisque

RÈGLE IMPORTANTE

Le chemin de droite (à l'intérieur de RoqueOS) doit toujours commencer par /app/disks/ pour que le Gestionnaire de Fichiers détecte le dossier et l'affiche comme un disque.

Exemples Pratiques

📁 Documents

# Linux/macOS
volumes:
  - /home/utilisateur/Documents:/app/disks/Documents

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

🎬 Médias / Films

# Linux/macOS
volumes:
  - /mnt/disque-externe/PlexMedia:/app/disks/Medias

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

⬇️ Téléchargements

# Linux/macOS
volumes:
  - /home/utilisateur/Downloads:/app/disks/Telechargements

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

---

Exemple Complet de docker-compose.yml

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
      # Vos disques personnalisés :
      - /mnt/disque-externe/Films:/app/disks/Films
      - /home/utilisateur/Downloads:/app/disks/Telechargements
      - /home/utilisateur/Projets:/app/disks/Projets
    environment:
      - TZ=America/Sao_Paulo

---

Après Configuration

Redémarrer le Serveur

Chaque fois que vous modifiez le docker-compose.yml pour ajouter ou retirer un volume, vous devez recréer le conteneur :

docker compose down && docker compose up -d

Vérifier les Disques sur le Frontend

Une fois le serveur redémarré, ouvrez le Gestionnaire de Fichiers dans RoqueOS. Vous verrez de nouveaux lecteurs de disques virtuels apparaître dans le panneau de gauche, avec le nom exact que vous avez choisi dans /app/disks/NOM.

---

Problèmes Courants

Erreur "Accès Refusé" lors de l'édition de fichiers

Si vous obtenez une erreur de permission en essayant de créer ou supprimer des fichiers dans un disque mappé, le conteneur Docker n'a pas la permission d'écrire dans le dossier local. Dans le terminal du serveur hôte :

# Permissions de lecture et d'écriture pour le propriétaire
chmod -R 755 /chemin/vers/votre/dossier/local

# Si vous avez besoin d'un accès total (soyez prudent)
chmod -R 777 /chemin/vers/votre/dossier/local

Le disque n'apparaît pas dans le Gestionnaire de Fichiers

Vérifiez si :

1. Le chemin à l'intérieur du conteneur commence par /app/disks/
2. Le conteneur a été redémarré après la modification du compose
3. Le chemin hôte existe et possède les permissions de lecture