System Settings Print

  • settings, configuration, smtp, epg, cdn, drm, backup
  • 0

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.

The tabs are General, Streaming, Analytics, Guide & Metadata, CDN, Access & Security, Email, Database and Advanced. Each is a heading below.

General

Dashboard defaults, server response timeout and offline behaviour.

  • Default Theme — the login page theme: Light, Dark or Auto (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 — Enabled shows, 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, Warning or Error for 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 — Enabled switches 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 Stream or Stop 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 MicroSeconds or DateTime.
  • HLS / DASH Extra Window Size — how many segments stay on disk outside the manifest before removal (HLS and DASH only).
  • HTTP Redirection — Enabled makes 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

Playback history and user analytics require a Professional licence.

Which completed playback sessions are kept for analytics.

  • Playback History Retention — days (0–7) to keep sessions; 0 turns 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 — Enabled serves 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: IP2Location or GeoIP2.
  • Country Whitelist — if set, only the chosen countries may access streams (GeoIP based).
  • HTTP Referer Whitelist — if set, only requests with an allowed Referer can 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-Agent header.
  • Trusted Proxies — only these IPs/CIDRs may supply X-Forwarded-* headers; leave empty for direct connections. Takes effect after a restart.

Email

SMTP notifications and scheduled maintenance require a Standard licence or higher. The engine connects to an existing SMTP relay — it does not run a mail server.
  • Email Notifications — Enabled / Disabled.
  • SMTP Host / SMTP Port — your relay. Example: smtp.example.com / 587.
  • SMTP Security — STARTTLS, TLS or None (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, $isotime and $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; 0 disables 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
Save Settings applies the whole page. A few options — MySQL Timeout and Trusted Proxies — take effect only after a panel restart.

Related


Was this answer helpful?

« Back