Thought leadership from the most innovative tech companies, all in one place.

How to install MongoDB in AWS EC2

AWS does support NoSQL databases such as DynamoDB and DocumentDB but not MongoDB. So if you would like to host your MongoDB to the AWS cloud but do not want to migrate to another DB, you may install…


AWS does support NoSQL databases such as DynamoDB and DocumentDB but not MongoDB. So if you would like to host your MongoDB to the AWS cloud but do not want to migrate to another DB, you may install it yourself. In this tutorial, we learn how to install MongoDB in an EC2 Linux instance.

Step 1: Create an EC2 instance

Login to your AWS console, and navigate to EC2.

  • Name: mongodb-instance
  • AMI: Amazon Linux 2 AMI
  • Architecture: 64-bit (x86)
  • Instance type: t2.micro (Free tier)
  • Key pair: <your existing key pair or create a new one>
  • Security Groups: Allow SSH traffic from Anywhere (we will need this to SSH into the instance to install the MongoDB)
Step 2: Install MongoDB

Once the EC2 instance state turns to “Running”, open a terminal on the directory where you stored the key pair (.pem). Create a /etc/yum.repos.d/mongodb-org-6.0.repo file so that you can install MongoDB directly using yum

sudo vim /etc/yum.repos.d/mongodb-org-6.0.repo####hit I to enter INSERT mode, copy and paste the following[mongodb-org-6.0]
name=MongoDB Repository
gpgkey= ####hit esc key to exit INSERT mode, and run :wq to save the file.

Run the following command to install the latest MongoDB.

sudo yum install -y mongodb-org


Run the command below to verify MongoDB has been installed correctly.

mongod --version


We have successfully set up MongoDB in the EC2 instance. To start the MongoDB run the following command:

sudo systemctl start mongod

To verify the MongoDB has been started successfully, issue the following command:

sudo systemctl status mongod

image That is great, the MongoDB has been activated. Let’s go into the MongoDB shell to create a database schema and table. Issue the command below:


Run use DATABASE_NAME to create a database. The command will create a new database if it doesn't exist, otherwise, it will return the existing database.


Next, create a user account. image Now, try to insert some records into DB.

  name: "Apple",
  description: "This is an Apple",
  price: 2.50

image To retrieve the inserted record by issue the query:




In some situations, we might need to access MongoDB remotely or locally. In other to allow outside connection to your MongoDB, we need to allow inbound traffic. In the instance summary page, go to the Security tab and navigate to the Security Groups

image From the Inbound rules tab, click Edit inbound rules. By default, we can see the Port 22 SSH is open.

image Next, add a new rule. Since MongoDB is listening to port 27017, we need the rule to allow incoming connections to this port. Save the rules.

image By default, MongoDB launches with [bindIp]( set to, which binds to the localhost network interface. This means that the mongod or mongoshcan only accept connections from clients that are running on the same machine. Remote clients will not be able to connect to the mongodor mongosh . Now run the command below to change the bindIp to allow remote IP to access:

sudo vim /etc/mongod.conf

image Enabled the security so that remote users can access MongoDB by providing a username and password. Restart the MongoDB server by issuing the command:

sudo systemctl restart mongod

To test the connection remotely run the command below from your local terminal if you have MongoDB installed locally:

mongo -u mongodbadmin -p P@ssw0rd

Or you may install NoSQLBooster GUI. Create a connection and enter the public IP of your EC2 as Server.


Next, navigate to the Authentication tab, and select Basic(Username/Password) as the mode. Auth DB will be your created database name.


Click on the Test Connection button, you should be able to connect the MongoDB hosted in EC2.



To stop the MongoDB server issue the command:

sudo systemctl stop mongod

Great! We’ve successfully installed MongoDB in AWS EC2.

Continue Learning