Medusa Panel › Settings › System Settings
System Settings holds the engine-wide defaults — the choices that apply to the whole panel rather than to one stream. After a fresh install this is the first place to go: open Settings › System Settings and work through every tab before you build anything. Changes apply when you press Save Settings; a few options also need a panel restart, which is noted below.
General
Dashboard defaults, server response timeout and offline behaviour.
- Default Theme — the login page theme:
Light,DarkorAuto(Auto follows the visitor’s local time — light by day, dark by night). - Server Timeout — how long the panel waits for a server to answer before treating it as offline (10–600 s). Example:
600. - Offline Alert —
Enabledshows, in Stream › Manage Streams, how long a stream has been offline. - Offline Video — a clip the engine plays to viewers while a stream is offline (upload or pick one).
Streaming
Stream lifecycle, scheduled operations, playback output, logging, switching and encryption.
- Stream Timeout — seconds (min 30) before a stalled input is treated as dead. Example:
60. - Stream Start / Restart Interval — throttle how many streams start or restart at once (0–60 s) to avoid CPU and network spikes. Example:
0.5. - Stream Log Level —
Info,WarningorErrorfor the per-stream log. - Stream On Demand Inactive Time — seconds (10–600) before an on-demand stream sleeps when nobody is watching. Smaller sleeps sooner. Example:
60. - Priority URL Switch Delay — minutes to delay the priority-URL check, to stop it flapping between sources.
- Automatic Priority URL Switch —
Enabledswitches back to a higher-priority backup URL as soon as it is online again (see IP sources). - Output Encryption Check — periodically checks streams expected to be clear and records unexpected encryption in the System and Stream logs. Enable only for sources that should be decrypted.
- Output Encryption Action — what to do when that check trips:
Restart StreamorStop Stream. - Stream Restart Schedule — weekday/hour/minute schedule to restart streams.
- Stream Switch Schedule — a scheduled forced priority-URL check (runs even if Automatic Priority URL Switch is off).
- RTMP Push IP Allowlist — IPs or CIDR ranges that may push RTMP without a token; leave empty to require token mode (
/stream/<token>). Loopback is always allowed. - HLS Muxer —
Auto/HLS/DASH/Segment(see Packaging and caching). - HLS Segment Number — how segment filenames are numbered:
Random,Epoch Seconds,Epoch MicroSecondsorDateTime. - HLS / DASH Extra Window Size — how many segments stay on disk outside the manifest before removal (HLS and DASH only).
- HTTP Redirection —
Enabledmakes HLS/HTTP-TS output URLs use the master server’s IP/domain for all streams. - ICY Metadata — fetch ICY (SHOUTcast) metadata from the source.
- HTTP SendFile — greatly improves HTTP-TS throughput and cuts CPU, but slow clients may see corruption — test before enabling. Off by default.
Analytics
Which completed playback sessions are kept for analytics.
- Playback History Retention — days (0–7) to keep sessions;
0turns history off. - Maximum Connection History Size — MiB cap (
0= unlimited); old details are pruned after daily/monthly stats are saved. - Minimum Playback Duration — seconds; shorter sessions are not retained.
- Minimum Playback Traffic — bytes; sessions below this delivered-byte threshold are not retained.
Guide & Metadata
The programme guide and the metadata provider.
- EPG Source — an XMLTV guide: a URL or a file path on the server.
- EPG Update Interval — seconds (min 60) between guide refreshes. Example:
3600. - TMDB API Key — a key from
themoviedb.org(its Settings › API page) to auto-fill movie and series details — see YouTube and VOD.
CDN
Distributed delivery and new-session balancing — covered in full in Built-in CDN.
- CDN —
Enabledserves HLS/DASH output on every server. - Live Stream tmpfs Cache — prefer RAM for live CDN objects (falls back to disk when memory is low).
- HLS/DASH Live Prefetch — nodes subscribe to new HLS/DASH (push) instead of pulling only what players request.
- CDN Load Balancing — assign new sessions to healthy, licensed servers (see Load balancing and metrics).
Access & Security
Geolocation, playback client filters and accepted forwarding proxies.
- IP Database — the geolocation provider:
IP2LocationorGeoIP2. - Country Whitelist — if set, only the chosen countries may access streams (GeoIP based).
- HTTP Referer Whitelist — if set, only requests with an allowed
Referercan reach the HLS/DASH/HTTP output. One value per line, exact and case-sensitive, no wildcards. - HTTP User Agent Whitelist — the same, for the
User-Agentheader. - Trusted Proxies — only these IPs/CIDRs may supply
X-Forwarded-*headers; leave empty for direct connections. Takes effect after a restart.
- Email Notifications —
Enabled/Disabled. - SMTP Host / SMTP Port — your relay. Example:
smtp.example.com/587. - SMTP Security —
STARTTLS,TLSorNone(local relay only). - SMTP Username / SMTP Password — the password is encrypted; leave it blank to keep the current one.
- From Name / From Address — what recipients see.
After saving, use Send Test Email — it goes to the current account’s email address.
Database
Query timeout and the automated backup lifecycle.
- MySQL Timeout — seconds (1–600) for connect, read and write. Needs a panel restart.
- Database Backup Schedule — weekday/hour/minute for automatic backups.
- Database Backup Script — a script run after each backup; it receives
$backup_path,$server_name,$datetime,$isotimeand$kept_backups. - Database Max Backups — keep this many unprotected automatic backups (
0= unlimited); manual, installer and protected backups do not count.
# Backup Script example /path/to/script.sh $backup_path $server_name $datetime
Advanced
Audit retention and DRM — see Logs and Output DRM.
- Audit Log Keep Days — how long the panel audit trail is kept (0–90 days;
0disables it). - DRM Provider — the CPIX key service:
EZDRM. - DRM Request URL — the CPIX URL with your credentials.
# EZDRM CPIX endpoint (your own u= / p= credentials) https://cpix.ezdrm.com/KeyServices/Cpix2.aspx?u=USER&p=PASSWORD
Related
- Packaging and caching — the HLS/DASH muxer options in detail.
- Built-in CDN — the CDN tab in detail.
- Output DRM — the Advanced DRM fields.
- Logs — the audit log the Advanced tab retains.