jellyfin-helm

Add helm-unittest tests for revisionHistoryLimit:
- Default value (3) verification
- Custom values support (0, 1, 5, 100)
- Ability to disable revision history

Add NOTES.txt with revisionHistoryLimit information:
- Show configured revision history limit
- Warning when disabled (0)
- Note for minimal history (1)
- Rollback command example for normal values

This parameter controls how many old ReplicaSets are retained
for rollback purposes, reducing etcd storage usage.

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

Aleksei SviridkinandClaude

2025-11-07 17:43:20 -07:00

e1bcdc003b

feat(deployment): add revisionHistoryLimit parameter for rollback history control

Add revisionHistoryLimit parameter to control how many old ReplicaSets are
retained for rollback purposes, reducing etcd storage usage compared to
Kubernetes default of 10.

Changes:
- Add revisionHistoryLimit parameter in values.yaml (default: 3)
- Add revisionHistoryLimit to deployment.yaml spec
- Provide comprehensive documentation with recommendations
- Bump chart version 2.5.0 -> 2.5.1 (patch - minor enhancement)
- Add changelog annotation for Artifact Hub

Benefits:
- Reduce etcd storage usage (especially important in large clusters)
- Maintain reasonable rollback capability (3 previous versions)
- Allow customization based on deployment needs
- Can be set to null to use Kubernetes default (10)

Default rationale:
- 3 revisions provides sufficient rollback capability for most use cases
- Reduces cluster resource usage (etcd storage, API server load)
- Follows best practices from production Kubernetes deployments
- Users can override if they need more history

Example usage:
  # Use default (3 revisions)
  revisionHistoryLimit: 3

  # Increase for critical deployments
  revisionHistoryLimit: 10

  # Use Kubernetes default (10)
  revisionHistoryLimit: null

  # Disable history (not recommended)
  revisionHistoryLimit: 0

See: https://kubernetes.io/docs/concepts/workloads/controllers/deployment/#revision-history-limit

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

Aleksei SviridkinandClaude

2025-11-07 17:43:20 -07:00

68ebc46dbd

test(env): add envFrom support tests and deployment notes

Add helm-unittest tests for envFrom functionality:
- No envFrom by default
- ConfigMap reference support
- Secret reference support
- Multiple envFrom sources
- Optional ConfigMap/Secret support
- Prefix support for variable namespacing
- Compatibility with regular env variables

Add NOTES.txt with envFrom information:
- Show count of envFrom sources
- List each source (ConfigMap or Secret)
- Display optional and prefix settings

Tests ensure envFrom works correctly for loading environment
variables from ConfigMaps and Secrets.

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

Aleksei SviridkinandClaude

2025-11-07 19:58:19 +03:00

ae2e042e80

test(init): add tests for initContainers deprecation and extraInitContainers

Add helm-unittest tests for init containers:
- No init containers by default
- extraInitContainers support (single and multiple)
- Full container spec preservation (command, args, volumeMounts, securityContext)
- Backward compatibility with deprecated initContainers parameter
- Merging of initContainers and extraInitContainers
- Correct ordering when both are specified

Add NOTES.txt with init containers information:
- Show count of configured init containers
- Deprecation warning when old initContainers parameter is used
- Migration guidance to extraInitContainers

This fixes the critical bug where extraInitContainers didn't work and
provides clear migration path from deprecated initContainers.

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

Aleksei SviridkinandClaude

2025-11-07 19:56:59 +03:00

2c0d9db438

test(probes): add startup probe tests and deployment notes

Add helm-unittest tests for startup probe:
- Default configuration verification (tcpSocket, timing)
- Custom timing parameters (initialDelaySeconds, periodSeconds, failureThreshold)
- Alternative probe types (httpGet)
- Custom port support
- Timeout window calculation

Add NOTES.txt with startup probe information:
- Display max startup time calculation
- Explain startup probe purpose for large libraries
- Warning for very long startup timeouts

Tests ensure startup probe works correctly for slow initial startup scenarios.

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

Aleksei SviridkinandClaude

2025-11-07 19:56:02 +03:00

916087f1de

test(persistence): add comprehensive cache volume tests

Add helm-unittest tests for dedicated cache volume persistence:
- Default emptyDir behavior
- PVC creation when enabled
- hostPath configuration
- Volume mount verification
- PVC size, access mode, storage class configuration
- Annotations support
- Existing claim usage
- Type-specific behavior (pvc vs hostPath vs emptyDir)

Add NOTES.txt with persistence information:
- Show config, media, and cache volume types
- Display cache volume details when enabled
- Benefits explanation for cache volume
- Warning for hostPath usage

Tests ensure cache persistence works correctly for all scenarios.

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

Aleksei SviridkinandClaude

2025-11-07 19:54:22 +03:00

91d50ab918

test(service): add IPv6 and dual-stack configuration tests

Add helm-unittest tests for IPv6 and dual-stack Service configuration:
- Default behavior (no ipFamilyPolicy/ipFamilies set)
- SingleStack, PreferDualStack, RequireDualStack policies
- IPv4 only, IPv6 only configurations
- Dual-stack with IPv4 primary and IPv6 primary
- Combined policy and families configurations

Add NOTES.txt with IPv6/dual-stack information:
- Display configured IP family policy
- Show IP families list
- Warning when IPv6 is primary (probe compatibility note)
- Warning when IPv6 used without policy

Tests ensure IPv6 and dual-stack work correctly for all scenarios.

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

Aleksei SviridkinandClaude

2025-11-07 19:53:08 +03:00

1744d24011

test(httproute): add comprehensive unit tests and deployment notes

Add helm-unittest test suite for HTTPRoute (Gateway API) covering:
- Not created by default (enabled: false)
- Created when enabled with required configuration
- Annotations support
- parentRefs configuration (name, namespace, sectionName)
- Hostnames support (single and multiple)
- Path matching rules (PathPrefix, Exact)
- Multiple rules and multiple matches per rule
- Backend references to Jellyfin service
- Custom service port handling

Add NOTES.txt with HTTPRoute-specific deployment information:
- Gateway references and configuration status
- Configured hostnames
- Number of routes
- Backend service details
- Access URLs when hostnames configured
- Warnings for missing parentRefs

Tests ensure HTTPRoute works correctly across all Gateway API scenarios.

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

Aleksei SviridkinandClaude

2025-11-07 19:48:09 +03:00

77241b18b5

feat(deployment): add envFrom support for ConfigMap/Secret environment variables

Add support for loading environment variables from ConfigMap or Secret
resources using envFrom field, following Kubernetes best practices for
configuration management.

Changes:
- Add jellyfin.envFrom parameter in values.yaml
- Add envFrom section in deployment.yaml template (before env)
- Provide comprehensive documentation with examples
- Bump chart version 2.5.0 -> 2.6.0 (minor - new feature)
- Add changelog annotation for Artifact Hub

Use cases:
- Load multiple environment variables from ConfigMap without defining each one
- Load secrets from external secret management systems
- Separate configuration from chart values (12-factor app pattern)
- Simplify configuration for complex deployments

Example usage:
  jellyfin:
    envFrom:
      - configMapRef:
          name: jellyfin-config
      - secretRef:
          name: jellyfin-secrets

Follows standard Kubernetes patterns used by most community Helm charts.

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

Aleksei SviridkinandClaude

2025-11-06 13:34:40 +03:00

d20aac5794

fix(templates)!: deprecate initContainers in favor of extraInitContainers

BREAKING CHANGE: The 'initContainers' parameter is now deprecated in favor
of 'extraInitContainers' for naming consistency with 'extraContainers'.
Both parameters will work until 2030 for backward compatibility.

The previous implementation used '.Values.initContainers' in the template
but 'extraInitContainers' was defined in values.yaml, causing the feature
to be completely non-functional.

Changes:
- Fix extraInitContainers not working (was referencing wrong parameter)
- Add deprecated 'initContainers' parameter to values.yaml with @deprecated tag
- Update deployment.yaml to support both parameters with OR logic
- Add TODO comment to remove initContainers support after 2030
- Create NOTES.txt with:
  - Deprecation warning when using initContainers
  - Post-installation instructions for accessing Jellyfin
  - Persistence status information
  - Links to documentation
- Improve extraInitContainers documentation with usage example
- Bump chart version 2.5.0 -> 3.0.0 (major due to deprecation)
- Add comprehensive changelog to artifacthub.io/changes

Migration guide:
  Old: initContainers: [...]
  New: extraInitContainers: [...]

The old parameter will continue to work but users will see a deprecation
warning in NOTES.txt after installation.

Follows best practices from community charts (Prometheus, Elastic, etc.)
where 'extra*' prefix indicates user-provided extension points.

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

Aleksei SviridkinandClaude

2025-11-06 00:51:45 +03:00

90861109aa

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>

Aleksei SviridkinandClaude

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

df3e66c5f9

feat(persistence): add cache volume persistence support

Add dedicated cache volume configuration to reduce wear on SD cards and improve
performance by allowing cache to be stored on separate storage.

Changes:
- Add persistence.cache configuration in values.yaml with support for:
  - PVC (default type when enabled)
  - hostPath for direct host mount
  - emptyDir (default when disabled)
- Add cache volume mount at /cache in deployment
- Add cache PersistentVolumeClaim template
- Support for existing PVC via existingClaim
- Configurable size (default 10Gi), accessMode, storageClass, and annotations
- Update Chart version from 2.5.0 to 2.5.1
- Add Artifact Hub changelog annotation

The cache volume is disabled by default to maintain backward compatibility.
Users can enable it via:

```yaml
persistence:
  cache:
    enabled: true
    type: pvc
    size: 10Gi
```

This addresses the use case mentioned in #62 where users want to avoid SD card
wear by storing cache on separate persistent storage.

Fixes: #62

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

Aleksei SviridkinandClaude

2025-11-05 23:26:58 +03:00

35f39bf92c

fix(ipv6): use httpGet probes by default for IPv4 and IPv6 compatibility

Change default health probes from tcpSocket to httpGet to fix issue #68
where pods fail to start in IPv6-only clusters due to incompatible health checks.

Changes:
- Change default livenessProbe and readinessProbe to use httpGet with /health endpoint
- Add comprehensive IPv6 and dual-stack configuration documentation
- Document ipFamilyPolicy options (SingleStack, PreferDualStack, RequireDualStack)
- Document ipFamilies configuration for IPv4-only, IPv6-only, and dual-stack setups
- Add IPv6 Configuration section to README with examples
- Update Chart version from 2.5.0 to 2.5.1

The httpGet probe works with both IPv4 and IPv6 out of the box, while tcpSocket
may fail in IPv6-only environments. Jellyfin's /health endpoint is specifically
designed for health checks and verifies both HTTP and database connectivity.

Fixes: #68

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

Aleksei SviridkinandClaude

2025-11-05 22:56:01 +03:00

250a126357

feat(gateway-api): add HTTPRoute support

Add support for Kubernetes Gateway API HTTPRoute resource as a modern
alternative to Ingress. The implementation follows the same pattern as
the existing Ingress template.

Changes:
- Add HTTPRoute template with configurable parentRefs, hostnames, and rules
- Add httpRoute section to values.yaml with generic examples
- Update Chart version from 2.5.0 to 2.6.0
- Add Artifact Hub changelog annotation
- Add HTTPRoute documentation to README

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

Aleksei SviridkinandClaude

2025-11-05 22:36:09 +03:00

f1ae87fba9

docs(charts): 📝 write updated reademe

github-actions[bot]

2025-11-03 03:47:15 +00:00

2401a45bb1

chore(jellyfin): Bump chart version to 2.5.0 and set appVersion to 10.11.2

github-actions[bot]

2025-11-03 03:47:07 +00:00

2c1f2a526c

docs(charts): 📝 write updated reademe

github-actions[bot]

2025-11-03 03:46:43 +00:00

464c663c92

feat: allow to enable or disable some pod privileges (#82 )

Benoît Sauvère

2025-11-02 20:46:36 -07:00

39cb96db5d

docs(charts): 📝 write updated reademe

github-actions[bot]

2025-11-03 03:46:27 +00:00

969f7b8885

Update jellyfin/jellyfin Docker tag to v10.11.2 (#85 )

renovate[bot]

2025-11-02 20:46:19 -07:00

8a0fcbda21

docs(charts): 📝 write updated reademe

github-actions[bot]

2025-10-27 07:04:09 +00:00

9fbd74d9b7

Update jellyfin/jellyfin Docker tag to v10.11.1

renovate[bot]

2025-10-27 03:30:07 +00:00

2e5386532e

docs(charts): 📝 write updated reademe

github-actions[bot]

2025-10-20 03:31:47 +00:00

5464aa942e

chore(jellyfin): Bump chart version to 2.4.0 and set appVersion to 10.11.0

github-actions[bot]

2025-10-20 03:31:37 +00:00

aff38deb68

docs(charts): 📝 write updated reademe

github-actions[bot]

2025-10-20 03:29:56 +00:00

03f319d762

Update jellyfin/jellyfin Docker tag to v10.11.0 (#80 )

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

renovate[bot]

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

e61721a0c4

docs(charts): 📝 write updated reademe

github-actions[bot]

2025-10-20 03:28:39 +00:00

2626f04146

Add dnsConfig and dnsPolicy options (#72 )

Flozza

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

29400a65d5

Merge pull request #65 from FML128/master

Fix for fresh start with metrix and hostPath option for media

Tim Eisele

2025-05-01 16:06:28 +02:00

1b01cffb2d

docs(charts): 📝 write updated reademe

github-actions[bot]

2025-05-01 14:06:13 +00:00

b6ef73e01b

docs(charts): 📝 write updated reademe

github-actions[bot]

2025-04-27 22:10:07 +00:00

2d884535f4

Fixed README to be consistant with Values

Merlin Jehli

2025-04-28 00:09:47 +02:00

d056210a1e

Added option for media mount to be a hostpath

Merlin Jehli

2025-04-28 00:09:20 +02:00

e92576240c

Fixed init with metrics on

Merlin Jehli

2025-04-28 00:08:38 +02:00

54ccfcb5b3

Update jellyfin/jellyfin Docker tag to v10.10.7

renovate[bot]

2025-04-05 20:48:32 +00:00

f82d00dcfa

docs(charts): 📝 write updated reademe

github-actions[bot]

2025-03-23 14:31:20 +00:00

0fcf1d2206

Add option for priorityClassName (#59 )

Signed-off-by: javex <code@inexplicity.de>

Flozza

2025-03-23 08:31:01 -06:00

580d063de4

docs(charts): 📝 write updated reademe

github-actions[bot]

2025-03-23 14:30:46 +00:00

a505e00c4a

Add option for deployment annotations (#60 )

Jared

2025-03-23 08:30:37 -06:00

712769f4f8