Instalación Manual

Traducción Beta No Oficial

Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →

Paquete Portable para Windows

Instalación Portable en Windows

1. Descarga y extrae la última versión.

2. Crea una carpeta jellyfin en tu ubicación de instalación preferida.

3. Copia la carpeta extraída dentro de la carpeta jellyfin y renómbrala como system.

4. Crea un archivo jellyfin.bat dentro de tu carpeta jellyfin con este contenido:

   • Para usar la ubicación predeterminada de biblioteca/datos en %localappdata%:

   <--Your install path-->\jellyfin\system\jellyfin.exe

   • Para usar una ubicación personalizada de biblioteca/datos (ruta después del parámetro -d):

   <--Your install path-->\jellyfin\system\jellyfin.exe -d <--Your install path-->\jellyfin\data

   • Para usar ubicación personalizada y desactivar el inicio automático de la aplicación web:

   <--Your install path-->\jellyfin\system\jellyfin.exe -d <--Your install path-->\jellyfin\data -noautorunwebapp

5. Ejecuta:

   jellyfin.bat

6. Abre tu navegador en http://<--Server-IP-->:8096.

Actualización Portable en Windows

1. Detén Jellyfin.

2. Renombra la carpeta system de Jellyfin como system-bak.

3. Descarga y extrae la última versión de Jellyfin.

4. Copia la carpeta extraída dentro de jellyfin y renómbrala como system.

5. Ejecuta jellyfin.bat para reiniciar el servidor.

Reversión Portable en Windows

1. Detén Jellyfin.

2. Elimina la carpeta system.

3. Renombra system-bak como system.

4. Ejecuta jellyfin.bat para reiniciar el servidor.

Paquete Portable para macOS

Instalación de la Versión Portable para macOS

1. Descarga la última versión de Jellyfin.

2. Extráela en la carpeta Aplicaciones.

3. Abre Terminal y escribe cd seguido de un espacio, luego arrastra la carpeta jellyfin a la terminal.

4. Escribe xattr -rd com.apple.quarantine . para eliminar la marca de cuarentena.

5. Escribe codesign -fs - --deep jellyfin para crear una firma ad-hoc para el servidor.

6. Escribe ./jellyfin para ejecutar jellyfin.

7. Abre tu navegador en http://localhost:8096.

Cerrar la ventana de Terminal detendrá Jellyfin. Ejecutarlo en screen o tmux evitará esto.

Actualización de la Versión Portable para macOS

1. Descarga la última versión.

2. Detén el servidor actual mediante el panel o usando CTRL+C en Terminal.

3. Extrae la última versión en Aplicaciones.

4. Abre Terminal y escribe cd seguido de un espacio, luego arrastra la carpeta jellyfin a la terminal.

5. Escribe xattr -rd com.apple.quarantine . para eliminar la marca de cuarentena.

6. Escribe codesign -fs - --deep jellyfin para crear una firma ad-hoc para el servidor.

7. Escribe ./jellyfin para ejecutar Jellyfin.

8. Abre tu navegador en http://localhost:8096

Desinstalar la versión portable para macOS

1. Detén el servidor en ejecución desde el panel de control o usando CTRL+C en la terminal.

2. Mueve la carpeta /Application/jellyfin-version a la Papelera. Reemplaza "version" con el número real de versión que quieres eliminar.

3. Elimina la carpeta ~/.config/jellyfin/

4. Elimina la carpeta ~/.local/share/jellyfin/

Usar FFmpeg con la versión portable para macOS

La versión portable no incluye FFmpeg por defecto. Tienes varias opciones para instalarlo:

• Descarga jellyfin-ffmpeg desde el repositorio de Jellyfin (recomendado)

• Usa el gestor de paquetes homebrew escribiendo brew install ffmpeg en tu Terminal (instrucciones para instalar homebrew)

• Descarga la última compilación estática (compilada por terceros, visita evermeet.cx para opciones e información) (no disponible para Apple Silicon)

• Compila desde el código fuente disponible en el sitio oficial

Una vez descargado, elimina la bandera de cuarentena para ffmpeg y ffprobe.

Asegúrate de que ambos archivos (ffmpeg y ffprobe) estén en la misma ruta, luego ejecuta el siguiente comando:

cd /path/to/ffmpeg/folder
xattr -rd com.apple.quarantine .

Instalación portable para Linux

Las compilaciones genéricas para Linux en formato TAR (amd64, arm64 y armhf) están disponibles en el repositorio principal de descargas.

Proceso básico de instalación

Crea un directorio en /opt para Jellyfin y sus archivos, luego accede a ese directorio.

sudo mkdir /opt/jellyfin
cd /opt/jellyfin

Descarga la última compilación genérica para tu arquitectura. Estas instrucciones asumen que se instala la versión 10.10.7 (ej. jellyfin_10.10.7-amd64.tar.gz). Descarga la compilación genérica y extrae el archivo:

sudo wget https://repo.jellyfin.org/files/server/linux/latest-stable/amd64/jellyfin_10.10.7-amd64.tar.gz
sudo tar xvzf jellyfin_10.10.7-amd64.tar.gz

Crea cuatro subdirectorios para los datos de Jellyfin.

sudo mkdir data cache config log

Instalación de FFmpeg

Si no usas una distribución derivada de Debian, instala ffmpeg mediante el gestor de paquetes de tu sistema y salta esta sección.

precaución

No poder usar jellyfin-ffmpeg probablemente desactivará la aceleración por hardware y el mapeo de tonos.

Si usas Debian o derivados, descarga e instala el paquete .deb de ffmpeg compilado específicamente para Jellyfin.

Si encuentras errores de dependencias, ejecuta esto para instalarlas junto con jellyfin-ffmpeg.

sudo apt install -f

Ejecutar Jellyfin

Dada la cantidad de opciones de línea de comandos requeridas, es más práctico crear un pequeño script para ejecutar Jellyfin.

sudoedit jellyfin.sh

Luego pega los siguientes comandos, modificando opcionalmente los argumentos según tu despliegue personalizado.

#!/bin/bash
JELLYFINDIR="/opt/jellyfin"
FFMPEGDIR="/usr/share/jellyfin-ffmpeg"

$JELLYFINDIR/jellyfin/jellyfin \
 -d $JELLYFINDIR/data \
 -C $JELLYFINDIR/cache \
 -c $JELLYFINDIR/config \
 -l $JELLYFINDIR/log \
 --ffmpeg $FFMPEGDIR/ffmpeg

Si deseas ejecutar Jellyfin como usuario no root, aplica chmod a todos los archivos y directorios para tu usuario y grupo habitual. Además, haz ejecutable el script de inicio mencionado.

USER=$(id --name --user)
GROUP=$(id --name --group)
sudo chown -R $USER:$GROUP *
sudo chmod u+x jellyfin.sh

Finalmente, puedes ejecutarlo. Verás mucha información de registro al iniciarse, esto es normal. La configuración se realiza como de costumbre en el navegador web.

./jellyfin.sh

Iniciar Jellyfin al arrancar (opcional)

Crea un archivo de unidad de systemd.

cd /etc/systemd/system
sudo nano jellyfin.service

Luego pega el siguiente contenido, reemplazando youruser con tu nombre de usuario.

[Unit]
Description=Jellyfin
After=network.target

[Service]
Type=simple
User=youruser
Restart=always
ExecStart=/opt/jellyfin/jellyfin.sh

[Install]
WantedBy=multi-user.target

Aplica los permisos correctos al archivo, habilita el servicio para que se inicie al arrancar y luego inícialo.

sudo chmod 644 jellyfin.service
sudo systemctl daemon-reload
sudo systemctl enable jellyfin.service
sudo systemctl start jellyfin.service

DLL .NET portable

Las compilaciones DLL multiplataforma de .NET Core en formato de archivo TAR están disponibles en la sección de descargas portables.
Estas compilaciones usan el binario jellyfin.dll y deben cargarse con dotnet.

Debian (usando extrepo)

extrepo solo es compatible con Debian actualmente. La ventaja de extrepo es que está empaquetado en Debian. Así no necesitas ejecutar el comando curl | sudo bash de la sección Automática anterior. El riesgo de ese comando es que depende de la seguridad del servidor web. extrepo evita esto al tener la información del repositorio de Jellyfin, incluida la clave GPG, en su extrepo-data. extrepo-data se verifica con GPG mediante la herramienta extrepo. Por lo tanto, existe una cadena de confianza desde Debian hasta la información del repositorio de Jellyfin.

sudo apt install extrepo
sudo extrepo enable jellyfin

Ahora puedes continuar en el paso 5 de la sección de repositorio (manual).

Repositorio oficial de Linux (manual)

Si prefieres instalar todo manualmente, los pasos completos son los siguientes:

1. Instala curl y gnupg si aún no lo has hecho:

   sudo apt install curl gnupg

2. Solo en Ubuntu (y derivados), habilita el repositorio Universe para obtener todas las dependencias de FFmpeg:

   sudo add-apt-repository universe

   nota

   Si el comando anterior falla, necesitarás instalar el siguiente paquete software-properties-common. Esto se puede lograr con el siguiente comando sudo apt-get install software-properties-common

   En Debian, también puedes habilitar los componentes non-free de tus repositorios base para dependencias adicionales de FFmpeg, pero esto es opcional.

3. Descarga la clave de firma GPG (firmada por el equipo de Jellyfin) e instálala:

   sudo mkdir -p /etc/apt/keyrings
   curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg

4. Agregar una configuración de repositorio en /etc/apt/sources.list.d/jellyfin.sources:

   export VERSION_OS="$( awk -F'=' '/^ID=/{ print $NF }' /etc/os-release )"
   export VERSION_CODENAME="$( awk -F'=' '/^VERSION_CODENAME=/{ print $NF }' /etc/os-release )"
   export DPKG_ARCHITECTURE="$( dpkg --print-architecture )"
   cat <<EOF | sudo tee /etc/apt/sources.list.d/jellyfin.sources
   Types: deb
   URIs: https://repo.jellyfin.org/${VERSION_OS}
   Suites: ${VERSION_CODENAME}
   Components: main
   Architectures: ${DPKG_ARCHITECTURE}
   Signed-By: /etc/apt/keyrings/jellyfin.gpg
   EOF

   nota

   Los valores admitidos para estas variables son:

   • ${VERSION_OS}: debian o ubuntu; si no coincide, usa el más cercano para tu distribución.
   • ${VERSION_CODENAME}: Uno de los códigos de versión compatibles en Debian o Ubuntu. Estos pueden cambiar con nuevos lanzamientos, verifica el script para confirmar compatibilidad.
   • ${DPKG_ARCHITECTURE}: Una de nuestras arquitecturas soportadas. Microsoft no proporciona .NET para sistemas Linux x86 de 32 bits, por lo que Jellyfin no es compatible con la arquitectura i386.

5. Actualizar los repositorios APT:

   sudo apt update

6. Instalar el metapaquete Jellyfin, que incluirá automáticamente los subpaquetes necesarios:

   sudo apt install jellyfin

   nota

   Si prefieres ser explícito, en lugar del metapaquete puedes instalar los subpaquetes individualmente:

   sudo apt install jellyfin-server jellyfin-web

   El paquete jellyfin-server seleccionará automáticamente la versión correcta de jellyfin-ffmpeg.

7. Gestionar el servicio del sistema de Jellyfin:

   sudo systemctl {action} jellyfin
   sudo service jellyfin {action}

Paquetes .deb (Muy Manual)

Los paquetes .deb en bruto, incluyendo versiones antiguas, paquetes fuente y archivos meta dpkg, están disponibles en el repositorio principal de descargas.

nota

El repositorio es el método preferido para instalar Jellyfin en Debian/Ubuntu, ya que garantiza actualizaciones automáticas y resolución correcta de dependencias. Usa estos pasos solo si sabes lo que haces.

1. Solo en Ubuntu (y derivados), habilita el repositorio Universe para obtener las dependencias de FFmpeg:

   sudo add-apt-repository universe

   nota

   Si falla el comando anterior, instala el paquete software-properties-common con el comando sudo apt-get install software-properties-common.

   En Debian, puedes habilitar componentes non-free para dependencias adicionales de FFmpeg, aunque es opcional.

2. Descarga los paquetes .deb deseados de jellyfin-server, jellyfin-web y jellyfin-ffmpeg desde el repositorio; jellyfin es un metapaquete y no es obligatorio.

3. Instala los paquetes .deb descargados con apt para manejar la resolución de dependencias:

   sudo apt install ./jellyfin-server_*.deb ./jellyfin-web_*.deb ./jellyfin-ffmpeg_*.deb

4. Gestiona el servicio del sistema de Jellyfin:

   sudo systemctl {action} jellyfin
   sudo service jellyfin {action}