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. 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. 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. Widgets & Links
      11. Reporting
    3. 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. Relay & IP Camera
    6. GeoIP Country Locking
    7. VAST Advertising
    8. Stream Recording
    9. Connecting your encoder
    10. Preparing Your Media Files
    11. Understanding Video Playlists
    12. Embedding player on your website
    13. Smooth Streaming and Content Transition
    14. Video Transcoding (Adaptive Bitrate Streaming)
    15. Image Logo or Watermark Overlay on Video Stream
    16. DVR Rewind
    17. Statistics
    18. Facebook Live Streaming
    19. Youtube Stream Publishing
    20. Twitch Stream Publishing
    21. Shoutcast 2 Stream Publishing
    22. Icecast Stream Publishing
    23. RTMP Stream Publishing
    1. Cloud Video Overview
    2. Admin Manual - Cloud Video
      1. Login to your cloud platform
      2. Dashboard - A First Look
      3. Branding your platform
      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. Fallback Video
      8. TV Channels - 24x7 UGC
      9. Video on Demand
      10. VOD Playlists
      11. Publishing
      12. Viewing Analytics
      13. Publish Zoom Meetings
      14. Advertising
      15. 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