jellyfin

# Jellyfin - Media Server Management

## Overview

The `jellyfin` command manages Jellyfin media server instances using Podman Quadlet containers. It supports hardware transcoding and FUSE filesystem compatibility for network mounts.

**Key Concept:** Multi-instance support allows running multiple media libraries. FUSE compatibility enables rclone/sshfs mounts for cloud or remote storage.

## Quick Reference

| Action | Command | Description |
|--------|---------|-------------|
| Config | `ujust jellyfin config` | Configure Jellyfin |
| Delete | `ujust jellyfin delete` | Remove instance config and container |
| Logs | `ujust jellyfin logs [--lines=N]` | View container logs |
| Restart | `ujust jellyfin restart` | Restart server |
| Shell | `ujust jellyfin shell [-- CMD]` | Open shell or execute command in container |
| Start | `ujust jellyfin start` | Start Jellyfin media server |
| Status | `ujust jellyfin status` | Show instance status |
| Stop | `ujust jellyfin stop` | Stop Jellyfin media server |
| URL | `ujust jellyfin url` | Show web UI access URL |

## Configuration

### Parameters

| Parameter | Long Flag | Short | Required | Description |
|-----------|-----------|-------|----------|-------------|
| Config Dir | `--config-dir` | `-c` | Yes | Configuration directory |
| Cache Dir | `--cache-dir` | - | Yes | Cache directory (transcoding) |
| Media Dir | `--media-dir` | - | Yes | Media library path |
| Instance | `--instance` | `-n` | No | Instance number (default: 1) |
| GPU Type | `--gpu-type` | `-g` | No | GPU: nvidia, amd, intel, auto |
| Image | `--image` | `-i` | No | Container image |
| Tag | `--tag` | `-t` | No | Image tag (default: stable) |
| Workspace | `--workspace-dir` | `-w` | No | Optional mount to /workspace |
| Bind | `--bind` | `-b` | No | Bind address |
| Port | `--port` | `-p` | No | Service port |
| Lines | `--lines` | `-l` | No | Log lines to show |

### Configuration Examples

```bash
# Basic installation (long form)
ujust jellyfin config