cocainefarm/icecast repository overview

⁠Table of Contents

1. Configuration⁠
   1. General⁠
   2. Authentication⁠
   3. Limits⁠
   4. Network⁠
   5. Logging⁠

A Container for the icecast server.

podman run -it --rm -p 8000:8000 \
    -e ICECAST_SOURCE_PASSWORD="changeme" \
    -e ICECAST_ADMIN_PASSWORD="changeme" \
    kube.cat/cocainefarm/icecast:latest

⁠Configuration

⁠General

These options are only displayed in the admin webpage and not really important.

• ICECAST_LOCATION: The Location of the server (default: Earth)
• ICECAST_ADMIN: An administrative contact (default: [email protected]⁠)

⁠Authentication

• ICECAST_SOURCE_PASSWORD: The unencrypted password used by sources to connect to icecast2. Currently, the username for all source connections must be ‘source’. This is likely to change in the future. (default: )

  The username/password used for all administration functions. This includes retrieving statistics, accessing the web-based administration screens, etc. A list of these functions can be found in the “Administration” section of the manual.

• ICECAST_ADMIN_USER: The username for the admin user (default: admin)

• ICECAST_ADMIN_PASSWORD: The password for the admin user (default: )

⁠Limits

• ICECAST_LIMIT_CLIENTS: Total number of concurrent clients supported by the server. Listeners are considered clients, but so are accesses to any static content (i.e. fileserved content) and also any requests to gather stats. These are max concurrent connections for the entire server (not per mountpoint). (default: 100)
• ICECAST_LIMIT_SOURCES: Maximum number of connected sources supported by the server. (default: 2)
• ICECAST_LIMIT_QUEUE_SIZE: This is the maximum size (in bytes) of a client (listener) queue. A listener may temporarily lag behind due to network congestion and in this case an internal queue is maintained for each listener. If the queue grows larger than this config value, then the listener will be removed from the stream. (default: 524288)
• ICECAST_CLIENT_TIMEOUT: This does not seem to be used. (default: 30)
• ICECAST_HEADER_TIMEOUT: The maximum time (in seconds) to wait for a request to come in once the client has made a connection to the server. In general this value should not need to be tweaked. (default: 15)
• ICECAST_SOURCE_TIMEOUT: If a connected source does not send any data within this timeout period (in seconds), then the source connection will be removed from the server. (default: 10)
• ICECAST_BURST_ON_CONNECT: Send a burst of data to a client on connection. This allows for a faster initialization of the client but may be slower on low bandwidth or high latency connections. (default: 1)
• ICECAST_BURST_SIZE: Same as above but sets the size of the burst in kilobytes (default: 65535)

⁠Network

• ICECAST_HOSTNAME: The hostname of the icecast server. Used to build URLs in the UI and playlists. (default: example.com)
• ICECAST_PORT: The TCP port that will be used to accept client connections. (default: 8000)
• ICECAST_BIND: And option IP address that can be used to bind to a specific network card. If not supplied, then will be used. (default: 0.0.0.0)

⁠Logging

• ICECAST_LOG_LEVEL: Indicates what messages are logged by icecast. Log messages are categorized into one of 4 types, Debug, Info, Warn, and Error.

  The following mapping can be used to set the appropraite value: (default: 2)

  • loglevel = 4: Debug, Info, Warn, Error messages are printed
  • loglevel = 3: Info, Warn, Error messages are printed
  • loglevel = 2: Warn, Error messages are printed
  • loglevel = 1: Error messages only are printed