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. Shoutcast 2
      6. SSL Certificates
    3. Billing Integration
      1. WHMCS Integration Guide
      2. Clientexec Integration Guide
      3. Blesta Integration Guide
      4. WiseCP Integration Guide
      5. Billing Platform Comparision
    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. 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. Scale with Wowza and CloudFront CDN
      2. Nginx-Rtmp with CloudFront CDN
      3. Nginx-Rtmp with CDN Proxy
    8. Troubleshooting
      1. Troubleshooting Liquidsoap AutoDJ
      2. Video Relay Troubleshooting
      3. Disk Troubleshooting
      4. Grant access to support team
      5. Troubleshooting Wowza Streaming Engine
      6. FTP Troubleshooting
      7. MySQL Database Troubleshooting
      8. Reporting 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. Fallback, Backup and Intro Files
      10. Stream Proxy
      11. AutoDJ Crossfade
      12. Public Page
      13. HTML5 Player
      14. Stream Authentication
      15. Widgets & Links
      16. Reporting
    3. Video Operation Manual
      1. Basics 101
      2. Service Overview
      3. File Manager
      4. Scheduling
      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
    5. API
    1. Custom Domain Names
    2. Shoutcast 2 Admin Guide
    3. Wowza and Flussonic on same system
    4. Submit a feature request
    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. 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. 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. WHMCS Billing Provisioning Module
      2. Login to your cloud platform
      3. Dashboard - A First Look
      4. Branding your platform
      5. Team & Staff Members
      6. Plans & Customers
      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. Viewing Analytics
      17. Bandwidth Utilisation
      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
Custom Domain Names

Last updated 2 years ago

Custom domain names allow your services to use an address that is different to the primary domain used on the control panel.

An example may be where you want your control panel to operate at panel.mediacp.net but your icecast services to operate from icecast.mediacp.net. All links that relate to your service would then be changed to icecast.mediacp, including:

  • The direct service and stream address:  https://icecast.mediacp.net:8000
  • The public page address:  https://icecast.mediacp.net/public/icecast
  • The stream proxy addresses:  http://icecast.mediacp.net/stream/icecast
The MediaCP will automatically generate and manage an SSL certificate for each custom domain name, including automatic renewal via LetsEncrypt. Automatic renewal occurs every 60 days which is determined by LetsEncrypt. The admin email address configured on the panel is used to create the lets encrypt order.

This feature is disabled by default and must be enabled on each service individually before it can be used in the control panel. It is possible to enable the feature by default.

Notes & Limitations

  • Available with MediaCP 2.10.7 and newer
  • Only available with Audio Streaming services (Shoutcast & Icecast) at this point in time. We will be looking to support video streaming services in the near future.
  • A Custom Domain should be configured with a CNAME record pointing to the primary hostname.
  • CNAME records are only possible for sub-domains, it is not possible to configure the root domain name such as “mydomain.com”, only “subdomain.mydomain.com”.
  • When using Bind IP Address, you may instead configure an A RECORD that points to this IP Address. 
  • Port 80/443 Proxy must be installed for this feature to work. This is because the MediaCP requires control over port 80 to automatically manage SSL certificates.
  • If port 80 or 443 is in use by another service on your system, such as cPanel, Plesk, CentOS Web Panel or another service then it will not be possible to use this feature. 

Usage Guide

Install Custom Domains on panel

You will need to run the Port 80/443 Proxy installation in order to begin using Custom Domains. If you are already using Port 80 / 443 Proxy then we recommend reinstalling the configuration.

If port 80 or 443 is in use by another service on your system, such as cPanel, Plesk, CentOS Web Panel or another service then it will not be possible to use this feature. This is because the MediaCP requires control over port 80 to automatically manage SSL certificates.

/root/init enable-http-proxy

Enable by default on new services

Custom Domains are disabled by default on new services. You can change this default behaviour by updating the setting within System Config -> Services tab.

Enable/disable on individual service

The Custom Domain Name can be configured on an individual service under the Features tab. Once enabled, the customer will be able to configure a custom domain name under the Advanced Tab.

Configure Custom Domain on a service

Troubleshooting

Error: DNS record for this domain is not configured correctly

The error relates to being unable to resolve the provided domain to the CNAME record of your panels domain. 

Check the provided domain name is setup as a CNAME record and points to your MediaCP primary domain name.

We recommend checking the domain at whatsmydns.net; make sure to select the “CNAME” option and the result is the domain name of your primary control panel.

Error: There is a problem generating an SSL certificate for this domain.

An SSL certificate was unable to be provisioned for the domain name. There could be several reasons for this problem.

You should check the /usr/local/mediacp/log/autossl/custom.log file for more information on the problem.

Table of Contents