ZiiX.TV es un servidor que ejecutas tú mismo, con Docker. Funciona en Linux sobre amd64 y arm64: un NAS, un servidor doméstico, un mini PC o una Raspberry Pi 4/5. Tus archivos multimedia se quedan donde están; ZiiX.TV solo los lee.
1. Crea una carpeta con dos archivos
Crea una carpeta para ZiiX.TV, por ejemplo /opt/ziix-tv, y pon en ella este docker-compose.yml:
services:
ziix-tv:
image: ziixeu/ziix-tv:latest
container_name: ziix-tv
restart: unless-stopped
ports:
- "8470:8470"
volumes:
- ./config:/config
- ${ZIIX_MEDIA:-./media}:/media:ro
- ${ZIIX_PREVIEWS:-./previews}:/previews
cap_drop: [ALL]
cap_add: [CHOWN, FOWNER, DAC_OVERRIDE, SETUID, SETGID]
security_opt:
- no-new-privileges:true
environment:
PUID: ${PUID:-1000}
PGID: ${PGID:-1000}
TZ: ${TZ:-Europe/Copenhagen}
ZIIX_TMDB_API_KEY: ${ZIIX_TMDB_API_KEY:-}
ZIIX_TVDB_API_KEY: ${ZIIX_TVDB_API_KEY:-}
ZIIX_TVDB_PIN: ${ZIIX_TVDB_PIN:-}
ZIIX_METADATA_LANGUAGE: ${ZIIX_METADATA_LANGUAGE:-en-US}
ZIIX_SCAN_INTERVAL: ${ZIIX_SCAN_INTERVAL:-15m}
ZIIX_HWACCEL: ${ZIIX_HWACCEL:-auto}
ZIIX_PREVIEW_DIR: /previews
Al lado, un archivo llamado .env que indica dónde están tus medios y qué usuario puede leerlos. id en el servidor muestra los números de tu usuario y de tu grupo.
ZIIX_MEDIA=/path/to/media
PUID=1000
PGID=1000
TZ=Europe/Copenhagen
ZIIX_METADATA_LANGUAGE=en-US
2. Ponlo en marcha
docker compose up -d
Abre http://<your server>:8470 en un navegador y crea el administrador. La primera cuenta que creas es la del administrador del servidor.
3. Añade tus bibliotecas
En Ajustes → Bibliotecas, añade una biblioteca para películas y otra para series, apuntando a sus carpetas dentro de /media. ZiiX.TV las escanea al momento. Consulta cómo nombrar los archivos y cómo añadir una biblioteca.
4. A disfrutar
Mira en el navegador, o instala una app y vincúlala a tu servidor.
| App | Dónde |
|---|---|
| Navegador web | Integrado: http://<your server>:8470 |
| Apple TV | App Store (muy pronto) |
| iPhone y iPad | App Store (muy pronto) |
| Android | Google Play (muy pronto) |
| Android TV | Previsto |
Actualizar
docker compose pull
docker compose up -d
latest es siempre la versión más reciente. Para quedarte en una versión concreta, usa su etiqueta, por ejemplo ziixeu/ziix-tv:0.9.1. Las actualizaciones conservan tus bibliotecas, tus usuarios y tu historial; aun así, haz antes una copia de la carpeta config.
Tarjeta gráfica NVIDIA
Con el controlador de NVIDIA y el NVIDIA Container Toolkit en el servidor, ZiiX.TV puede convertir video en la tarjeta gráfica. Añade un segundo archivo, docker-compose.nvidia.yml:
services:
ziix-tv:
deploy:
resources:
reservations:
devices:
- driver: nvidia
count: all
capabilities: [gpu]
e inicia con los dos archivos:
docker compose -f docker-compose.yml -f docker-compose.nvidia.yml up -d
Más información en GPU y transcodificación.
Carpetas
| En el contenedor | Qué | |
|---|---|---|
/config | Base de datos y ajustes | Haz copia de seguridad |
/media | Tus películas y series | Basta con solo lectura |
/previews | Imágenes de la barra de progreso | Se pueden volver a crear, pero en una biblioteca grande lleva horas |
ZiiX.TV arranca como root solo para entregar /config y /previews a PUID:PGID, y después funciona como ese usuario, sin privilegios.
Prueba y licencia
Un servidor nuevo funciona como prueba de 30 días con todo incluido, sin tarjeta. Cuando quieras, compra una licencia en Ajustes → Servidor. Consulta los precios.