Try Live Demo

If you have Ant Media Server deployed on a AWS cluster and you wish to upgrade it to the latest version, this tutorial will guide you through the necessary steps.

By following these instructions, you can upgrade your Ant Media Server AWS cluster and also retain all your existing settings without affecting the MongoDB configuration. If you don’t have a streaming service at scale on AWS yet, then go get one now using AWS Streaming Service Wizard. 

Let’s get started!

Manually Upgrading your AWS Cluster

Step 1: Find the Image ID of the Current Version

  1. Visit and find the zone where your Ant Media Server cluster is installed.ams cf update ami
  2. Note down the “Image ID” of your current Ant Media Server version. For example, let’s consider the Image ID of Ant Media Server version 2.5.3 in Frankfurt. The Image Id for Frankfurt is ami-0908f8767fc9d7f59.

Step 2: Copy the Launch Configuration

  1. Login to your AWS console and Navigate to EC2 > Launch Configurations.
  2. Select the Launch Configuration for the “Origin” instance and click on “Copy launch configuration.”
  3. In the Amazon Machine Image (AMI) section, enter the Image ID for your region as the AMI.
    AWS cluster launch configuration
  4. Create a new launch configuration by clicking on “Create launch configuration” without making any changes.
  5. Then repeat the same steps mentioned above for the “Edge” Launch Configuration.
  6. One all the those steps are completed, you’ll see the Launch configurations as in the below screenshot.
    ams cf update lc

Step 3: Upgrade to the Latest version of the Ant Media Server

  1. Navigate to EC2 > Auto Scaling groups.
  2. Locate the Auto Scaling group for both Origin and Edge.
  3. Access the Group details for each Auto Scaling group.
    AWS cluster auto scaling group
  4. Set the Desired capacity and Minimum capacity to 0 for both Origin and Edge groups.
    ams cf update desired
    This action will terminate the instances associated with the Auto Scaling groups.
  5. Now it’s time to assign the newly created Launch Configurations to the Autoscaling group.  Navigate to EC2 > Auto Scaling groups and access the “Launch configuration” for each Auto Scaling group. Then assign the Launch Configuration for each group.

    ams cf update auto scale 3
  6. After the instances are terminated, change the “Desired capacity” and “Minimum capacity” back to the original values on the Group details screen.

Finally, the newly opened instances will be updated to the latest version while retaining your old settings.

Auto Update Script

Alternatively, you can update your AWS cluster to the latest version automatically by running the Python script below. All you need to do is to write the AutoScale Group names for both Origin and Edge in the Python script.

You can find the Python script here.


By following these simple steps, you can successfully upgrade Ant Media Server on an AWS cluster to the latest version.

It’s important to note that this upgrade process does not modify the MongoDB settings, ensuring your existing configurations remain intact.

Please note that there have been reports of a security group modification on AWS that occurred after upgrading your Ant Media Server. This change led to the closure of TCP ports 5000-65000 for internal traffic, causing difficulties in playing back streams from the edge group. If you do experience any issues make sure you check the security groups and that all the necessary ports are open.

Enjoy the enhanced features and improvements offered by the latest version of Ant Media Server!

If you have not yet tried Ant Media Server on AWS, start a free trial of the Enterprise Edition and support packages are available for both editions if you need some extra help getting started.

Explore our extensive documentation or join the community forum to learn more about the product.

Categories: Tutorial

Murat Ugur

Murat is a Software Developer and a Technical Support Engineer at the same time at Ant Media. With a remarkable 15+ years in the IT domain, including 13 years dedicated to Linux System administration, Murat brings a wealth of experience to the table. His expertise is grounded in technologies like bash scripting, python, and puppet.