Skip to main content

Using MongoDB Atlas with AMS

MongoDB Atlas is a multi-cloud database service. It simplifies deploying and managing the databases while offering the versatility to build resilient and performant global applications on the cloud providers of your choice like AWS, Azure, etc.

In this document we'll explain how to use MongoDB Atlas with Ant Media Server.

Creating a MongoDB Atlas Database

First, go to the Database section of your Atlas account and click on Create a database.


You can create the type of MongoDB cluster that you want by simply choosing any of the available options like Serverless, Dedicated or Shared in your choice of region of your cloud Provider.

Once done with all the necessary fields, click on Create cluster. It’ll take a few minutes and the database cluster will be ready.

Next, let's configure to control the IP addresses that can access the Atlas database by going to Add IP Address under Network Access.

Next, let’s create the database users for accessing the Atlas Database by clicking Database Access.

Using MongoDB Atlas with AMS Cluster

We can use MongoDB Atlas as the database for running AMS in cluster mode.

There are different ways in which Atlas mongodb+srv URI can be used to switch to cluster from standalone mode by either using the script or through script.

Using script is better when using Kubernetes or Docker based containers. Whereas when running the AMS server as a service, using is more suited.

Using mongoDB+srv URI with

For MongoDB Atlas connections, you can directly give the mongodb+srv URI under antmedia directory as follows.

sudo ./ cluster mongodb+srv://<username>:<password>@<url>

Using mongoDB+srv URI with

In script there are some MongoDB parameters like:

  • -h for mongoDB host
  • -u for mongoDB username
  • -p for mongoDB password

These parameters can be passed when starting Ant Media Server with

sudo ./ -m cluster -h mongodb+srv://username:password@url

One critical point to note is that when we specify the URL with MongoDB or monodb+srv, it's compulsory to provide the username and password.