Instalación

LibreDrive se distribuye como una imagen de contenedor junto con un docker-compose.yml listo para usar en el propio repositorio. Esta guía cubre un despliegue en un solo servidor; para instancias con varias organizaciones consulta la guía de administración.

1. Requisitos

• Docker Engine 24+ y el plugin de Docker Compose (docker compose version).
• Un dominio apuntando a la IP de tu servidor, si quieres HTTPS.
• Al menos 10GB libres para la aplicación y la base de datos; añade espacio adicional según los archivos que vayan a subir tus usuarios.

2. Clona el repositorio y configura .env

git clone https://github.com/iiaanloopez/LibreDrive.git
cd LibreDrive
cp .env.example .env

Edita .env y define como mínimo:

• LIBREDRIVE_DOMAIN — el dominio público desde el que se servirá LibreDrive.
• POSTGRES_PASSWORD — una contraseña larga y aleatoria para el contenedor de Postgres incluido.
• LIBREDRIVE_SECRET_KEY — al menos 32 caracteres aleatorios; firma los tokens JWT de acceso.
• LIBREDRIVE_ENCRYPTION_KEY — obligatoria. Genérala con openssl rand -base64 32.

El resto de variables de .env.example (cuotas, proveedores de pago, backend de almacenamiento, backups) ya tienen un valor por defecto funcional; consulta la referencia de configuración si quieres cambiar alguna.

El docker-compose.yml del repositorio levanta dos servicios, libredrive (expuesto en 127.0.0.1:8080 — se espera un proxy inverso delante) y db (Postgres 16), conectados automáticamente a partir de tu archivo .env. No necesitas escribir tu propio archivo compose.

3. Arranca el stack

docker compose up -d
docker compose logs -f libredrive

4. Ponlo detrás de un proxy inverso con TLS

LibreDrive solo escucha en loopback (127.0.0.1:8080) por diseño; colócalo detrás de Nginx, Caddy o Traefik para servirlo por HTTPS. Un ejemplo mínimo con Caddy:

drive.example.com {
    reverse_proxy 127.0.0.1:8080
}

Caddy solicitará y renovará automáticamente un certificado de Let’s Encrypt.

5. Crea la primera cuenta de administrador

En el primer arranque, LibreDrive imprime un enlace de configuración de un solo uso en los logs del contenedor:

No administrator account exists yet. Set one up here:
  https://drive.example.com/setup?token=...

docker compose logs libredrive | grep setup

Abre ese enlace para crear la cuenta de administrador y continúa con la configuración para definir cuotas y métodos de pago.

Actualizar

docker compose pull
docker compose up -d

Haz siempre una copia de seguridad de los volúmenes libredrive_files, libredrive_backups y libredrive_db antes de actualizar entre versiones mayores; consulta seguridad y backups.

Compilar desde el código fuente en vez de usar la imagen

Comenta image: en docker-compose.yml y descomenta el bloque build: para compilar el contenedor localmente en lugar de descargar ghcr.io/iiaanloopez/libredrive. Para ejecutar la API y la web directamente en tu máquina sin Docker (útil en desarrollo), consulta la sección de desarrollo del README.