Volúmenes (Discos)

Aprende a mapear carpetas desde tu sistema operativo al Servidor RoqueOS, haciéndolas aparecer como discos reales en el Administrador de Archivos del escritorio web.

---

¿Cómo Funciona?

El Servidor RoqueOS se ejecuta dentro de un contenedor Docker aislado. Por razones de seguridad, no tiene acceso automático a los archivos en tu computadora o servidor host.

Para que el Administrador de Archivos pueda ver, editar y organizar tus carpetas de descargas, documentos o medios, necesitas "montar" estos volúmenes en Docker — como si conectaras una unidad USB.

---

Cómo Configurar

Modifica el archivo docker-compose.yml añadiendo líneas en la sección volumes:.

Sintaxis:

Ruta-en-Tu-Computadora : /app/disks/NombreDelDisco

REGLA IMPORTANTE

La ruta de la derecha (dentro de RoqueOS) siempre debe empezar con /app/disks/ para que el Administrador de Archivos detecte la carpeta y la muestre como un disco.

Ejemplos Prácticos

📁 Documentos

# Linux/macOS
volumes:
  - /home/usuario/Documentos:/app/disks/Documentos

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

🎬 Medios / Películas

# Linux/macOS
volumes:
  - /mnt/disco-externo/PlexMedia:/app/disks/Medios

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

⬇️ Descargas

# Linux/macOS
volumes:
  - /home/usuario/Downloads:/app/disks/Descargas

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

---

Ejemplo Completo 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
      # Tus discos personalizados:
      - /mnt/disco-externo/Peliculas:/app/disks/Peliculas
      - /home/usuario/Downloads:/app/disks/Descargas
      - /home/usuario/Proyectos:/app/disks/Proyectos
    environment:
      - TZ=America/Sao_Paulo

---

Después de Configurar

Reiniciar el Servidor

Cada vez que modifiques el docker-compose.yml añadiendo o eliminando un volumen, necesitas recrear el contenedor:

docker compose down && docker compose up -d

Verificar Discos en el Frontend

Una vez que el servidor se reinicie, abre el Administrador de Archivos en RoqueOS. Verás que aparecen nuevas unidades de disco virtual en el panel izquierdo, con el nombre exacto que elegiste en /app/disks/NOMBRE.

---

Problemas Comunes

Error "Acceso Denegado" al editar archivos

Si recibes un error de permisos al intentar crear o eliminar archivos dentro de un disco mapeado, el contenedor Docker no tiene permiso para escribir en la carpeta local. En la terminal del servidor host:

# Permisos de lectura y escritura para el propietario
chmod -R 755 /ruta/a/tu/carpeta/local

# Si necesitas acceso total (ten cuidado)
chmod -R 777 /ruta/a/tu/carpeta/local

El disco no aparece en el Administrador de Archivos

Comprueba si:

1. La ruta dentro del contenedor empieza con /app/disks/
2. El contenedor se reinició después del cambio en compose
3. La ruta del host existe y tiene permisos de lectura