Independent technical reference · Icecast 2.5.0
Understand the server. Keep the stream running
A working library for regular Icecast 2: establish the first stream, read configuration in context and diagnose the delivery path. Current guidance follows 2.5.0; historical behaviour is labelled.
A practical starting point
Build a small, isolated test first. Then add authentication, delivery rules and monitoring with a known baseline.
Selected reading
Subject index
Choose a task, then follow its prerequisites, configuration and verification steps. Every article has a complete counterpart in the other language.
- 01How an Icecast stream reaches its listenersUnderstand source clients, mountpoints and listeners, choose a stream format, and locate faults along the complete Icecast signal path.
- 02Configure mountpoints without losing the signalDefine mount-specific credentials, listener limits and fallbacks, understand default mounts and verify the effective Icecast stream behaviour.
- 03Connect and diagnose a source clientConfigure the encoder side of an Icecast connection, distinguish PUT from legacy SOURCE, and diagnose credentials, media types and disconnects.
- 04Require credentials for listeningAdd mount-specific listener authentication, distinguish it from source access and verify denial, valid users and player behaviour over TLS.
- 05Pull a stream through a relayConfigure a version-correct Icecast relay, distinguish a remote feed from its local mount, and test demand, credentials and upstream failures.
- 06Plan fallback and listener return behaviourBuild a compatible fallback chain, distinguish source loss from a full mount, and verify listener movement and return during a controlled test.
- 07Troubleshoot Icecast with logsFollow Icecast startup, source and listener failures through the relevant logs, enable limited diagnostics and manage rotation without losing evidence.
- 08Configuration reference by operational taskFind Icecast configuration settings by scope, understand their units and version boundaries, and follow the linked guides before changing behaviour.