0 Fork 0

T

Aleksei SviridkinandClaude df3e66c5f9 feat(probes): add startup probe for handling slow initial startup

Add startupProbe to give Jellyfin sufficient time to start, especially
with large media libraries or slow storage. This prevents Kubernetes
from killing the pod during initial startup phase.

Changes:
- Add startupProbe configuration in values.yaml with sensible defaults
  - failureThreshold: 30 (allows up to 5 minutes for startup)
  - periodSeconds: 10
  - Uses tcpSocket check on http port
- Update deployment.yaml to include startupProbe from values
- Bump chart version 2.5.0 -> 2.5.1
- Add changelog annotation for Artifact Hub

Benefits:
- Prevents pod restarts during slow initial startup (large media libraries)
- Liveness and readiness probes remain responsive after successful startup
- Fully configurable and can be disabled by setting startupProbe: null
- No breaking changes, backward compatible

The startup probe gives Jellyfin up to 5 minutes (30 attempts * 10 seconds)
to complete initialization. After the first success, liveness and readiness
probes take over with their normal timing.

Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: Aleksei Sviridkin <f@lex.la>

df3e66c5f9 · 2025-11-06 00:04:39 +03:00

112 Commits

.github

Update actions/checkout action to v5 (#74 )

2025-10-19 21:29:20 -06:00

charts/jellyfin

feat(probes): add startup probe for handling slow initial startup

2025-11-06 00:04:39 +03:00

.gitignore

Initial commit (#2 )

2024-05-20 17:24:10 -06:00

LICENSE

Create LICENSE (#3 )

2024-05-20 17:23:21 -06:00

README.md

Correct directory name in README (#78 )

2025-10-19 21:28:14 -06:00

README.md

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

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.