initial commit

roles/jellyfin/README.md

@@ -0,0 +1,50 @@
+# Jellyfin
+
+Deploy Jellyfin media server using Docker Compose.
+
+## Description
+
+Jellyfin is a free and open-source media server for organizing, managing, and streaming media files with optional GPU hardware acceleration.
+
+## Variables
+
+### Optional
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `jellyfin_http_port` | `8096` | Web interface port |
+| `jellyfin_discovery_port` | `7359` | Auto-discovery port |
+| `jellyfin_config_path` | `{{ app_dir }}/config` | Configuration storage |
+| `jellyfin_cache_path` | `{{ app_dir }}/cache` | Cache storage |
+| `jellyfin_container_version` | `latest` | Jellyfin Docker image tag |
+| `jellyfin_container_name` | `{{ app_name }}` | Container name |
+| `jellyfin_restart_policy` | `{{ app_restart_policy }}` | Container restart policy |
+| `jellyfin_uid` | `{{ app_uid }}` | User ID for file permissions |
+| `jellyfin_gid` | `{{ app_gid }}` | Group ID for file permissions |
+| `jellyfin_gpu_passthrough` | `false` | Enable NVIDIA GPU support |
+| `jellyfin_server_url` | See defaults | Custom domain for server |
+| `jellyfin_libraries` | `[]` | List of media library mappings with `host_path` and `container_path` |
+
+#### Example Media Libraries Configuration
+
+```yaml
+jellyfin_libraries:
+  - host_path: "/storage/movies"
+    container_path: /movies
+  - host_path: "/storage/tv_shows"
+    container_path: /tv_shows
+  - host_path: "/storage/anime"
+    container_path: /anime
+```
+
+## Example
+
+```yaml
+- role: patrickj.docker_apps.jellyfin
+  vars:
+    shared_media_path: /storage/media
+    jellyfin_gpu_passthrough: true
+    jellyfin_libraries:
+      - host_path: /storage/media/movies
+        container_path: /movies
+```