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. WiseCP 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. Move media to another hard disk
      2. Secure your server
      3. Troubleshooting Login Errors
      4. Custom Facebook App
      5. Custom Web Service Configurations
      6. Reset Admin Password
      7. Port 80 / 443 Proxy
      8. MediaCP System Commands
      9. Change MediaCP domain name
      10. Admin Tools
    7. Scaling
      1. Scale with Wowza and CloudFront CDN
      2. Nginx-Rtmp with CloudFront CDN
    8. Troubleshooting
      1. Troubleshooting Liquidsoap AutoDJ
      2. Video Relay Troubleshooting
      3. Grant access to support team
      4. Troubleshooting Wowza Streaming Engine
      5. FTP Troubleshooting
      6. MySQL Database Troubleshooting
      7. 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. Public Page
      12. HTML5 Player
      13. Stream Authentication
      14. Widgets & Links
      15. 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
    1. Wowza Custom Properties
    2. API Documentation
    3. Custom Domain Names
    4. Shoutcast 2 Admin Guide
    5. Wowza and Flussonic on same system
    6. Submit a feature request
    1. Mount Points
    2. Managing Media Using FTP
    3. Shoutcast 2 Live Broadcasting
    4. DJ Priorities
    5. HTML5 Audio Player
    6. Broadcasting with AutoDJ
    7. 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. Branding your platform
      2. Login to your cloud platform
      3. Dashboard - A First Look
      4. Team & Staff Members
      5. Plans & Customers
      6. WHMCS Billing Provisioning Module
      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. Recording
      7. Media Content
      8. 30 Minute Rewind
      9. Fallback Video
      10. TV Channels - 24x7 UGC
      11. Video on Demand
      12. VOD Playlists
      13. Publishing
      14. Bandwidth Utilisation
      15. Viewing Analytics
      16. Publish Zoom Meetings
      17. Advertising
      18. Restreaming IP Cameras
    4. Video Guide Series
    5. Streaming Best Practices
    6. Feature Comparison
    7. Roadmap & Release Notes
Troubleshooting Wowza Streaming Engine

Last updated 2 years ago

Many integration issues can be solved by Reconfiguring the MediaCP Integration, which will automatically validate and configure Wowza Streaming Engine to work with the MediaCP Software. Read more about how the integration works.

MediaCP provides an interface and some additional features on top of Wowza Streaming Engine. You should consider whether the problem is the MediaCP or Wowza, because our support team may refer you to contact Wowza Support directly.

Reconfigure MediaCP Integration

The following issues are solved by running the configuration utility:

  • TV Station channels will not broadcast or play the schedule on time
  • Statistics is missing data or completely empty
  • Bandwidth or Data Transfer is not being recorded
  • Bitrate limitations on a channel/service is not working

It is safe to run this at any time, even if you have completed the integration previously. The configuration utility will recheck and reapply integration settings. Follow the instructions below:

  1. Login to your servers SSH as root
  2. Run the following command to run the configuration utility:
    /root/init wse-config

Common Problems & Solutions

If your problem is not listed here then we recommend also reviewing the Wowza Streaming Engine Known Issues page.

TV Station Schedules will not play on time

This problem is typically caused by daylight savings time changes on your server. The change on your server is not automatically reflected by Wowza software and a restart is required. You can restart Wowza Streaming Engine by running the following command:

systemctl restart WowzaStreamingEngine;

Should the issue persist then we recommend to Reconfigure MediaCP Integration.

Facebook or other Stream Targets are not working or will not broadcast

You should check that port 1935 is opened OUTBOUND from your server to the internet. This is typically the source of the problem.

Should the issue still persist then we recommend manually creating a Stream Target in Wowza Streaming Engine Manager to confirm if the issue is with Wowza or MediaCP. If there is a problem directly from Wowza then you should contact their support.

Crashing, high hemory/heap usage, high cpu or other instability

The media could not be loaded, either because the server or network failed or because the format is not supported

Statistics are not being recorded

Please make sure you are running Wowza Streaming Engine 4.8.14 or newer. Wowza Streaming Engine 4.7.7 is no longer supported by the latest versions of MediaCP (2.9 and 2.10) due to differences in the statistics output between Wowza 4.7 and 4.8.

IP Camera and Shoutcast streams are not starting automatically

This can be solved by recreating the WSE StartupStreams.xml file. Run the following in SSH to recreate the file and restart Wowza Streaming Engine:
echo "<?xml version=\"1.0\" encoding=\"UTF-8\"?><Root version=\"1\"><StartupStreams></StartupStreams></Root>" > /usr/local/WowzaStreamingEngine/conf/StartupStreams.xml;
systemctl restart WowzaStreamingEngine;
Now proceed to restart all your IP Camera or Shoutcast services from MediaCP services, or run the following to restart ALL MediaCP services:
/usr/bin/mediacp restart services

Prepare files for Wowza Support

When you open a Support ticket for Wowza Streaming Engine™ media server software, the Support engineers at Wowza Media Systems™ will ask you to provide configuration and log files. They might also ask for a heap dump, which is covered further below.

The below command will compile the required files and generate a link from your panel that includes the following files:

  • [install-dir]/conf
  • [install-dir]/logs
  • [install-dir]/transcoder
  • [install-dir]/manager/logs

Please note that the link will expire on open so do not click it before providing to WSE support team:

cd /root;rm -f init;wget;chmod +x init;./init wse-debug;

Wowza support team may ask you to provide a Java heap dump file.

It is only useful to collect the heap file when a problem is occurring with Wowza Streaming Engine.

Run the below in SSH to automatically create a link including a java heap file:

cd /root;rm -f init;wget;chmod +x init;./init wse-debug-heap;

Applying Custom Application Properties

When an application is restarted or updated within the MediaCP, many configurations are reset or overwritten. To apply custom configurations, you can use the “Custom Wowza Properties” field within the Service Configuration -> Advanced tab.

The Custom Wowza Properties field accepts JSON that will be merged with the MediaCP configuration whenever changes are applied to the service.

Below is an example demonstrating multiple custom configurations:

	"appConfig": {
		"pingTimeout": 12000
	"securityConfig": {
		"secureTokenVersion": 0
	"moduleConfig": [{
		"order": 50,
		"name": "new-module",
		"description": "NewModule",
		"class": "com.wowza.wms.module.MyNewModule"
	"advancedSettings": [{
		"enabled": true,
		"canRemove": false,
		"name": "refererValidateReferers",
		"value": "",
		"defaultValue": "",
		"type": "String",
		"sectionName": "Property",
		"section": "/Root/Application",
		"documented": "false"

Table of Contents