Plex
Industry-leading media server for every platform
Plex is a client-server media player system that allows you to stream your media content to any Plex-enabled device. With apps for every major platform—smart TVs, mobile devices, streaming boxes, and web browsers—Plex provides a beautiful, intuitive interface for accessing your personal media library from anywhere. QuickBox Pro installs Plex from the official Plex repository with per-user data directories, hardware acceleration support, and optional automatic server claiming.
📱 Universal Apps
Native apps for iOS, Android, smart TVs, streaming devices, and web browsers
🎬 Rich Metadata
Automatic artwork, descriptions, cast info, and ratings for all your media
⚡ Hardware Transcoding
GPU-accelerated transcoding for smooth playback on any device (Plex Pass)
🌐 Remote Access
Stream from anywhere with automatic port forwarding and relay fallback
👥 Multi-User Managed
Separate accounts with parental controls and viewing restrictions per user
📡 Live TV & DVR
Watch and record over-the-air TV with digital tuner support (Plex Pass)
Plex Pass Premium Features
Plex offers Plex Pass subscriptions with premium features including hardware transcoding, offline sync, DVR, and more. QuickBox Pro installs the free version—Plex Pass can be purchased separately from plex.tv.
Installation
Prerequisites
- QuickBox Pro v3 installed and configured
- User account created on the server
- Organized media library (movies, TV shows, music)
- Sufficient disk space for media storage
What You Get
- Use QuickBox's
qbcommand for installation - Optional Plex Claim Token for automatic server setup
- Per-user data directory configuration
- Latest stable version from official Plex repository
Basic Installation
Install Plex for a specific user:
qb install plex -u usernameInstallation with Plex Claim Token
For automatic server claiming (recommended for easy setup):
- Get your Plex Claim Token from https://www.plex.tv/claim/
- Install with the token (valid for 4 minutes):
qb install plex -u username -pct 'claim-xxxxxxxxxxxxxxxxxxxx'Installation Commands
qb install plex -u usernameqb install plex -u username -pct 'token'qb reinstall plex -u usernameqb update plex -u usernameqb update plex -u username -pct 'token'qb remove plex -u usernameqb help plex-u, --usernameRequiredUsername for Plex installation (required)
-pctPlex Claim Token for automatic server claiming (optional, valid 4 minutes)
-DCustom data directory path (default: /home/username/.config/Plex Media Server)
-d, --domainDomain name for reverse proxy with automatic SSL (optional)
System-Wide Service
Plex runs as a system-wide service (plexmediaserver) with per-user data directories at /home/username/.config/Plex Media Server. All users share the same Plex installation but have isolated libraries.
Port Configuration
Plex uses standard port 32400 for all users. Unlike other QuickBox applications, this port is not auto-incremented per user. Access your server at http://your-ip:32400/web.
Directory Structure
Configuration Details
System-wide installation:
- Service:
plexmediaserver.service - Default port:
32400(shared across all users) - SSL port:
32443(when configured with -d domain)
Per-user data directories:
- Config directory:
/home/username/.config/Plex Media Server/- Database:
/home/username/.config/Plex Media Server/Plug-in Support/Databases/com.plexapp.plugins.library.db- Logs:
/home/username/.config/Plex Media Server/Logs/- Preferences:
/home/username/.config/Plex Media Server/Preferences.xmlCustom data directory (with -D flag):
- QuickBox creates a symbolic link from
/home/username/.config/Plex Media Serverto your custom path - Permissions are automatically configured for the
plexuser
Accessing Plex
After installation, Plex is accessible through multiple methods:
http://your-server-ip:32400/webhttps://plex.yourdomain.comQuickBox Dashboard Integration
Plex is automatically integrated into your QuickBox dashboard. Find it in the Service Control panel with port and status information. Click the LAUNCH icon to open the web interface.
First-Time Setup:
- Sign in with your Plex account (or create one at plex.tv)
- If you didn’t use a claim token during install, manually claim your server
- Set up your media libraries (Movies, TV Shows, Music, Photos)
- Configure remote access settings
Permissions & Group Membership
Automatic Configuration by QuickBox
During installation, QuickBox automatically configures all necessary permissions for seamless Plex operation:
- Adds your user to the
plexgroup for media file access - Adds your user to
renderandvideogroups for hardware transcoding support - Configures bidirectional access between
plex,www-data, and your user account - Sets proper ownership on configuration and data directories
You don’t need to manually configure these permissions unless troubleshooting or managing additional users.
How QuickBox Configures Permissions
QuickBox automatically executes these group assignments during install/reinstall/update:
# Allow plex to access user media files
usermod -a -G username plex
# Allow user to manage plex configuration
usermod -a -G plex username
# Enable hardware transcoding (GPU access)
usermod -a -G render username
usermod -a -G video username
# Enable web access through nginx
usermod -a -G www-data plex
usermod -a -G plex www-dataManual Group Management (Troubleshooting Only)
If you need to manually verify or fix group membership:
# Add user to plex group
sudo usermod -aG plex username # see above for other groups
# Verify group membership
groups usernameSession Reload Required
After adding a user to the plex group, the user must log out and log back in (or start a new shell session) for the group membership to take effect.
File Permission Issues
Symptoms
- Plex cannot access media files in
/home/username/Media/ - Permission denied errors in Plex logs
- Libraries show empty or missing content
- Plex scanner fails to add new media
Resolution
- Add your username to the
plexgroup:sudo usermod -aG plex username - Ensure media directories have group read permissions:
chmod -R g+rX ~/Media - Set proper ownership:
chown -R username:plex ~/Media - Restart Plex service:
sudo systemctl restart plexmediaserver - Verify permissions:
ls -la ~/Media(should showusername:plex)
Initial Configuration
1. Claim Your Server
If you didn’t use a Plex Claim Token during installation:
- Open Plex web interface at
http://your-ip:32400/web - Sign in with your Plex account
- Click “Claim Server” in the top banner
- Your server will be linked to your account
2. Add Media Libraries
Set up libraries for your media:
- Click “Add Library” in the sidebar
- Select library type:
- Movies - Feature films and home videos
- TV Shows - Television series and episodes
- Music - Audio files and albums
- Photos - Photo collections
- Add folder paths:
/home/username/media/movies/home/username/media/tv/home/username/media/music- Or custom paths you’ve configured
- Configure advanced settings:
- Scanner: Plex Movie/TV Show Scanner (recommended)
- Agent: Plex Movie/TV Series (for metadata)
- Language: Preferred language for metadata
- Click “Add Library”
3. Configure Remote Access
Enable streaming from anywhere:
- Go to Settings → Remote Access
- Click “Enable Remote Access”
- Plex will attempt automatic port forwarding via UPnP
- If UPnP fails, manually forward port 32400 on your router
- Verify remote access shows “Fully accessible outside your network”
Service Management
Plex runs as a system-wide systemd service.
systemctl status plexmediaserver # Check status
systemctl restart plexmediaserver # Restart service
journalctl -u plexmediaserver -f # View live logs
systemctl enable plexmediaserver # Start on boot (already enabled)
systemctl disable plexmediaserver # Prevent auto-startTroubleshooting
Plex Won’t Start
journalctl -u plexmediaserver -fCheck data directory permissions:
ls -la /home/username/.config/Plex\ Media\ Server
# Should be owned by plex:plex
sudo chown -R plex:plex /home/username/.config/Plex\ Media\ ServerSee Permissions & Group Membership section for details about user groups and additional permissions.
Can’t Claim Server
Symptoms
- Server not showing in your Plex account
- Claim token expired error
- Server already claimed by another account
- Cannot access server from plex.tv
Resolution
- Get a fresh claim token from https://www.plex.tv/claim/ (valid 4 minutes)
- Reinstall with claim token:
qb reinstall plex -u username -pct 'token' - Manually claim via Settings → General → Claim Server
- Check firewall allows port
32400 - Verify server is running: systemctl status plexmediaserver
Remote Access Not Working
# Check if port 32400 is open
sudo netstat -tlnp | grep 32400
# Verify nginx reverse proxy (if using custom domain)
sudo nginx -t
sudo systemctl reload nginx
# Test external access
curl http://your-public-ip:32400/webHardware Transcoding Not Available
Hardware transcoding requires Plex Pass and compatible GPU:
# Check GPU availability (Intel Quick Sync, NVIDIA, AMD)
lspci | grep -i vga
# Verify user is in render and video groups
groups username
# Should show: render video plex
# Add groups if missing
sudo usermod -a -G render username
sudo usermod -a -G video username
sudo systemctl restart plexmediaserverLibrary Not Scanning
# Manual library scan via Plex web interface
# Settings → Library → Scan Library Files
# Check file permissions
sudo chown -R username:username /home/username/media
# Verify Plex can access media directory
sudo -u plex ls -la /home/username/mediaConfiguration Reset
# Backup current configuration
cp -r /home/username/.config/Plex\ Media\ Server /home/username/.config/Plex\ Media\ Server.backup
# Stop service
sudo systemctl stop plexmediaserver
# Reset preferences (keeps libraries and metadata)
rm /home/username/.config/Plex\ Media\ Server/Preferences.xml
# Restart service
sudo systemctl start plexmediaserverBest Practices
Do
- Organize media in separate folders (Movies, TV, Music) for best results
- Use proper naming conventions: 'Movie Name (Year).ext' for movies, 'Show Name - S01E01.ext' for TV
- Enable automatic library updates for new content detection
- Configure hardware transcoding if you have Plex Pass and compatible GPU
- Set up remote access for streaming outside your network
- Use Plex agents for automatic metadata and artwork fetching
- Create managed users for family members with parental controls
- Regularly update Plex via qb update plex for latest features and fixes
Don't
- Don't run multiple Plex servers on the same machine—use one server with multiple libraries
- Don't store media on the same drive as the OS without sufficient space
- Don't use special characters or odd naming that confuses the scanner
- Don't manually edit Preferences.xml while Plex is running
- Don't share your Plex account credentials—use managed users instead
- Don't delete the Plex data directory—contains all metadata and settings
- Don't expect hardware transcoding without Plex Pass subscription
- Don't ignore library scan errors—check logs and fix file permissions
Use Cases
Personal Media Server
- Stream your personal movie, TV, music, and photo library to any device
- Beautiful interface with automatic artwork and metadata
- Universal apps for all platforms (iOS, Android, smart TVs, Roku, Apple TV, etc.)
Multi-User Family Server
- Create managed accounts for family members with parental controls
- Separate watch history and recommendations per user
- Share libraries while controlling access to specific content
Remote Streaming
- Access your media from anywhere with remote access
- Automatic transcoding for smooth playback on any device
- Relay fallback when direct connection isn’t possible
Related Applications
Additional Resources
Join the Community
Media server operators sharing configs, getting support, and shaping the future of QuickBox Pro.