Skip to Content
Emby

Emby

Feature-rich media server with live TV and DVR

Emby Server is a client-server media system that lets you host your personal multimedia library—movies, TV shows, music, and photos. With built-in live TV and DVR capabilities, mobile sync, and cross-platform apps, Emby provides a feature-rich media experience. QuickBox Pro installs Emby from official releases with per-user systemd services, auto-incremented ports, self-signed SSL certificates, and optional beta branch access.

Live TV & DVR

Built-in support for TV tuners with recording and time-shifting capabilities

Rich Metadata

Automatic artwork, descriptions, cast information, and ratings for all media

Hardware Transcoding

GPU-accelerated transcoding for smooth playback on any device

Mobile Sync

Download media to mobile devices for offline viewing (Emby Premiere)

Cross-Platform Apps

Apps for iOS, Android, smart TVs, streaming devices, and web browsers

Beta Releases

Optional beta branch for early access to new features and improvements

Emby Premiere Features
Info

Emby offers Emby Premiere subscriptions with premium features including mobile sync, cloud sync, DVR, and Cinema Mode. QuickBox Pro installs the free version—Emby Premiere can be purchased separately from emby.media.


Installation

Install from the Dashboard

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

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:

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

The complete command set:

CommandDescription
qb install emby -u username
Install Emby stable version
qb install emby -u username --beta
Install Emby beta version
qb install emby -u username -d 'emby.yourdomain.com'
Install with a custom subdomain and automatic SSL
qb install emby -u username --beta -d 'emby.yourdomain.com'
Install the beta build on a custom subdomain
qb reinstall emby -u username
Reinstall Emby (preserves data directory)
qb update emby -u username
Update to latest stable version
qb remove emby -u username
Remove Emby and clean up files
qb help emby
Display comprehensive help information

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

Automatic Port Assignment
Tip

QuickBox automatically assigns ports per user:

  • HTTP port: Starting at 8000 (auto-incremented per user)
  • HTTPS port: Starting at 8900 (auto-incremented per user)

Find your assigned ports in the QuickBox dashboard or in ~/.config/Emby/config/system.xml.

Automatic SSL Certificate
Info

QuickBox generates a self-signed PKCS12 certificate at /home/username/.ssl/embylocal.pfx for HTTPS access. Enable HTTPS in Emby settings for secure streaming.


Accessing Emby

After installation, access Emby at:

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

Or via direct port access:

http://your-server-ip:8000
QuickBox Dashboard Integration
Tip

Emby is automatically integrated into your QuickBox dashboard. Find it on the App Dashboard (the default control view), expand its row for port and status, and click Open to launch the web interface.

First-Time Setup:

  1. Create your admin account (no Emby.media account required initially)
  2. Set up your media libraries (Movies, TV Shows, Music)
  3. Configure metadata providers and language preferences
  4. (Optional) Sign in with Emby Connect for remote access

Initial Configuration

1. Create Admin Account

On first access, create your local admin account:

  1. Enter username (no email initially required)
  2. Set password for admin account
  3. Click Next to continue setup wizard
  4. (Optional) Sign in with Emby Connect later for remote features

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
    • TV 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 Hardware Transcoding

Enable GPU acceleration for transcoding:

  1. Go to Settings → Transcoding
  2. Configure hardware acceleration:
    • Hardware acceleration: Select your GPU type (Intel QuickSync, NVIDIA NVENC, AMD AMF)
    • Enable hardware encoding: Toggle on
    • Enable hardware decoding: Toggle on
  3. Set transcoding quality preferences:
    • Max simultaneous video streams: Number of concurrent transcodes
    • Hardware transcoding threads: CPU core count
  4. Save settings

Service Management

Emby runs as a per-user systemd service.

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

Back up and restore

QuickBox backs Emby up for you from the dashboard or the CLI, and Emby keeps running while it does. Every backup is saved to /home/username/.QuickBox/software/emby/backup/, named with the version and the date.

BackupWhat it saves
Config Onlysystem.xml, Emby’s main configuration file. Your users, libraries and databases live in the config and data folders, so use Full Backup for them
Full BackupTwo archives: emby-<version>-config_<date>.tar.gz holds the config, data and plugins folders of /home/username/.config/Emby/ (your settings, users, library databases and plugins, with each database taken as a consistent copy), and emby-<version>-application_<date>.tar.gz holds the install tree /opt/username/emby-server/. The metadata folder, caches, transcoding temp files, logs and Emby’s own dated backup folders are left out
Nginx OnlyEmby’s nginx config, username.emby.conf

From the dashboard: open the App Dashboard, stay on Application Control, expand the Emby row (click the row, or the arrow beside the app name, to open its options), open Operations and click Backup, then choose Full backup, Config Only or Nginx Only. You can also open Content → Asset Management Center (AMC in the sidebar), choose the Application Backups tab, expand the Emby row and click Back up now; that row lists every saved file with download and delete buttons. See App Management → Application Backups for who can see the tab.

To roll back from the dashboard: open the App Dashboard, stay on Application Control, expand the Emby row, open Operations, click Restore, pick the backup, then click Rollback and confirm. Restore appears only when your account is allowed to restore backups. A Config Only or Nginx Only backup shows Restore instead of Rollback and puts back just that file.

From the CLI:

bash
# Config Only: system.xml
qb manage software -o backup -u username -s emby
 
# Full Backup: config, data and plugins folders, plus the install tree
qb manage software -o backup -o app -u username -s emby
 
# Roll back to a Full Backup: pick the version from a menu, then confirm
qb manage software -o rollback -o app -u username -s emby

Every option is described in the qb manage reference.

A rollback stops Emby, puts the install tree and the config folder back from the two archives, and starts Emby again. If Emby was running before the rollback, the command also waits for it to answer on its port, and reports an error if it does not come back.

Remove and reinstall delete your backups
Caution

qb remove emby and qb reinstall emby both delete /home/username/.config/Emby/ (your databases and settings) and the backup folder /home/username/.QuickBox/software/emby/ with every backup in it, and clear the rollback list. Before either one, download the Full Backup from the Application Backups tab of the Asset Management Center.


Troubleshooting

Emby Won’t Start

bash
journalctl -u emby-server@username -f

Check data directory permissions:

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

Can’t Access Web Interface

Symptoms

  • Cannot access Emby web interface
  • 404 Not Found or connection refused
  • HTTPS errors or certificate warnings
  • Reverse proxy not working

Resolution

  • Verify service is running: systemctl status emby-server@username
  • Check ports are configured: grep 8000 ~/.config/Emby/config/system.xml
  • Test direct port access: curl http://localhost:8000
  • Verify nginx proxy: sudo nginx -t && sudo systemctl reload nginx
  • Check SSL certificate: ls -la ~/.ssl/embylocal.pfx

Hardware Transcoding Not Working

Hardware transcoding requires compatible GPU and drivers:

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

Library Not Scanning

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

Live TV / DVR Issues

bash
# Verify tuner device permissions
ls -la /dev/dvb
sudo usermod -a -G video emby
sudo systemctl restart emby-server@username
 
# Check EPG data source configuration
# Settings → Live TV → TV Guide Data Provider
 
# Verify recording path permissions
sudo chown -R username:username /home/username/recordings

Configuration Reset

Take a Full Backup first, as described in Back up and restore. The reset below removes system.xml, which the Full Backup holds, so you can undo it by rolling back.

bash
qb manage software -o backup -o app -u username -s emby
 
# Stop service
systemctl stop emby-server@username
 
# Reset configuration (keeps libraries and database)
rm ~/.config/Emby/config/system.xml
 
# Restart service (will regenerate config file)
systemctl start emby-server@username

Best Practices

Do

  • Organize media in separate folders (Movies, TV, Music) with proper naming
  • Use hardware transcoding if you have compatible GPU for better performance
  • Enable automatic library updates for new content detection
  • Configure proper metadata providers for your region and language
  • Set up Emby Connect for remote access and mobile apps
  • Regularly update Emby via qb update emby for fixes and features
  • Use beta branch if you want early features and can tolerate bugs
  • Take a Full Backup before major updates, and download a copy from the Application Backups tab of the Asset Management Center

Don't

  • Don't delete the ~/.config/Emby directory—contains all metadata and settings
  • Don't manually edit system.xml while Emby is running
  • Don't use special characters in filenames that confuse metadata scrapers
  • Don't share admin credentials—create separate user accounts
  • Don't install multiple Emby instances per user—use one with multiple libraries
  • Don't ignore library scan errors—check logs and fix file permissions
  • Don't mix stable and beta installations on the same server
  • Don't store media on the same partition as OS without sufficient space

Monitoring & Statistics

1

Live TV & IPTV

1

Media Requests

1

Live TV, tuners, and HDHomeRun

Live TV setup is application-level, not a QuickBox issue
Info

Tuner discovery, HDHomeRun device pairing, EPG configuration, and IPTV / M3U setup are all configured inside Emby itself, not by QuickBox Pro. If a tuner does not appear, an EPG fails to populate, or an HDHomeRun device is unreachable, the issue is with Emby’s Live TV configuration or your network — not the QuickBox install.

Use the resources below for tuner, EPG, and Live TV troubleshooting. The QuickBox team can help with installation, ports, SSL, and service management — but Live TV configuration is owned by the Emby community.


Additional Resources


Join the Community

Media server operators sharing configs, getting support, and shaping the future of QuickBox Pro.

  • Dedicated Support
  • Feature Previews
  • Community Configs
  • Active Discussions
Join Discord Server
Last updated on