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

Install from the Dashboard

Open App Dashboard → Package Management (/dashboard?mode=packages), find Jellyfin in the catalog (browse Media Servers or search), and click Install. The dashboard streams the install log live and Jellyfin appears in your Application Control panel when it finishes. Reinstall, Update, and Remove are available from the same panel.

In the install dialog you can pick the release channel — Stable (default) or Beta for early features — and optionally set a custom domain with SSL. See Channels & Versions for how channels work.

What you see and can manage is gated by your account: admins manage any user’s apps; regular users manage their own. For the full package flow see App Management.

Install and manage from the CLI

The CLI runs the same install and is suited to automation and scripting. The --beta channel flag and -d domain map to the Dashboard choices above:

qb install jellyfin -u username
qb install jellyfin -u username --beta
qb install jellyfin -u username -d 'jellyfin.yourdomain.com'
qb install jellyfin -u username --beta -d 'jellyfin.yourdomain.com'
qb reinstall jellyfin -u username
qb update jellyfin -u username
qb remove jellyfin -u username
qb help jellyfin

The complete command set:

Updates auto-detect the current channel from the install marker, so you only pass --beta to switch channels. Full flag reference: CLI Reference.

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

Related Applications

Live TV, tuners, and HDHomeRun

Additional Resources