[BUG] JELLYFIN_CONFIG_DIR=/config makes .NET watch the entire /config tree (incl. metadata), exhausting inotify watches
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 4/5
- Thời gian dự kiến
- 3-5 ngày
- Mức phù hợp với người mới
- 25/100
- Loại issue
- Lỗi
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- csharp, docker, dockerfile, linux
- Lĩnh vực
- devops, infrastructure
Hướng nghiên cứu
Start with the svc-jellyfin run script, where JELLYFIN_CONFIG_DIR is exported as /config, and with the Dockerfile that sets the default config path. Confirm the watch count by comparing inotify watches to the directories under /config. Done means Jellyfin only watches its config files, with existing installs migrated safely, and the choice between a /config/config subfolder and a Dockerfile-level override is settled first.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Is there an existing issue for this?
- I have searched the existing issues
Related: #331 (same symptom, attributed to real-time monitoring) and #22 (config path differs from the official image).
Current Behavior
The svc-jellyfin run script exports JELLYFIN_CONFIG_DIR="/config". Jellyfin registers its logging config with SetBasePath(appPaths.ConfigurationDirectoryPath) and AddJsonFile(..., reloadOnChange: true) (Jellyfin.Server/Program.cs ~L400-403). On Linux, .NET's physical file provider watches that base path recursively (one inotify watch per subdirectory). With the config dir set to /config, that includes /config/data/metadata, /config/cache, etc.
Measured on a host running linuxserver/jellyfin 12.2:
/config/data/metadataholds ~96,000 directories (mostlyPeople/*).- The Jellyfin process holds 117,465 inotify watches, all on the
/configfilesystem (sampled inodes resolve to/configand/config/data/metadata/People/...). - Disabling real-time monitoring on every library and restarting changes nothing (still 117,465).
- Because the limit is per UID, other containers running as the same PUID run out of watches. In our case Plex's EasyAudioEncoder failed with
EAE timeout! EAE not running, or wrong folder?.
This is why #331 saw exhaustion that did not go away with real-time monitoring settings.
Expected Behavior
Only Jellyfin's actual config files (system.xml, logging*.json, ...) are watched, as with the official image, where the config dir is a dedicated subfolder and the watch count stays small.
Possible backward-compatible fix: point JELLYFIN_CONFIG_DIR at a dedicated folder (e.g. /config/config) with a one-time init step that moves *.xml / logging*.json there if they still sit in /config. Or, as suggested in #22, move the env into the Dockerfile so users can override it.
Steps To Reproduce
- Run
linuxserver/jellyfinwith a library large enough to produce a few thousand metadata folders. - Count watches held by Jellyfin:
cat /proc/$(pgrep -f /usr/bin/jellyfin)/fdinfo/* | grep -c '^inotify wd:' - Compare with
find /config -xdev -type d | wc -linside the container: the watch count tracks the total number of directories under/config. - Disable real-time monitoring for all libraries and restart: the count does not change.
Environment
- OS: Debian-based umbrelOS 2.0 (host 1); Ubuntu 24.04 VPS (host 2, small library, same pattern: ~2 watches per directory under
/config) - How docker service was installed: distro packages / umbrelOS
CPU architecture
x86-64
Docker creation
services:
jellyfin:
image: linuxserver/jellyfin:version-12.2ubu2604
environment:
- PUID=1000
- PGID=1000
volumes:
- ./jellyfin:/config
Container logs
No Jellyfin errors; the effect shows up in other processes under the same UID, e.g. Plex:
[eac3_eae] EAE timeout! EAE not running, or wrong folder? Could not read '/run/plex-temp/.../EasyAudioEncoder/Convert to WAV (to 8ch or less)/...'
Host: fs.inotify.max_user_watches = 122404; watches in use by UID 1000 = 122386 (Jellyfin 117465, Syncthing 4751)
Investigated and written with the help of an AI assistant; all numbers above were measured on my own servers.
- Ngôn ngữ chính
- Dockerfile
- Star
- 909
- Fork
- 136
- Merge trung bình
- 4 giờ 31 phút
- Pull request đã merge (30 ngày)
- 1
Chuẩn bị môi trường
- Có Dockerfile hoặc tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của linuxserver/docker-jellyfin
-
no-issue-activity
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
linuxserver/docker-jellyfin#336 · 3 bình luận · 1 reaction ·
-
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 48/100
linuxserver/docker-jellyfin#343 · 20 bình luận ·
-
Critical Bug: Core migration initiated on V12 but resulted in 0-byte database truncation on UGOS ProĐang mởno-issue-activity
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 30/100
linuxserver/docker-jellyfin#339 · 6 bình luận ·
Tất cả issue của linuxserver/docker-jellyfin
Issue tương tự
-
windows-artifacts: the win-arm64 job uses a Visual Studio generator missing from windows-11-armĐang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 86/100
-
Own-agent checks: reject the Actions bot id in admit.mjs and test the source label in pr-verifyĐang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 74/100
melodic-software/claude-code-plugins#17374 · 2 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
area: doc-engine area: infrastructure bug community-request
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
snapotter-hq/SnapOtter#4834 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 73/100
soroswap/token-list#125 ·
Maintainer thường phản hồi trong vòng 1 ngày