homelab-optimized/docs/services/individual/jellyfin.md

Jellyfin

🟡 Media Service

📋 Service Overview

Property	Value
Service Name	jellyfin
Host	Chicago_vm
Category	Media
Difficulty	🟡
Docker Image	jellyfin/jellyfin
Compose File	Chicago_vm/jellyfin.yml
Directory	Chicago_vm

🎯 Purpose

Jellyfin is a Free Software Media System that puts you in control of managing and streaming your media.

🚀 Quick Start

Prerequisites

• Docker and Docker Compose installed
• Basic understanding of REDACTED_APP_PASSWORD
• Access to the host system (Chicago_vm)

Deployment

# Navigate to service directory
cd Chicago_vm

# Start the service
docker-compose up -d

# Check service status
docker-compose ps

# View logs
docker-compose logs -f jellyfin

🔧 Configuration

Docker Compose Configuration

container_name: jellyfin
environment:
- JELLYFIN_PublishedServerUrl=http://stuff.thevish.io
extra_hosts:
- host.docker.internal:host-gateway
image: jellyfin/jellyfin
ports:
- 8096:8096
- 8920:8920
- 7359:7359/udp
- 1900:1900/udp
restart: unless-stopped
user: 0:0
volumes:
- /root/jellyfin/config:/config
- /root/jellyfin/cache:/cache
- /root/jellyfin/media:/media
- /root/jellyfin/media2:/media2:ro

Environment Variables

Variable	Value	Description
JELLYFIN_PublishedServerUrl	http://stuff.thevish.io	Configuration variable

Port Mappings

Host Port	Container Port	Protocol	Purpose
8096	8096	TCP	Service port
8920	8920	TCP	Service port
7359	7359	UDP	Service port
1900	1900	UDP	Service port

Volume Mappings

Host Path	Container Path	Type	Purpose
/root/jellyfin/config	/config	bind	Configuration files
/root/jellyfin/cache	/cache	bind	Cache data
/root/jellyfin/media	/media	bind	Media files
/root/jellyfin/media2	/media2	bind	Media files

🌐 Access Information

Service ports: 8096:8096, 8920:8920, 7359:7359/udp, 1900:1900/udp

🔒 Security Considerations

• ⚠️ Consider adding security options (no-new-privileges)
• ✅ Non-root user configured

📊 Resource Requirements

No resource limits configured

Recommended Resources

• Minimum RAM: 512MB
• Recommended RAM: 1GB+
• CPU: 1 core minimum
• Storage: Varies by usage

Resource Monitoring

Monitor resource usage with:

docker stats

🔍 Health Monitoring

⚠️ No health check configured Consider adding a health check:

healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:PORT/health"]
  interval: 30s
  timeout: 10s
  retries: 3

Manual Health Checks

# Check container health
docker inspect --format='{{.State.Health.Status}}' CONTAINER_NAME

# View health check logs
docker inspect --format='{{range .State.Health.Log}}{{.Output}}{{end}}' CONTAINER_NAME

🚨 Troubleshooting

Common Issues

Service won't start

• Check Docker logs: docker-compose logs service-name
• Verify port availability: netstat -tulpn | grep PORT
• Check file permissions on mounted volumes

Can't access web interface

• Verify service is running: docker-compose ps
• Check firewall settings
• Confirm correct port mapping

Performance issues

• Monitor resource usage: docker stats
• Check available disk space: df -h
• Review service logs for errors

Media not showing

• Check media file permissions
• Verify volume mounts are correct
• Scan media library manually

Useful Commands

# Check service status
docker-compose ps

# View real-time logs
docker-compose logs -f jellyfin

# Restart service
docker-compose restart jellyfin

# Update service
docker-compose pull jellyfin
docker-compose up -d jellyfin

# Access service shell
docker-compose exec jellyfin /bin/bash
# or
docker-compose exec jellyfin /bin/sh

📚 Additional Resources

• Official Documentation: Check the official docs for jellyfin
• Docker Hub: jellyfin/jellyfin
• Community Forums: Search for community discussions and solutions
• GitHub Issues: Check the project's GitHub for known issues
• Jellyfin Documentation: https://jellyfin.org/docs/
• Jellyfin Forum: https://forum.jellyfin.org/

🔗 Related Services

Services REDACTED_APP_PASSWORD jellyfin:

• Plex
• Jellyfin
• Radarr
• Sonarr
• Bazarr

---

This documentation is auto-generated from the Docker Compose configuration. For the most up-to-date information, refer to the official documentation and the actual compose file.

Last Updated: 2025-11-17
Configuration Source: Chicago_vm/jellyfin.yml