Aleksei SviridkinandClaude
4a45dc998a
Add comprehensive troubleshooting documentation for inotify instance limit
errors that cause Jellyfin crashes in environments with many containers.
Changes:
- Add Troubleshooting section to README with inotify limits explanation
- Document proper solution: increase kernel limits via sysctl
- Provide workaround for managed clusters: DOTNET_USE_POLLING_FILE_WATCHER
- Add commented example in values.yaml for easy copy-paste
- Update Chart version from 2.5.0 to 2.5.1
- Add Artifact Hub changelog annotation
The proper solution is to increase inotify limits on Kubernetes nodes:
```bash
sysctl -w fs.inotify.max_user_instances=512
```
For managed Kubernetes where node access is restricted, users can use the
polling workaround (less efficient but functional):
```yaml
jellyfin:
env:
- name: DOTNET_USE_POLLING_FILE_WATCHER
value: "1"
```
This addresses the crash issue mentioned in #64.
Fixes: #64
Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: Aleksei Sviridkin <f@lex.la>
4a45dc998a
·
2025-11-05 23:32:38 +03:00
112 Commits
Jellyfin Helm Charts Repository
This repository contains Helm charts for the jellyfin project.
Repository Structure
Each Helm chart is stored in its own directory. Each chart follows the standard Helm chart structure:
jellyfin-helm/
├── jellyfin/
│ ├── Chart.yaml
│ ├── values.yaml
│ ├── templates/
│ └── ...
├── chart2/
│ ├── Chart.yaml
│ ├── values.yaml
│ ├── templates/
│ └── ...
└── ...
Chart.yaml: Contains metadata about the chart (name, version, app version, etc.).values.yaml: Default configuration values for the chart.templates/: The Kubernetes resource templates (YAML files) that Helm uses to deploy the chart.
How to Use the Charts
1. Add this Repository
To use the charts in this repository, first add the repository to Helm:
helm repo add jellyfin https://jellyfin.github.io/jellyfin-helm
helm repo update
2. Install a Chart
To install a chart from this repository, use the following command:
helm install <release-name> jellyfin/<chart-name>
3. Customize Installation
You can customize the installation by passing in custom values via the --set flag or by using a values.yaml file:
helm install <release-name> jellyfin/<chart-name> --set key=value
or
helm install <release-name> jellyfin/<chart-name> -f custom-values.yaml
Contributing
Feel free to contribute to this repository by:
- Submitting new charts.
- Fixing bugs or issues.
- Improving documentation.
To contribute, fork this repository, create a new branch, and submit a pull request with your changes.
License
This repository is licensed under the MIT License. See the LICENSE file for more details.