MediaCP Manual
    1. Getting Started
    2. Sales Questions
    3. Frequently Asked Questions
    4. Transcoder System Benchmarks
    5. Start your own streaming platform
    1. Change account currency
    2. Product Licensing
    1. Introduction
    2. Installation & Upgrade
      1. System Requirements
      2. Versions & Releases
      3. Installation
      4. Upgrading
      5. Streaming Servers
        1. Nginx-Rtmp Video Server
        2. Flussonic Media Server
        3. Icecast 2 / Icecast KH
        4. Video Feature Comparison
        5. Wowza Streaming Engine
      6. SSL Certificates
    3. Billing Integration
      1. WHMCS Integration Guide
      2. Clientexec Integration Guide
      3. Blesta Integration Guide
    4. Migrate from other software
      1. Migrate from Centovacast
    5. Backup & Restoration
      1. Backup MediaCP
      2. Restore MediaCP
      3. Transfer to another server
    6. Administration
      1. Custom Web Service Configurations
      2. Reset Admin Password
      3. Port 80 / 443 Proxy
      4. MediaCP System Commands
      5. Change MediaCP domain name
      6. Move media to another hard disk
      7. Secure your server
      8. Troubleshooting Login Errors
      9. Custom Facebook App
    7. Scaling
      1. Scale with Wowza and CloudFront CDN
      2. Nginx-Rtmp with CloudFront CDN
    8. Troubleshooting
      1. Grant access to support team
      2. Troubleshooting Wowza Streaming Engine
      3. FTP Troubleshooting
      4. MySQL Database Troubleshooting
      5. Reporting Troubleshooting
      6. Troubleshooting Liquidsoap AutoDJ
      7. Video Relay Troubleshooting
    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. Reseller Plans
      2. Create a Reseller Account
    6. Media Services
      1. Creating a Media Service
      2. Deleting a Media Service
    7. Announcements
      1. Managing Announcements
      2. Creating Announcement
      3. Deleting Announcement
    8. Statistics
    9. Software Health
    10. Software Updates
    11. Email Templates
    12. API
    1. API Documentation
    2. Custom Domain Names
    3. Shoutcast 2 Admin Guide
    4. Wowza and Flussonic on same system
    5. Submit a feature request
    6. Wowza Custom Properties
    1. Shoutcast 2 Live Broadcasting
    2. DJ Priorities
    3. HTML5 Audio Player
    4. Broadcasting with AutoDJ
    5. Shoutcast 2 Premium
    6. Mount Points
    1. Getting started with video streaming
    2. Live Streaming Overview
    3. TV Station Overview
    4. Ondemand Video Streaming
    5. Relay & IP Camera
    6. Connecting your encoder
    7. Managing your media files
    8. Embedding player on your website
    9. Video Transcoding (Adaptive Bitrate Streaming)
    10. Image Logo or Watermark Overlay on Video Stream
    11. nDVR Live Streaming
    12. Shoutcast 2 Stream Publishing
    13. Facebook Live Streaming
    14. Youtube Stream Publishing
    15. Icecast Stream Publishing
    16. Twitch Stream Publishing
    17. Periscope Stream Publishing
WHMCS Integration Guide

Last updated 7 months ago


Integration with WHMCS enables you to setup service plans to sell audio and video streaming services with automatic setup and provisioning of customer and streaming accounts.

Module Release Notes

Changelog is available at GitHub.

WHMCS Module

Install latest module

1. Make sure you have the latest version of MediaCP

2. Download the latest version of the MediaCP module for WHMCS

3. Extract the .zip file to your desktop

4. Connect to your WHMCS server via FTP and navigate to [WHMCS]/modules/servers

5. Drag and drop the mediacp folder from your desktop to your FTP client in order to upload the files.

6. You should now see the mediacp folder inside of your [WHMCS]/modules/servers path on the ftp server

Adding a server in WHMCS

  1. Login to WHMCS as an administrator and navigate to System Settings.
  2. Select Products & Services from the left menu then select Servers option.
  3. Select the + Add New Server button from the top of the page and fill out the form.
  4. Select Go to Advanced Mode
  5. Fill out the form according to the details below:
    • Name – Enter a label for this server.
    • Hostname – Enter the primary domain or subdomain name that MediaCP is installed on such as
    • IP Address – enter the IP address of the MediaCP server, this will be used by WHMCS to validate access to the ports.
    • Server Status Address – This is used to provide network status and load to WHMCS. MediaCP provides a special URL for you to paste into the WHMCS Server configuration. To display Online status in WHMCS you should first ensure that MediaCP Port 80 is enabled.

      The format of the WHMCS Status Address is described below, replacing with the MediaCP hostname and port and {api-key} with your MediaCP API Key.{api-key}/

    • Module – Media Control Panel
    • Username – Administrator username, defaults to “admin”
    • Password – This field is not used.
    • Access Hash – Provide the MediaCP API Key into this field.
    • Secure – Check this box if HTTPS/SSL is configured with MediaCP (default ON).
    • Port – The primary port that MediaCP software uses. Default is 2020. Change only if you have configured an alternate port for MediaCP Web.
    • Name Servers – this information is not required by the MediaCP module.
  6. Press on the Save Changes button to finish.

Creating your first product

You are now ready to create and configure your first product for the MediaCP.

1. Navigate to Setup -> Products/Services. Then, click Create a new Product.

2. Select Shared Hosting Account and select a suitable product group and name and click Continue.


3. Select Module Settings tab and fill out base settings as preferred.


4. Press Save Changes


Configurable Options

You can let your customers build their own packages by setting Configurable Options.

  1. Navigate to Setup->Products/Services -> Configurable Options.
  2. Press Create a New Group
  3. Configure the Group Name and Assigned Products then press Add New Configurable Option.
  4. Refer to the table below to build your package options. It is important that the options are labelled correctly, you can choose to use either the Configurable Option or Alternatives for the Option names.
 Configurable OptionAlternativesOptionsDescription
 Media ServiceShoutcast
Shoutcast 2
Shoutcast 198
Icecast 2
Icecast 2 KH
Icecast KH
Wowza Streaming Engine
Flash Media Service
Windows Media Services
 SourceAutoDJShoutcast Transcoder V1
Shoutcast Transcoder V2
Ices 0.4 (MP3)
Ices 2.0 (OGG)
Stream Transcoder V3
Alternatively, you can set this value to “Yes” and the module will automatically configure Shoutcast Transcoder V2.
Mountpoints Numerical ValueNumber of mountpoints that the Shoutcast or Icecast service will include.
Should be an integer.
AutoDJ Sources Numerical ValueNumber of AutoDJ sources that can be applied to mountpoints on Shoutcast and Icecast services.
Should be an integer.
Stream ProxyStream ProxyYes
Enable or disable the HTTP/HTTPS stream proxy on the account
Geo LockingGeolock
Country Locking
Allow or disallow geo country locking support on service
Source ReencodeAutoDJ ReencodeYes
Maximum Users
Maximum Listeners
Maximum Viewers
Numerical ValueEnter a value between 0 and 9999.
 BitrateMaximum Bitrate24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 400, 480, 560, 640, 720, 800, 920, 1024, 1280, 1536, 1792, 2048, 2560, 3072, 3584, 4096, 99999Enter only one of the values in the options column. This may also contain “Kbps” at the end of the option value.
 Disk UsageDisk
Disk Quota
MB, GB or TBSpecify a value including MB, GB or TB. For example: 100MB
 Data TransferTransfer
MB, GB or TBSpecify a value including MB, GB or TB. For example: 100MB
 Historical ReportingReporting
Advanced Reporting
Yes / NoEnabled or Disable Historical Reporting capabilities. Standard Usage tab will be displayed in either case.
Stream AuthenticationStream Authentication
Listener Authentication
Stream Auth
Yes / NoIcecast & Icecast KH services ONLY
Enables or disables listener stream authentication feature..

Stream Publishing Options (Wowza & Flussonic) 

 Configurable OptionAlternativesOptionsDescription 
Stream PublishingStream TargetsYes / No Enables all stream targets
Facebook Publishing Yes / No 
Youtube Publishing Yes / No 
Periscope Publishing Yes / No 
Twitch Publishing Yes / No 
Shoutcast Publishing Yes / No 
Icecast Publishing Yes / No 
RTMP Publishing Yes / No 

Wowza Streaming Engine

 Configurable OptionAlternativesOptionsDescription
Wowza Media TypeService Type
Flash Media Service
Live Streaming
Live Streaming Low Latency
TV Station
Ondemand Streaming
Shoutcast/Icecast Relay
Live Camera Restream
 Live AuthenticationYes
Wowza Streaming Engine ONLY.
nDVR Playback
Wowza Streaming Engine ONLY.
Transcoder ProfilesTranscoder Profiles160p
Comma delimited list of transcoder profiles.
Available with MediaCP 2.6+
For example:
Stream RecordingLive Stream RecordingYes
Wowza Streaming Engine ONLY.
RTMP Service
Enable RTMP/RTSP links for Shoutcast & Icecast Services ONLY.

Flussonic Media Server

 Configurable OptionAlternativesOptionsDescription 
 Service TypeService TypeLive Streaming
TV Station
Ondemand Streaming
Transcoder ProfilesTranscoder Profiles160p

Comma delimited list of transcoder profiles.

Available with MediaCP 2.6+

For example:

 nDVR AddOnnDVRYes  / No 

Custom Fields

Custom Fields allow customers to enter specific text values for some configurations.

Field NameField TypeValidationDescription
Publish NameText Box/^[a-zd_]{4,28}$/iAvailable for all Media Service Types.
Customer can specify desired Publish Name. If not available, the name will automatically be updated.
Check the Required Field and Show on Order Form.
Customer can specify their Shoutcast Restream URL or IPCAM Restream URL.
Alternate field names can be:
Icecast URL
Restream Address
IPCAM Address
Admin Only.
Required Field.

Allow customer to specify publish name

You can allow you customer to specify their preferred Publish Name by following these steps.

  1. Navigate to Setup->Products/Services. Then select an existing MediaCP product.
  2. Select the Custom Fields tab and Add New Custom Field with the following settings.
    • Field Name -> Publish Name
    • Field Type -> Text Box
    • Validation: /^[a-zd_]{4,28}$/i
    • Check Required Field
    • Check Show on Order Form


Email Templates

Audio Streaming (Shoutcast / Icecast)

You can use the following email templates for various services.



Dear {$client_name},

Thank you for your order from us!

Your Shoutcast service has now been created and this email contains all the information you will need in order to begin using your services.

Hosting Control Panel
Address: https://{$service_server_hostname}:2020/
Username: {$service_username}
Password: {$service_password}

Media Service Information
Service Address: {$mediacp_host_address}
Service Port: {$mediacp_portbase}
Streaming Username: dj
Streaming Password: {$service_password}

Admin Address: http://{$service_domain}/admin
Username: admin
Password: {$service_password}

{foreach from=$service_config_options item=data}{$data.option}: {$data.value}

How to stream to your new service
1. Download and install Winamp from
2. Download and install Winamp Shoutcast DSP Plugin from
3. Enter your Service IP, Port & Password into the Shoutcast DSP Plugin then press connect.

Thank you for choosing us.


Video Streaming

Please note, this template assumes you have configured the “Publish Name” custom field as the first custom field.


Dear {$client_name},

Thank you for your order from us!

Your media service has now been created and this email contains all the information you will need in order to begin using your services.

Hosting Control Panel
Address: https://{$service_server_hostname}:2020/
Username: {$service_username}
Password: {$service_password}

Media Service Information
RTMP: rtmp://{$service_server_hostname}/{$service_custom_fields.0}/{$service_custom_fields.0}
RTSP: rtsp://{$service_server_hostname}/{$service_custom_fields.0}/{$service_custom_fields.0}

{foreach from=$service_config_options item=data}{$data.option}: {$data.value}

Live Encoder Configuration
Server URL: rtmp://{$service_server_hostname}/{$service_custom_fields.0}
Stream Key: {$service_custom_fields.0}
Username: {$service_custom_fields.0}
Password: {$service_password}

Thank you for choosing us.



Request failed – Ensure firewall outgoing port is opened and ensure domain can be resolved.

The most common reason for this error is that your WHMCS server is unable to communicate with the MediaCP due to the outgoing port 2020 being blocked from your WHMCS server.

We recommend you follow the below steps:

  1. Check MediaCP is up to date with most recent version to ensure compatibility.
  2. Check the WHMCS server Hostname, Port & SSL Mode exactly matches with your MediaCP installation
  3. Check OUTBOUND firewall port 2020 is on the WHMCS server, or contact your hosting provider to complete this.
  4. Test the MediaCP API connection using our online testing utility. If the API test is successful then the issue is with your WHMCS server firewall. If the API test is not successful, then please contact us with the output information for further troubleshooting.

Transport error – could not open socket

There is a connection problem between your WHMCS server and the MediaCP. Please follow the troubleshooting guide above.

Not supported with your version of MediaCP. Please upgrade MediaCP to version 2.9.11, 2.10.7 or newer.

If you are seeing this error when using the Sync button within WHMCS it means either:

  1. Your MediaCP is not up to date; or
  2. If MediaCP is up to date it could also mean that the outbound port 2000 or 2020 is being blocked by your firewall on the WHMCS server. Make sure this port is opened and try again.

Importing MediaCP accounts into WHMCS

MediaCP 2.9.11 and 2.10.7 introduce the ability to use WHMCS Server Sync tool.

  1. Login to WHMCS and navigate to Servers page
  2. Press the Sync Accounts button
  3. Select the accounts you would like to sync and press Continue
  4. You must now update the “Product/Service” of each newly created service in WHMCS.


  • Accounts are matched by domain and username (email) fields
  • All newly created accounts will be put on a WHMCS package called “default”, after sync you must open the service and switch the Product/Service to a valid package.

Table of Contents