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
Custom Web Service Configurations

Last updated 3 months ago

It is possible to apply custom changes to the nginx web server and php service where required.

It is important to follow this guide as the included configuration files for nginx and php are automatically replaced when upgrading the MediaCP.

Nginx Configuration

Direct changes to nginx configuration files outside of the conf.d file will be lost on upgrade.

After applying changes, you can reload the nginx service by running:

/usr/local/mediacp/nginx/sbin/nginx -s reload

HTTP Block

You can apply http level configurations by creating a new file with .http extension within the following path:


Http Block Example


 server {
      server_name localhost;
      access_log /usr/local/mediacp/log/nginx/custom.log;


You can apply server {} level configurations by creating a new file with .conf extension within the following path:


For example,

# nano /usr/local/mediacp/nginx/conf.d/50_mychange.conf

These changes are included in the nginx server {} block

Rewrite Rules

NGINX rewrite rules are used to change entire or a part of the URL requested by a client. The main motive for changing an URL is to inform the clients that the resources they are looking for have changed its location apart from controlling the flow of executing pages in NGINX.

You can place custom rewrite rules within a file at /usr/local/mediacp/nginx/conf.d/locations.custom

After applying rewrite rules, be sure to reload or restart the nginx service (instructions at top of page).

PHP.ini Configurations

Direct changes to php.ini configuration file will be lost on upgrade.

You should apply any custom php.ini configurations to the php.include file:


After applying changes, you will need to restart the MediaCP PHP service:

mediacp restart php;

PHP-FPM Configurations

The default php-fpm configuration file is located in /usr/local/mediacp/php/etc/php-fpm.d/www.conf. This file is automatically generated on new installation and software upgrades. Direct changes to this file should be avoided. Custom changes can be applied directly to the following custom file instead:
After applying changes, you need to restart the MediaCP PHP service:
mediacp restart php;

Table of Contents