Jellyfin

Free and open-source media server with complete privacy control

Jellyfin is a free software media system that puts you in complete control of managing and streaming your media. With no premium features, no account requirements, and no tracking, Jellyfin offers a truly private media server experience. QuickBox Pro installs Jellyfin from the latest stable releases with custom-compiled ffmpeg for optimal transcoding, per-user systemd services, auto-incremented ports, and optional beta branch access for early adopters.

Installation

Basic Installation

Install Jellyfin for a specific user:

qb install jellyfin -u username

Beta Installation

Install latest beta/unstable version for early features:

qb install jellyfin -u username --beta

Advanced Installation Options

# Install with custom domain and SSL
qb install jellyfin -u username -d 'jellyfin.yourdomain.com'
 
# Install beta with custom domain
qb install jellyfin -u username --beta -d 'jellyfin.yourdomain.com'

CLI Commands

Accessing Jellyfin

After installation, access Jellyfin at:

https://your-server-ip/username/jellyfin

Or via direct port access:

http://your-server-ip:8096

First-Time Setup:

1. Create your admin account (local only—no Jellyfin.org account required)
2. Set up your media libraries (Movies, TV Shows, Music, Books)
3. Configure metadata providers and language preferences
4. (Optional) Enable remote access and HTTPS

Initial Configuration

1. Create Admin Account

On first access, create your local admin account:

1. Enter username (no email required)
2. Set password for admin account
3. Click Next to continue setup
4. Your account is stored locally—no cloud registration

2. Add Media Libraries

Set up libraries for your media:

1. Click Add Media Library button
2. Select library type:
   • Movies - Feature films and home videos
   • Shows - Television series and episodes
   • Music - Audio files and albums
   • Books - eBooks and audiobooks
3. Add folder paths:
   • /home/username/media/movies
   • /home/username/media/tv
   • /home/username/media/music
   • Or custom paths you’ve configured
4. Configure metadata providers:
   • The Movie Database (TMDb) - Movies and TV shows
   • The TVDB - Television series
   • MusicBrainz - Music metadata
5. Set language preferences for metadata
6. Click OK to save library

3. Configure Playback Settings

Optimize transcoding and playback:

1. Go to Dashboard → Playback
2. Configure transcoding:
   • Hardware acceleration: Select your GPU (Intel QuickSync, NVIDIA NVENC, AMD AMF) if available
   • Transcoding thread count: Set to number of CPU cores
   • FFmpeg path: Should be /home/username/.local/bin/ffmpeg (auto-configured)
3. Set streaming quality preferences:
   • Internet streaming: Quality for remote access
   • Max streaming bitrate: Bandwidth limits
4. Save settings

Service Management

Jellyfin runs as a per-user systemd service.

systemctl status jellyfin@username     # Check status
systemctl restart jellyfin@username    # Restart service
journalctl -u jellyfin@username -f     # View live logs
systemctl enable jellyfin@username     # Start on boot (already enabled)
systemctl disable jellyfin@username    # Prevent auto-start

Troubleshooting

Jellyfin Won’t Start

journalctl -u jellyfin@username -f

Check data directory permissions:

ls -la /home/username/.config/Jellyfin
# Should be owned by username:username
sudo chown -R username:username /home/username/.config/Jellyfin

FFmpeg Not Found or Transcoding Fails

Can’t Access Web Interface

# Check if service is running
systemctl status jellyfin@username
 
# Verify ports are assigned correctly
grep -E "(PublicPort|InternalHttp)" ~/.config/Jellyfin/network.xml
 
# Check nginx reverse proxy (if using custom domain)
sudo nginx -t
sudo systemctl reload nginx
 
# Test direct port access
curl http://localhost:8096

Hardware Transcoding Not Working

Hardware transcoding requires compatible GPU and correct drivers:

# Check GPU availability (Intel, NVIDIA, AMD)
lspci | grep -i vga
 
# Verify render group membership
groups username
# Should include: render video
 
# Add to groups if missing
sudo usermod -a -G render username
sudo usermod -a -G video username
sudo systemctl restart jellyfin@username
 
# Check /dev/dri device access
ls -la /dev/dri
sudo chown -R root:render /dev/dri

Library Not Scanning

# Manual library scan via web interface
# Dashboard → Libraries → Scan All Libraries
 
# Check file permissions
sudo chown -R username:username /home/username/media
 
# Verify Jellyfin can access media directory
ls -la /home/username/media
 
# Check scanning logs
journalctl -u jellyfin@username -f | grep -i "scan"

Configuration Reset

# Backup current configuration
cp -r ~/.config/Jellyfin ~/.config/Jellyfin.backup
 
# Stop service
systemctl stop jellyfin@username
 
# Reset configuration (keeps libraries and database)
rm ~/.config/Jellyfin/network.xml
rm ~/.config/Jellyfin/system.xml
 
# Restart service (will regenerate config files)
systemctl start jellyfin@username

Best Practices

Use Cases

Privacy-Focused Media Server

• Complete privacy with no cloud services, tracking, or external accounts
• All data stays on your server under your control
• No telemetry or usage reporting to third parties
• Perfect for privacy-conscious users

Open-Source Alternative to Plex

• Free alternative with all features unlocked (no premium tiers)
• Hardware transcoding available without subscriptions
• Active community development and plugin ecosystem
• Cross-platform apps for all major devices

Multi-User Family Server

• Create separate accounts for family members with access controls
• Parental controls and content restrictions per user
• Individual watch history and recommendations
• Share libraries while controlling who sees what

Related Applications

Additional Resources