Servidor multimedia en Portainer como stack

Quven Server funciona en Portainer como un stack normal, creado a partir del archivo Compose oficial. Es la edición Solo servidor: no tiene cliente de escritorio ni aloja la aplicación web. Estos pasos se siguieron en Portainer CE 2.45 con un entorno Docker local en Linux.

Requisitos

Requisito	Lo que espera Quven
Portainer	Community o Business Edition, gestionando un entorno Docker independiente
Host	Linux en AMD64 o ARM64, con Docker Engine. Docker Desktop no es compatible
Red	La red del host, que el archivo Compose ya pide
Biblioteca	Una carpeta en la que pueda escribir el usuario del contenedor, uid 10001, o un montaje de solo lectura

La guía de Docker usa la misma imagen desde la línea de comandos, con los perfiles de GPU y la verificación de la firma.

1. Crea el stack

1. Abre Stacks, luego Add stack, y llámalo quven.

2. Elige Web editor y pega entero el archivo Compose oficial:

   curl -fsSL https://quven.tv/docker/1.5.10/compose.yaml

3. En Environment variables, pulsa Add an environment variable y define QUVEN_MEDIA_DIR con la ruta absoluta de tu biblioteca en el host, por ejemplo /srv/media.

4. Pulsa Deploy the stack.

Deja la imagen en latest: cada versión corrige problemas encontrados en las anteriores, y una versión fijada se queda con todos ellos.

2. Comprueba que responde

El contenedor se llama quven-quven-1. Su estado pasa a healthy en cuanto la comprobación del servidor sale bien, normalmente en menos de dos minutos, y el servidor responde en el puerto 5181 del host:

curl --fail --silent --show-error http://127.0.0.1:5181/health/container -o /dev/null

No hay ningún puerto que publicar, porque la red del host pone el servidor en la dirección de la propia máquina. Una página en blanco en http://<server-ip>:5181 significa que el servidor está en marcha.

3. Vincula tu cuenta

Abre Containers, luego quven-quven-1, luego Console, conéctate con /bin/sh y ejecuta:

/app/Quven.Local.Server account link

Abre la dirección que muestra, inicia sesión en tu cuenta de Quven y aprueba el servidor. Los clientes nativos lo encuentran en la red local, y con Pro app.quven.tv también llega a él a través del relé gestionado.

4. Añade una biblioteca

Añade las bibliotecas desde la aplicación de escritorio de Quven en cualquier ordenador de la misma red, o desde app.quven.tv con Pro. Elige carpetas por debajo de /media: una biblioteca del host situada en /srv/media aparece dentro de Quven como /media.

Variables opcionales

Variable	Predeterminado	Lo que cambia
QUVEN_MEDIA_READ_ONLY	false	true monta la biblioteca en solo lectura; los subtítulos se quedan en Quven
QUVEN_DATA_VOLUME	quven-data	El volumen con la base de datos, los ajustes y los registros
QUVEN_TMPFS_SIZE	4g	Espacio temporal para la transcripción y la lectura de subtítulos
QUVEN_URLS	http://0.0.0.0:5181	La dirección y el puerto en los que escucha el servidor

Quven escribe los subtítulos que genera junto a la película, así que la carpeta tiene que admitir escritura para uid 10001. Con QUVEN_MEDIA_READ_ONLY en true, los guarda en su propio volumen.

Actualización

1. Abre el stack quven y su pestaña Editor.
2. Pulsa Update the stack y activa Re-pull image and redeploy.
3. Confirma con Update.

El volumen quven-data sobrevive a la actualización, así que la biblioteca, el historial de visionado y el vínculo con la cuenta se mantienen. Copia el volumen antes de una versión a la que quieras poder renunciar, porque una imagen más antigua no lee una base de datos que una más nueva ya ha migrado.

Preguntas frecuentes