MediaCP Manual
    1. Getting Started
    2. Sales Questions
    3. Frequently Asked Questions
    4. Transcoder System Benchmarks
    5. Start your own streaming platform
    1. Product Licensing
    2. Change account currency
    1. Introduction
    2. Installation & Upgrade
      1. System Requirements
      2. Versions & Releases
      3. Installation
      4. Upgrading
      5. SSL Certificates
      6. Streaming Servers
        1. Nginx-Rtmp Video Server
        2. Wowza Streaming Engine
        3. Flussonic Media Server
        4. Video Feature Comparison
        5. Icecast 2 / Icecast KH
        6. Shoutcast 2
    3. Billing Integration
      1. Clientexec Integration Guide
      2. Blesta Integration Guide
      3. WiseCP Integration Guide
      4. WHMCS Integration Guide
      5. Billing Platform Comparision
    4. Migrate from other software
      1. Migrate From AzuraCast
      2. Migrate From Centovacast
    5. Backup & Restoration
      1. Backup MediaCP
      2. Restore MediaCP
      3. Transfer to another server
    6. Administration
      1. MediaCP System Commands
      2. Admin Tools
      3. Custom Web Service Configurations
      4. Change MediaCP domain name
      5. Port 80 / 443 Proxy
      6. Move media to another hard disk
      7. Custom Language Translations
      8. Custom Facebook App
      9. Branding Your Panel
      10. Secure your server
      11. Setup CSF Firewall
      12. Troubleshooting Login Errors
      13. Reset Admin Password
    7. Scaling
      1. Nginx-Rtmp with CloudFront CDN
      2. Nginx-Rtmp with CDN Proxy
      3. Scale with Wowza and CloudFront CDN
    8. Troubleshooting
      1. Troubleshooting Wowza Streaming Engine
      2. FTP Troubleshooting
      3. MySQL Database Troubleshooting
      4. Reporting Troubleshooting
      5. Troubleshooting Liquidsoap AutoDJ
      6. Video Relay Troubleshooting
      7. Disk Troubleshooting
      8. Grant access to support team
    1. Introduction
    2. Administrators Dashboard
    3. System Configuration
      1. General
      2. Services
      3. Video Players
      4. Albums
      5. Email
      6. Plugins
      7. Statistics
      8. Backups
      9. Custom HTML
      10. Misc
    4. Customer Accounts
      1. Managing existing Customers
      2. Create a new Customer
      3. Deleting a Customer
      4. Login as another Customer
      5. Send email to Customer
      6. Reset Customer Password
    5. Reseller Accounts
      1. Create a Reseller Account
      2. Reseller Plans
    6. Administrator Accounts
      1. Create a new Administrator
    7. Media Services
      1. Creating a Media Service
      2. Deleting a Media Service
    8. Announcements
      1. Managing Announcements
      2. Creating Announcement
      3. Deleting Announcement
    9. Statistics
    10. Software Health
    11. Software Updates
    12. Email Templates
    13. API
    1. Introduction
    2. Audio Operation Manual
      1. Basics 101
      2. Station Overview
      3. Media Library
      4. Playlists
        1. General Rotation
        2. Jingles & Advertising
        3. Scheduling
        4. Repeat Protection
      5. Live DJ Connections
      6. Live Stream Recording
      7. DJ Manager
      8. Country Blocking
      9. Fallback, Backup and Intro Files
      10. Public Page
      11. HTML5 Player
      12. Stream Authentication
      13. Stream Proxy
      14. AutoDJ Crossfade
      15. Widgets & Links
      16. Reporting
    3. Video Operation Manual
      1. Basics 101
      2. Service Overview
      3. File Manager
      4. Scheduling
      5. Streaming to Your Service
      6. Stream Targets
      7. GeoIP Country Locking
      8. Public Page
      9. Widgets & Links
      10. Reporting
    4. Reseller Operations Manual
      1. Reseller Dashboard
      2. Customers
      3. Media Services
    5. API
    1. Shoutcast 2 Admin Guide
    2. Wowza and Flussonic on same system
    3. Submit a feature request
    4. Custom Domain Names
    1. Getting started with Audio Streaming
    2. Icecast Live Broadcasting
    3. Shoutcast 2 Live Broadcasting
    4. Broadcasting with AutoDJ
    5. DJ Accounts
    6. GeoIP Country Locking
    7. HTML5 Audio Player
    8. Mount Points
    9. Managing Your Media
    10. Managing Media Using FTP
    11. Statistics
    12. Shoutcast 2 Premium
    1. Getting started with video streaming
    2. Live Streaming Overview
    3. TV Station Overview
    4. Ondemand Video Streaming
    5. GeoIP Country Locking
    6. VAST Advertising
    7. Relay & IP Camera
    8. Stream Recording
    9. Connecting your encoder
    10. Preparing Your Media Files
    11. Managing Media Using FTP
    12. Understanding Video Playlists
    13. Embedding player on your website
    14. Smooth Streaming and Content Transition
    15. Video Transcoding (Adaptive Bitrate Streaming)
    16. Stream Watermark​
    17. DVR Rewind
    18. Statistics
    19. Facebook Live Streaming
    20. Youtube Stream Publishing
    21. Twitch Stream Publishing
    22. Shoutcast 2 Stream Publishing
    23. Icecast Stream Publishing
    24. RTMP Stream Publishing
    1. Cloud Video Overview
    2. Admin Manual - Cloud Video
      1. Dashboard - A First Look
      2. Branding your platform
      3. Team & Staff Members
      4. Plans & Customers
      5. WHMCS Billing Provisioning Module
      6. Login to your cloud platform
      7. Activating VOD on Customer Plan
      8. API
    3. User Manual - Cloud Video
      1. Login to your video platform
      2. First Look
      3. Creating a Channel
      4. Channel Overview
      5. Broadcasting
      6. Recording
      7. Media Content
      8. Live Events
      9. 30 Minute Rewind
      10. Fallback Video
      11. TV Channels - 24x7 UGC
        1. TV Event Scheduling
        2. Channel Guide Widgets
      12. Video on Demand
      13. Relay Channels
      14. VOD Playlists
      15. Publishing
      16. Bandwidth Utilisation
      17. Viewing Analytics
      18. Publish Zoom Meetings
      19. Advertising
      20. Restreaming IP Cameras
    4. Video Guide Series
    5. Streaming Best Practices
    6. Feature Comparison
    7. Roadmap & Release Notes
Icecast 2 / Icecast KH

Last updated 12 hours ago

Custom XML Configuration

As of version 2.12.3 it is possible to apply custom xml configurations to Icecast and Icecast KH stations from the Service Configuration -> Advanced tab. All directives entered here are merged into the icecast configuration file automatically. Please note that invalid configurations may prevent Icecast from starting.

Examples

Max Listener Duration

The example below will set the max-listener-duration on the first mount point. If there are multiple mount points then you can simply duplicate the <mount> directive for each mount point that exists.
<icecast>
  <mount>
    <max-listener-duration>43200</max-listener-duration>
  </mount>
</icecast>

IP Deny

You setup IP deny using Custom XML, after manually creating an ip-deny-list file via SSH.  Icecast documentation does not require any formatting for this file it can simply be a single ip address on each line. You can make this file by for example running the following command then listing each IP address on a new line.
nano /usr/local/mediacp/content/user_xxx/music/ip-deny-list
From there you can set the custom XML configuration in the panel, it should look like the below example. After applying the change and restarting the service the set IP’s should be blocked:
<icecast>
    <paths>
        <deny-ip>/usr/local/mediacp/content/user_xxx/music/ip-deny-list</deny-ip>
    </paths>
</icecast>
 

Troubleshooting

Station stops and requires manual start

If you are seeing your Icecast station turning itself off, the most common cause is bitrate abuse stopping the service. We have a guide for investigating Stations stopping you can review here:

Icecast Troubleshooting – Station stops and requires manual start 

How to enable Icecast debugging logs

Icecast has four levels of logging that can be configured from the station configuration. The following knowledgebase articles goes through the steps to configure this:

Icecast troubleshooting – How to enable Icecast debugging log

Table of Contents