emby-watchparty

emby-watchparty

Docker app from Mahesvara's Toolshed

Overview

A synchronized watch party application for Emby media servers. Watch videos together with friends in real-time, no matter where you are! All media streaming is proxied through the Flask app, keeping your Emby server safely on your internal network.

Requirements

A running Emby server reachable from this container, plus an Emby API key and the username/password of an Emby user with library access. Emby Premiere is required on the Emby side for hardware-accelerated transcoding (QSV, NVENC, VAAPI).

Runtime arguments

Web UI
http://[IP]:[PORT:5000]
Network
bridge
Shell
sh
Privileged
false

Template configuration

Web UI PortPorttcp

Port for the emby-watchparty web interface.

Target
5000
Default
5000
Value
5000
Emby Server URLVariable

Full URL to your Emby server, e.g. http://192.168.1.100:8096

Target
EMBY_SERVER_URL
Default
http://192.168.1.x:8096
Value
http://192.168.1.x:8096
Emby API KeyVariable

Your Emby API key. Generate one in Emby Dashboard > Advanced > API Keys.

Target
EMBY_API_KEY
Emby UsernameVariable

Emby username used to authenticate and proxy HLS streams.

Target
EMBY_USERNAME
Emby PasswordVariable

Password for the Emby user above.

Target
EMBY_PASSWORD
App PrefixVariable

URL prefix for reverse proxy deployments (e.g. /watchparty). Leave empty for root deployment.

Target
APP_PREFIX
Require LoginVariable

Require Emby login to access the web UI (true/false). Leave false for open guest access.

Target
REQUIRE_LOGIN
Default
false
Value
false
Session Expiry (seconds)Variable

Session expiry in seconds. Default 86400 (24 hours).

Target
SESSION_EXPIRY
Default
86400
Value
86400
Static Session EnabledVariable

Keep a single persistent party alive across restarts (true/false). Users navigating to / are redirected straight into the party.

Target
STATIC_SESSION_ENABLED
Default
false
Value
false
Static Session IDVariable

Fixed party ID used when Static Session Enabled is true. Uppercase.

Target
STATIC_SESSION_ID
Default
PARTY
Value
PARTY
Log LevelVariable

Logging level: DEBUG, INFO, WARNING, or ERROR.

Target
LOG_LEVEL
Default
INFO
Value
INFO
Console Log LevelVariable

Log level for stdout/console output. Default WARNING keeps Docker logs quiet.

Target
CONSOLE_LOG_LEVEL
Default
WARNING
Value
WARNING
Log To FileVariable

Set to false (recommended for Docker) to output logs to stdout only. Set to true to write logs to a file inside the container.

Target
LOG_TO_FILE
Default
false
Value
false
Log File PathVariable

Path to the log file inside the container. Only used when Log To File is true.

Target
LOG_FILE
Default
logs/emby-watchparty.log
Value
logs/emby-watchparty.log
Log Max Size (MB)Variable

Maximum size of the log file in megabytes before rotation.

Target
LOG_MAX_SIZE
Default
10
Value
10
Max Users Per PartyVariable

Maximum users per watch party. 0 means unlimited.

Target
MAX_USERS_PER_PARTY
Default
0
Value
0
Enable HLS Token ValidationVariable

Validate HLS stream tokens so only party members can fetch segments (true/false).

Target
ENABLE_HLS_TOKEN_VALIDATION
Default
true
Value
true
HLS Token Expiry (seconds)Variable

How long HLS tokens remain valid, in seconds. Default 86400 (24 hours).

Target
HLS_TOKEN_EXPIRY
Default
86400
Value
86400
Enable Rate LimitingVariable

Enable per-IP rate limiting on API endpoints (true/false).

Target
ENABLE_RATE_LIMITING
Default
true
Value
true
Rate Limit: Party Creations Per HourVariable

Maximum party creations per IP per hour.

Target
RATE_LIMIT_PARTY_CREATION
Default
5
Value
5
Rate Limit: API Calls Per MinuteVariable

Maximum API calls per IP per minute.

Target
RATE_LIMIT_API_CALLS
Default
1000
Value
1000
ENV File Path (optional)Pathro

Optional: mount a .env file into the container. If set, values in this file will be used. Individual env vars above take precedence.

Target
/app/.env
Default
/mnt/user/appdata/emby-watchparty/.env
Value
/mnt/user/appdata/emby-watchparty/.env
App Config DirectoryPathrw

Path on the host where emby-watchparty will store any persistent config or state.

Target
/app/config
Default
/mnt/user/appdata/emby-watchparty
Value
/mnt/user/appdata/emby-watchparty

Details

Repository
ghcr.io/oratorian/emby-watchparty:latest
Last Updated2026-05-31
First Seen2026-05-04

Run emby-watchparty on Unraid.

emby-watchparty is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.