Log in
Contact Sales
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. SSL Certificates
      6. Streaming Servers
        1. MediaCP Video
        2. Wowza Streaming Engine
        3. Flussonic Media Server
        4. Video Feature Comparison
        5. Icecast 2 / Icecast KH
        6. Shoutcast 2
    3. Billing Integration
      1. WHMCS Integration Guide
      2. Clientexec Integration Guide
      3. Blesta Integration Guide
      4. WiseCP Integration Guide
      5. Billing Platform Comparison
    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. MediaCP Video with CloudFront CDN
      3. MediaCP Video with CDN Proxy
      4. MediaCP CDN Capabilities
    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
      8. Disk 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. Stream Events
    11. Software Health
    12. Software Updates
    13. Email Templates
    14. API
    1. Introduction
    2. Video Operation Manual
      1. Basics 101
      2. Service Overview
      3. File Manager
      4. Scheduling
      5. Streaming to Your Service
      6. Stream Targets
      7. GeoIP Country Locking
      8. Public Page
      9. Video Stream Events
      10. Widgets & Links
      11. Reporting
    3. 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 Authentication
      11. Public Page
      12. HTML5 Player
      13. AutoDJ Crossfade
      14. Stream Proxy
      15. Audio Processing
      16. Widgets & Links
      17. Audio Stream Events
      18. Reporting
    4. Reseller Operations Manual
      1. Reseller Dashboard
      2. Customers
      3. Media Services
    5. API
    1. Submit a feature request
    2. Build and Publish Custom Roku Channel App
    3. Responsible Disclosure
    4. Youtube Stream Publisher App
    5. Shoutcast 2 Admin Guide
    6. Custom Domain Names
    7. Wowza and Flussonic on same system
    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. 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. 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. Event Webhooks
      8. Activating VOD on Customer Plan
      9. API
    3. User Manual - Cloud Video
      1. Login to your video platform
      2. First Look
      3. Creating a Channel
      4. Channel Overview
      5. Broadcasting with OBS
      6. Broadcasting
      7. Stream Watermarking
      8. Stream Transcoding (ABR)
      9. Recording
      10. Media Content
      11. Live Events
      12. Live Paywall
      13. Fallback Video
      14. 30 Minute Rewind
      15. Video Players
      16. TV Channels - 24x7 UGC
        1. TV Event Scheduling
        2. Channel Guide Widgets
      17. Video on Demand
      18. Relay Channels
      19. VOD Playlists
      20. Publishing
      21. Bandwidth Utilisation
      22. Viewing Analytics
      23. Publish Zoom Meetings
      24. Advertising
      25. Restreaming IP Cameras
    4. Video Guide Series
    5. Streaming Best Practices
    6. Feature Comparison
    7. Roadmap & Release Notes

Upgrading

Last updated 3 months ago

Why not have our experts upgrade for you?
Our team will upgrade the MediaCP to the latest version.
Request Upgrade Service
Service

This guide will assist you with upgrading MediaCP on supported Linux operating systems.

1. Notes

2. Login as Root

It is required that you login to the server as root user to upgrade the Media Control Panel.

3. Update System Packages

Before upgrading the MediaCP software, you should ensure your system has all the latest updates. 

CentOS Stream / AlmaLinux

dnf update

Debian / Ubuntu

apt update && apt upgrade

4. Backup

You should backup your MediaCP software and store the backup off-site before every upgrade.

A software upgrade can fail for several reasons such as disk failure, sudden power-off, network connectivity loss and more. The upgrade can be an intensive operation as it may need to compile software or process database changes, this can be a common reason for issues with your servers disks, memory or other problems to be exposed.

5. Update Media Control Panel

Login to your SSH server as root and run the following command: 
su -c "$(curl -sSL http://install.mediacp.net) upgrade"
If upgrading between major versions (i.e., 2.10 to 2.11) then we recommend restarting all services. 
mediacp restart services

6. Update Mediacp Without Updating Wowza.

By default the MediaCP is tightly coupled with Wowza and does automatically manage the version.

If the currently supported version of Wowza is 4.9.5+3 and MediaCP will not upgrade beyond this version.

To prevent MediaCP from automatically updating Wowza Streaming Engine then you can make sure that our version file at /usr/local/mediacp/versions/WowzaStreamingEngine contains the current version number exactly as is, in this example the current version is 4.9.5+3. This means that when editing the version file you will need to enter exactly “4.9.5+3”.

7. Troubleshooting

Installation/Upgrade failed during prerequisites stage: This may occur if there is a problem with the yum or apt updates utility. If the install or upgrade gets stuck during this step you will need to contact your server provider to repair yum or apt, once repaired reattempt the upgrade or installation.

Table of Contents