Icecast KHOperations handbook

Independent, unofficial information portal

Search
Subject index

Icecast KH · Operations handbook

Operate KH with a clear signal path

An operating manual for Icecast KH: select mount policies, manage relay origins and trace failures from source to listener. Procedures and references follow one explicitly pinned source snapshot.

Set up the first streamLook up a parameter

From source to listener

Build a small, isolated test first. Then add authentication, delivery rules and monitoring with a known baseline.

  1. 01 / SOURCESourceEncoder supplies encoded media.
  2. 02 / MOUNTIcecast KHThe server selects the mount policy and distributes media.
  3. 03 / PLAYERPlayerThe player requests and decodes the stream.

Version information

This handbook covers the KH source snapshot from 21 November 2023, identified as 2.4.0-kh22. It differs from the release of the same name published on 4 July 2023.

Identify the KH code you actually run

Selected reading

Choose a task, then follow its prerequisites, configuration and verification steps. Every article has a complete counterpart in the other language.

  1. 01

    Configure mountpoints in Icecast KH

    Define source credentials and listener policy for one KH mount, understand which requests the block matches and verify changes before adding patterns.

    Guides
  2. 02

    Resolve KH mount patterns and priorities

    Read exact and wildcard KH mount selection, assign explicit priorities and test overlapping names so a broad rule cannot silently change stream policy.

    Reference
  3. 03

    Order several origins inside one KH relay

    Configure KH relay host priorities, distinguish origin switching from listener fallback and test failure, recovery and format compatibility.

    Guides
  4. 04

    Control source takeover on a KH relay mount

    Understand KH hijack and linger settings, keep listeners on one mount during planned source takeover and verify recovery without promising seamless audio.

    Guides
  5. 05

    Set up URL authentication in Icecast KH

    Read KH listener and source callback options, result headers and forwarded fields, correct a documented prefix typo and verify denial on backend failure.

    Reference
  6. 06

    Trace KH failures through paths, logs and requests

    Check KH file roots, aliases, log levels and rotation before correlating source, relay, authentication and playback failures with actual requests.

    Operations

Browse every subject →