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. Wowza Streaming Engine
        3. Flussonic Media Server
        4. Video Feature Comparison
        5. Icecast 2 / Icecast KH
      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
      2. Migrate From AzuraCast
    5. Backup & Restoration
      1. Backup MediaCP
      2. Restore MediaCP
      3. Transfer to another server
    6. Administration
      1. Troubleshooting Login Errors
      2. Custom Facebook App
      3. Custom Web Service Configurations
      4. Reset Admin Password
      5. Port 80 / 443 Proxy
      6. MediaCP System Commands
      7. Change MediaCP domain name
      8. Move media to another hard disk
      9. Secure your server
      10. Admin Tools
    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. 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. Stream Proxy
      10. Public Page
      11. HTML5 Player
      12. Stream Authentication
      13. Widgets & Links
      14. Reporting
    3. Video Operation Manual
      1. Basics 101
      2. Service Overview
      3. Scheduling
      4. File Manager
      5. Stream Targets
      6. Streaming to Your Service
      7. GeoIP Country Locking
      8. Public Page
      9. Widgets & Links
      10. Reporting
    4. Reseller Operations Manual
      1. Reseller Dashboard
      2. Customers
      3. Media Services
    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
    7. Managing Media Using FTP
    1. Getting started with video streaming
    2. Live Streaming Overview
    3. TV Station Overview
    4. Ondemand Video Streaming
    5. VAST Advertising
    6. Relay & IP Camera
    7. Stream Recording
    8. GeoIP Country Locking
    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. Image Logo or Watermark Overlay on Video Stream
    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. Login to your cloud platform
      2. Dashboard - A First Look
      3. Team & Staff Members
      4. Plans & Customers
      5. WHMCS Billing Provisioning Module
      6. Branding your platform
      7. Activating VOD on Customer Plan
    3. User Manual - Cloud Video
      1. Login to your video platform
      2. First Look
      3. Creating a Channel
      4. Channel Overview
      5. Broadcasting
      6. Media Content
      7. Recording
      8. Fallback Video
      9. TV Channels - 24x7 UGC
      10. Video on Demand
      11. VOD Playlists
      12. Publishing
      13. Viewing Analytics
      14. Publish Zoom Meetings
      15. Advertising
      16. Restreaming IP Cameras
    4. Video Guide Series
    5. Streaming Best Practices
    6. Feature Comparison
    7. Roadmap & Release Notes

Last updated 2 months ago

Includes advanced configurations that don’t belong to any other category.

API Access

This configuration controls access to the MediaCP API. The API allows remote commands to be securely communicated through the platform, it is often used for integration into external systems such as Billing Systems or to enhance a Workflow.

Some examples of API usage:

  • An administrator uses the API to integrate with WHMCS Billing System
  • An administrator or reseller uses the API to automatically provision new Customers and Services when their customers complete payment
  • A customer automatically creates an automatic workflow to create DJ accounts

There are three levels of control, by default new Customers are not provided access to the API unless manually enabled by an Administrator:

  • Enabled – new users will not be provided API access until enabled
  • Enabled – new users will be provided API access by default
  • Disabled – No API Access, billing integrations will not work
Each Customer receives a unique API key that can be reset at any time. Documentation is available from the Customers Account Profile.

Listener/Viewer Maps



Google ReCAPTCHA adds a layer of security to the login page. When enabled, the Google ReCAPTCHA will be displayed after an unsuccessful login to the control panel.

You must provide a valid ReCAPTCHA v2 Site Key and Secret to use this feature.

For those using our WHMCS Integration, ReCAPTCHA will interrupt the WHMCS plugin sign in function, which will cause the login to not work and will require ReCAPTCHA completion to continue. 

If an invalid Site Key or Secret is provided, you may be locked out of the control panel.

Disable Google ReCAPTCHA

If Google Recaptcha is configured incorrectly it may restrict users from logging into the MediaCP. You can solve this issue by disabling the captcha.

  1. Login to SSH as root user
  2. Run the following command in SSH to disable ReCAPTCHA
echo "UPDATE settings SET value = 'disabled' WHERE setting = 'captcha';" | /usr/local/mediacp/mysql/bin/mysql --protocol=SOCKET --socket=/usr/local/mediacp/mysql/data/mysql.sock --user=root --password= mediacp >/dev/null 2>&1


  • FTP Server Prefix – FTP usernames are configured with a default prefix of “ftp_” before the users id. You can adjust the prefix by updating this value however please note it may be required to reset FTP accounts by running the following.
/root/init --reset-ftp


  • Debugging – Debugging output will provide additional information for MediaCP Support Team when an error is displayed in the control panel. It should be disabled unless there is a problem.
  • RESET Reporting Statistics – This will permanently delete the Historical Reporting data. If the database is quite large, then this may take some time to complete.
  • RESET Data Transfer – Permanently delete all bandwidth and data transfer information, effectively resetting all limits and destroying past data.
  • Refresh System Cache – Clears system caches such as Station Pages, HTML Player Configurations, Templates, Thumbnails, and Cover Art. If you have changed a setting in the control panel and it is not reflected, or there are broken thumbnails, then refreshing the system cache is recommended.

Table of Contents