Docker: qBittorrent - para qué sirve y cómo instalarlo

octubre 18, 2026

Publicado por Curso Docker

Imagen Docker del curso, nº 1. qBittorrent es un cliente de torrents con interfaz web, ligero y sin publicidad. La imagen de LinuxServer.io te permite tenerlo funcionando en un servidor o NAS y controlarlo desde el navegador.

¿Para qué sirve?

Descargar y compartir archivos por BitTorrent de forma legal (distribuciones Linux, contenido propio, etc.).
Gestionar las descargas desde cualquier dispositivo de tu red.

Instalación con docker run

Este es el comando del README oficial (cambia las rutas /path/to/... por carpetas de tu equipo):

docker run -d \
  --name=qbittorrent \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e WEBUI_PORT=8080 \
  -e TORRENTING_PORT=6881 \
  -p 8080:8080 \
  -p 6881:6881 \
  -p 6881:6881/udp \
  -v /path/to/qbittorrent/appdata:/config \
  -v /path/to/downloads:/downloads `#optional` \
  --stop-timeout="10s" `#optional` \
  --restart unless-stopped \
  lscr.io/linuxserver/qbittorrent:latest

Instalación con Docker Compose

Ejemplo de docker-compose.yml del README oficial. Guárdalo como docker-compose.yml y ejecuta docker compose up -d:

services:
  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qbittorrent
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - WEBUI_PORT=8080
      - TORRENTING_PORT=6881
    volumes:
      - /path/to/qbittorrent/appdata:/config
      - /path/to/downloads:/downloads #optional
    ports:
      - 8080:8080
      - 6881:6881
      - 6881:6881/udp
    stop_grace_period: "10s" #optional
    restart: unless-stopped

Consejos

Sustituye siempre las rutas de ejemplo por carpetas reales de tu equipo.
Comprueba que el contenedor está activo con docker ps y revisa los logs con docker logs NOMBRE.
Cambia las contraseñas por defecto antes de exponer el servicio fuera de tu red.

Antes de empezar con qBittorrent

Necesitas un equipo con Docker instalado y funcionando. Comprueba la versión con docker --version y la de Compose con docker compose version. Si tu usuario no está en el grupo docker, tendrás que anteponer sudo a los comandos. Mira también que los puertos 8080, 6881 estén libres con ss -tulpn | grep 8080: si otro servicio usa alguno, el contenedor no arrancará y tendrás que elegir otro puerto en la parte izquierda de la asignación.

Cómo comprobar que qBittorrent funciona

Después de arrancar el contenedor, ejecuta docker ps y busca qbittorrent en la lista con estado Up. Si aparece reiniciándose o desaparece al poco rato, lee el motivo con docker logs -f qbittorrent; casi siempre es una ruta mal escrita o un permiso. Cuando esté estable, si la aplicación tiene interfaz web, ábrela en el navegador con la dirección y el puerto que indica el README oficial. Dale un minuto en el primer arranque, porque algunas aplicaciones preparan su base de datos antes de aceptar conexiones.

Dónde se guardan los datos

En el ejemplo se montan estas rutas: /path/to/qbittorrent/appdata:/config, /path/to/downloads:/downloads. La parte de la izquierda es la carpeta de tu equipo y la de la derecha es la ruta dentro del contenedor. Todo lo que quieras conservar debe estar en una carpeta montada, porque lo que queda dentro del contenedor se pierde si lo eliminas. Crea las carpetas antes de arrancar, con el usuario que vaya a usarlas, para evitar errores de permisos.

Cómo actualizar qBittorrent

Para actualizar con Compose, ve a la carpeta del docker-compose.yml y ejecuta docker compose pull seguido de docker compose up -d. Docker descarga la imagen nueva y recrea el contenedor sin tocar tus carpetas montadas. Después puedes limpiar imágenes viejas con docker image prune.

Fuentes: README en GitHub · Docker Hub

Buscar este blog

Curso Docker