Jellyfin: Difference between revisions
m Clarified intro-skipper plugin. |
Manual compliance |
||
| Line 1: | Line 1: | ||
<languages/> | |||
== | {{infobox application | ||
|name=Jellyfin | |||
|image=Jelly-banner-light.svg | |||
|type=Media server | |||
|developer=Jellyfin Project | |||
|license=[https://www.gnu.org/licenses/gpl-2.0.html GPL-2.0] | |||
|os=Cross-platform (Linux, macOS, Windows) | |||
|platform=Server | |||
|programmingLanguage=C# | |||
|website=[https://jellyfin.org/ jellyfin.org] | |||
|github=jellyfin/jellyfin | |||
|bugTracker=[https://github.com/jellyfin/jellyfin/issues GitHub Issues] | |||
|documentation=[https://jellyfin.org/docs/ jellyfin.org/docs] | |||
}} | |||
<translate> | |||
<!--T:1--> | |||
<strong>[https://jellyfin.org/ Jellyfin]</strong><ref name="jellyfin">Jellyfin Project, "Jellyfin: The Free Software Media System", Official Website, Accessed October 2025. https://jellyfin.org/</ref> is a free and open-source media server that enables users to manage and stream their personal media libraries across various devices. It consists of the Jellyfin Server and multiple client applications including Jellyfin Media Player and a web interface. | |||
== Installation == <!--T:2--> | |||
< | <!--T:3--> | ||
{ | To enable Jellyfin on NixOS, add the service configuration to your <code>/etc/nixos/configuration.nix</code> file: | ||
</translate> | |||
{{code|lang=nix|line=no|1={ | |||
services.jellyfin.enable = true; | services.jellyfin.enable = true; | ||
environment.systemPackages = [ | environment.systemPackages = [ | ||
| Line 14: | Line 33: | ||
]; | ]; | ||
} | } | ||
< | }} | ||
<translate> | |||
<!--T:4--> | |||
For more advanced configuration options, refer to the [https://search.nixos.org/options?query=jellyfin NixOS options documentation]:<ref name="nixos-options">NixOS Wiki contributors, "Jellyfin NixOS module options", NixOS Search, Accessed October 2025. https://search.nixos.org/options?query=jellyfin</ref> | |||
</translate> | |||
{{code|lang=nix|line=no|1={ | |||
{ | |||
services.jellyfin = { | services.jellyfin = { | ||
enable = true; | enable = true; | ||
| Line 25: | Line 45: | ||
}; | }; | ||
} | } | ||
</ | }} | ||
<translate> | |||
<!--T:5--> | |||
After configuring Jellyfin, rebuild your system for the changes to take effect: | |||
</translate> | |||
{{code|lang=bash|line=no|$ sudo nixos-rebuild switch}} | |||
<translate> | |||
<!--T:6--> | |||
After the rebuild completes, verify that Jellyfin is running: | |||
</translate> | |||
{{code|lang=bash|line=no|$ sudo systemctl status jellyfin}} | |||
<translate> | |||
<!--T:7--> | |||
If Jellyfin is not running, you can start it manually: | |||
</translate> | |||
{{code|lang=bash|line=no|$ jellyfin}} | |||
<translate> | |||
<!--T:8--> | |||
Once Jellyfin is running, you can access the web interface: | |||
<!--T:9--> | |||
< | * The Jellyfin server runs on port 8096 by default.<ref name="jellyfin-ports">Jellyfin Documentation Team, "Networking", Jellyfin Documentation, Accessed October 2025. https://jellyfin.org/docs/general/networking/</ref> | ||
* Navigate to <code>http://localhost:8096</code> for local access. | |||
* For remote access, replace <code>localhost</code> with the server's IP address. | |||
== Configuration == <!--T:10--> | |||
=== Allowing access to external drives === <!--T:11--> | |||
<!--T:12--> | |||
Desktop environments typically mount external drives for the current user, while Jellyfin runs as the system user <code>jellyfin</code> by default. This can cause permission issues when accessing external media. | |||
<!--T:13--> | |||
The simplest solution is to change the service user: | |||
</translate> | |||
{{code|lang=nix|line=no|1={ | |||
services.jellyfin = { | services.jellyfin = { | ||
enable = true; | enable = true; | ||
openFirewall = true; | openFirewall = true; | ||
user="yourusername"; | user = "yourusername"; | ||
}; | }; | ||
< | } | ||
}} | |||
If you | <translate> | ||
<!--T:14--> | |||
If you change the user after Jellyfin is already installed, update the ownership of the data and cache directories: | |||
</translate> | |||
</ | |||
{{code|lang=bash|line=no|$ sudo chown -R yourusername:yourusername /var/lib/jellyfin | |||
$ sudo chown -R yourusername:yourusername /var/cache/jellyfin}} | |||
<translate> | |||
<!--T:15--> | |||
Then restart the service: | |||
</translate> | |||
{{code|lang=bash|line=no|$ sudo systemctl restart jellyfin}} | |||
<translate> | |||
<!--T:16--> | |||
Alternatively, configure explicit mounts via [[Filesystems]]. This approach requires more setup and each drive must be declared, but provides finer control over what Jellyfin can access. | |||
=== Hardware transcoding === <!--T:17--> | |||
</ | <!--T:18--> | ||
Modern hardware often includes video acceleration capabilities that can significantly reduce CPU usage during transcoding. For detailed information, see the [https://jellyfin.org/docs/general/post-install/transcoding/hardware-acceleration/ official Jellyfin documentation].<ref name="jellyfin-hw">Jellyfin Documentation Team, "Hardware acceleration", Jellyfin Documentation, Accessed October 2025. https://jellyfin.org/docs/general/post-install/transcoding/hardware-acceleration/</ref> | |||
== | ==== VAAPI and Intel QSV ==== <!--T:19--> | ||
<!--T:20--> | |||
Intel GPUs support Video Acceleration API (VAAPI) and Quick Sync Video (QSV). The required packages must be added to <code>hardware.graphics.extraPackages</code>. | |||
<!--T:21--> | |||
Choose the appropriate driver based on your CPU generation: | |||
* <code>intel-vaapi-driver</code> for pre-Broadwell CPUs | |||
* <code>intel-media-driver</code> for Broadwell and newer | |||
* <code>intel-compute-runtime</code> for newer processors | |||
</translate> | |||
{{Note|<code>intel-media-sdk</code> is deprecated and does not build on recent channels. Use VAAPI with <code>intel-media-driver</code> instead. See [https://discourse.nixos.org/t/intel-media-sdk-has-become-deprecated/66998 this discussion] for details.<ref name="intel-media-sdk">smana, "intel-media-sdk has become deprecated", NixOS Discourse, Accessed October 2025. https://discourse.nixos.org/t/intel-media-sdk-has-become-deprecated/66998</ref>}} | |||
{{code|lang=nix|line=no|1= | |||
{ pkgs, lib, config, ... }: | |||
{{ | |||
{ pkgs, lib,config, ... }: | |||
{ | { | ||
# Only set this if | # Only set this if using intel-vaapi-driver: | ||
nixpkgs.config.packageOverrides = pkgs: { | nixpkgs.config.packageOverrides = pkgs: { | ||
intel-vaapi-driver = pkgs.intel-vaapi-driver.override { enableHybridCodec = true; }; | intel-vaapi-driver = pkgs.intel-vaapi-driver.override { enableHybridCodec = true; }; | ||
}; | }; | ||
systemd.services.jellyfin.environment.LIBVA_DRIVER_NAME = "iHD"; # or i965 | systemd.services.jellyfin.environment.LIBVA_DRIVER_NAME = "iHD"; # or i965 for older GPUs | ||
environment.sessionVariables = { LIBVA_DRIVER_NAME = "iHD"; }; | environment.sessionVariables = { LIBVA_DRIVER_NAME = "iHD"; }; | ||
hardware.graphics = { | hardware.graphics = { | ||
enable = true; | enable = true; | ||
extraPackages = with pkgs; [ | extraPackages = with pkgs; [ | ||
intel-ocl # | intel-ocl # Generic OpenCL support | ||
# For newer | # For Broadwell and newer (ca. 2014+), use with LIBVA_DRIVER_NAME=iHD: | ||
intel-media-driver | intel-media-driver | ||
# | # For older processors, use with LIBVA_DRIVER_NAME=i965: | ||
intel-vaapi-driver | intel-vaapi-driver | ||
libva-vdpau-driver | libva-vdpau-driver | ||
# | # For 13th gen and newer: | ||
intel-compute-runtime | intel-compute-runtime | ||
# | # For older processors: | ||
intel-compute-runtime-legacy1 | |||
# For 11th gen and newer: | |||
vpl-gpu-rt | vpl-gpu-rt | ||
# | # Deprecated (may not build on recent channels): | ||
intel-media-sdk | # intel-media-sdk | ||
]; | ]; | ||
}; | }; | ||
services.jellyfin.enable = true; | services.jellyfin.enable = true; | ||
} | } | ||
< | }} | ||
<translate> | |||
==== Troubleshooting VAAPI and Intel QSV ==== <!--T:22--> | |||
<!--T:23--> | |||
Check supported VAAPI profiles: | |||
</translate> | |||
{{code|lang=bash|line=no|$ nix-shell -p libva-utils --run vainfo}} | |||
<translate> | |||
<!--T:24--> | |||
Verify OpenCL availability: | |||
</translate> | |||
{{code|lang=bash|line=no|$ nix-shell -p clinfo --run clinfo}} | |||
<translate> | |||
<!--T:25--> | |||
If <code>clinfo</code> shows <code>Number of platforms 0</code>, OpenCL is not enabled or available. | |||
<!--T:26--> | |||
[ 4.174843] i915 0000:00:10.0: [drm] *ERROR* GT0: GuC firmware i915/tgl_guc_70.bin: fetch failed -ENOENT | Monitor Intel GPU status: | ||
</translate> | |||
{{code|lang=bash|line=no|$ nix-shell -p intel-gpu-tools --run intel_gpu_top}} | |||
<translate> | |||
<!--T:27--> | |||
On Intel N100 CPUs, enable firmware loading to prevent GuC errors: | |||
</translate> | |||
{{code|lang=nix|line=no|1={ | |||
hardware.enableAllFirmware = true; | |||
} | |||
}} | |||
<translate> | |||
<!--T:28--> | |||
Without this option, you may see errors like: | |||
</translate> | |||
{{code|lang=text|line=no|[ 4.174843] i915 0000:00:10.0: [drm] *ERROR* GT0: GuC firmware i915/tgl_guc_70.bin: fetch failed -ENOENT | |||
[ 4.175621] i915 0000:00:10.0: [drm] GT0: GuC firmware(s) can be downloaded from https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/tree/i915 | [ 4.175621] i915 0000:00:10.0: [drm] GT0: GuC firmware(s) can be downloaded from https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/tree/i915 | ||
[ 4.176350] i915 0000:00:10.0: [drm] *ERROR* GT0: GuC initialization failed -ENOENT | [ 4.176350] i915 0000:00:10.0: [drm] *ERROR* GT0: GuC initialization failed -ENOENT | ||
[ 4.176977] i915 0000:00:10.0: [drm] *ERROR* GT0: Enabling uc failed (-5) | [ 4.176977] i915 0000:00:10.0: [drm] *ERROR* GT0: Enabling uc failed (-5) | ||
[ 4.177502] i915 0000:00:10.0: [drm] *ERROR* GT0: Failed to initialize GPU, declaring it wedged! | [ 4.177502] i915 0000:00:10.0: [drm] *ERROR* GT0: Failed to initialize GPU, declaring it wedged!}} | ||
< | <translate> | ||
==== VAAPI and Intel QSV on Arc GPU ==== <!--T:29--> | |||
<!--T:30--> | |||
Arc GPUs require Jellyfin to use FFmpeg compiled with <code>vpl</code> support. Use [[Overlays|an overlay]] to override the FFmpeg configuration: | |||
</translate> | |||
{{code|lang=nix|line=no|1= | |||
{ pkgs, ... }: | { pkgs, ... }: | ||
let | let | ||
jellyfin-ffmpeg-overlay = ( | jellyfin-ffmpeg-overlay = (final: prev: { | ||
jellyfin-ffmpeg = prev.jellyfin-ffmpeg.override { | |||
# Exact version depends on jellyfin-ffmpeg package | |||
# In 24.11 it's ffmpeg_7-full | |||
ffmpeg_7-full = prev.ffmpeg_7-full.override { | |||
withMfx = false; # Older media driver | |||
withVpl = true; # New driver for Arc GPUs | |||
withUnfree = true; | |||
}; | }; | ||
} | }; | ||
); | }); | ||
in | in | ||
{ | { | ||
nixpkgs.overlays = [ jellyfin-ffmpeg-overlay ]; | nixpkgs.overlays = [ jellyfin-ffmpeg-overlay ]; | ||
} | } | ||
< | }} | ||
<translate> | |||
<!--T:31--> | |||
This triggers a rebuild of the Jellyfin package. After applying, select "Intel QuickSync (QSV)" in the Jellyfin settings for hardware-accelerated transcoding with minimal CPU load. | |||
<!--T:32--> | |||
If your system has both integrated and discrete GPUs, manually select the QSV device in the Playback settings to avoid random device selection. Use <code>intel_gpu_top -L</code> to list available devices. | |||
==== VAAPI with Jellyfin in a NixOS container ==== <!--T:33--> | |||
<!--T:34--> | |||
Containers do not inherit graphics drivers from the host system. When running Jellyfin in a NixOS container, replicate the <code>hardware.graphics</code> configuration and pass through the GPU devices (typically <code>/dev/dri/card0</code> and <code>/dev/dri/renderD128</code>): | |||
</translate> | |||
{{code|lang=nix|line=no|1= | |||
{ | { | ||
allowedDevices = [ | allowedDevices = [ | ||
{ | { node = "/dev/dri/card0"; modifier = "rw"; } | ||
{ node = "/dev/dri/renderD128"; modifier = "rw"; } | |||
{ | |||
]; | ]; | ||
| Line 224: | Line 258: | ||
isReadOnly = false; | isReadOnly = false; | ||
}; | }; | ||
"/dev/dri/renderD128" = { | "/dev/dri/renderD128" = { | ||
hostPath = "/dev/dri/renderD128"; | hostPath = "/dev/dri/renderD128"; | ||
| Line 231: | Line 264: | ||
}; | }; | ||
config = | config = { | ||
# Include hardware.graphics and services.jellyfin configuration | |||
}; | |||
} | } | ||
</ | }} | ||
<translate> | |||
<!--T:35--> | |||
Verify the configuration by adding <code>libva-utils</code> to the container's <code>environment.systemPackages</code>, logging in with <code>machinectl shell container-name</code>, and running <code>vainfo</code>. Successful output looks like: | |||
</translate> | |||
{{code|lang=text|line=no|Trying display: drm | |||
libva info: VA-API version 1.22.0 | |||
libva info: Trying to open /run/opengl-driver/lib/dri/iHD_drv_video.so | |||
libva info: Found init function __vaDriverInit_1_22 | |||
libva info: va_openDriver() returns 0 | |||
vainfo: VA-API version: 1.22 (libva 2.22.0) | |||
vainfo: Driver version: Intel iHD driver for Intel(R) Gen Graphics - 25.2.6 () | |||
vainfo: Supported profile and entrypoints | |||
VAProfileNone : VAEntrypointVideoProc | |||
VAProfileNone : VAEntrypointStats | |||
/* Additional profiles depend on your hardware */}} | |||
<translate> | |||
<!--T:36--> | |||
With correct configuration, FFmpeg and Jellyfin can use hardware transcoding. | |||
== Tips and tricks == <!--T:37--> | |||
=== Intro Skipper plugin === <!--T:38--> | |||
<!--T:39--> | |||
The latest version of the Intro Skipper plugin from [https://github.com/intro-skipper/intro-skipper GitHub]<ref name="intro-skipper">Intro Skipper contributors, "Intro Skipper Jellyfin plugin", GitHub, Accessed October 2025. https://github.com/intro-skipper/intro-skipper</ref> works without manual patches on Jellyfin web, Jellyfin Media Player, and Android TV clients. | |||
<!--T:40--> | |||
If you need to manually patch the web interface for older versions, use an overlay: | |||
</translate> | |||
{{code|lang=nix|line=no|1= | |||
nixpkgs.overlays = [ | |||
(final: prev: { | |||
jellyfin-web = prev.jellyfin-web.overrideAttrs (finalAttrs: previousAttrs: { | |||
installPhase = '' | |||
runHook preInstall | |||
sed -i "s#</head>#<script src=\"configurationpage?name=skip-intro-button.js\"></script></head>#" dist/index.html | |||
mkdir -p $out/share | |||
cp -a dist $out/share/jellyfin-web | |||
runHook postInstall | |||
''; | |||
}); | |||
}) | |||
]; | |||
} | |||
}} | |||
<translate> | |||
== Troubleshooting == <!--T:41--> | |||
=== Service not starting === <!--T:42--> | |||
<!--T:43--> | |||
If Jellyfin fails to start, check the service status: | |||
{{code|lang=bash|line=no|$ sudo systemctl status jellyfin}} | |||
<!--T:44--> | |||
Review the service logs for error messages: | |||
</translate> | |||
{{code|lang=bash|line=no|$ sudo journalctl -u jellyfin -n 50}} | |||
<translate> | |||
=== Cannot access media files === <!--T:45--> | |||
<!--T:46--> | |||
Verify that the Jellyfin user has read permissions for your media directories. Check file ownership and permissions: | |||
</translate> | |||
{{code|lang=bash|line=no|$ ls -la /path/to/media}} | |||
<translate> | |||
<!--T:47--> | |||
If using a custom user for the Jellyfin service, ensure the data directories have correct ownership as described in the configuration section. | |||
== See also == <!--T:48--> | |||
<!--T:49--> | |||
* [[Filesystems]] – Declarative filesystem mounting on NixOS | |||
* [[Accelerated Video Playback]] – GPU acceleration configuration | |||
* [[Intel Graphics]] – Intel GPU driver setup | |||
* [[Overlays]] – Customizing packages with overlays | |||
* [https://search.nixos.org/options?query=jellyfin NixOS options search] – Jellyfin module options | |||
* [https://jellyfin.org/docs/ Jellyfin documentation] – Official Jellyfin documentation | |||
< | == References == <!--T:50--> | ||
</translate> | |||
</ | |||
<references/> | |||
[[Category:Server]] | [[Category:Server]] | ||
[[Category:Applications]] | [[Category:Applications]] | ||
[[Category:Web Applications]] | [[Category:Web Applications]] | ||