11 min read | 3012+ Views|

How to Deploy a MERN Stack application to AWS Amazon EC2

How to Deploy a MERN Stack application to AWS Amazon EC2

In this, we are going to learn How to Deploy MERN Stack Application to aws Amazon EC2 set up a production-ready web server on the aws Amazon EC2 service.

How to Deploy a MERN Stack application to AWS Amazon EC2

In this tutorial we`re going to set up a production-ready web server from scratch on the Amazon EC2 (Elastic Compute Cloud) service, then deploy a custom MERN Stack application to it that supports user registration and authentication.

How to Install MongoDB on Ubuntu 20.04/18.04

How to Install NodeJS on Ununtu 18.04/20.04

What is a MERN Stack App, and how does it work?

A MERN Stack framework is made up of a React front-end app that connects to a Node.js + Express + MongoDB backend API, hence the name MERN Stack (MongoDB, Express, React, Node). and we can also use  MEAN Stack, which uses an Angular front-end, and the MEVN Stack, which uses Vue.js, which are two other variants of the stack and all are full-stack development.

Scope in this tutorial blog.

This tutorial will cover setting up the server on AWS Amazon EC2, as well as deploying and configuring the MERN stack app`s front-end and back-end components to function together. Check out the following tutorials blog for more details on the React app and Node.js API used in this post:

  1. Create a new Ubuntu server on AWS EC2
  2. Connect to Ubuntu EC2 instance via SSH
  3. Cloning the projects in the ubuntu os in amazon ec2
  4. Setup server with Node.js + MongoDB in amazon ec2 ubuntu server
  5. Setup and install all the packages in the clone project in ec2
  6. Change proxy server in server.js in ubuntu server
  7. install pm2 and run the pm2 in both server and client in AWS ec2
  8. Test the MERN Stack app in a browser

Step1: Create a new Ubuntu server on AWS EC2

Before doing anything we need a server that we can work on, follow these steps to spin up a new Ubuntu 18.04 server instance on AWS EC2.

1. Sign in to the AWS Management Console at https://aws.amazon.com/console/. If you don`t have an account yet click the "Create a Free Account" button and follow the prompts.

sign up page aws ec2

2. Go to the EC2 Service section.

aws-services in ec2

3. Click the "Launch Instance" button.

Launch Instance in aws ec2

4. Choose AMI - Check the "Free tier only" checkbox, enter "Ubuntu" in the search box, and press enter, then select the "Ubuntu Server 18.04" Amazon Machine Image (AMI).

ubuntu server in ec2

5. Choose Instance Type - Select the "t2.micro" (Free tier eligible) instance type and click "Configure Security Group" in the top menu.

Instance Type in aws instance type

6.Configure Security Group - Add a new rule to allow HTTP traffic then click "Review and Launch".

Configure Security Group in aws ec2

7. Review - Click Launch

review and launch

8. Select "Create a new key pair", enter a name for the key pair (e.g. "my-aws-key"), and click "Download Key Pair" to download the private key, you will use this to connect to the server via SSH.

keypair value in amazon ec2

9. Click "Launch Instances", then scroll to the bottom of the page and click "View Instances" to see details of the new Ubuntu EC2 instance that is launching.


step2: Connect to Ubuntu EC2 Instance via SSH

Once the EC2 instance reaches a running state you can connect to it via SSH using the private key downloaded in the previous step.

  1. Open a terminal window and update the permissions of the private key file with the command
    $ chmod 400 <path-to-key-file>
    e.g. $
    chmod 400 ~/Downloads/my-aws-key.pem 
    , the key must not be publicly viewable for SSH to work.
  2. Copy the "Public DNS (IPv4)" property from the instance description tab in the AWS Console, then connect to the instance from the terminal window with the command
     ssh -i <path-to-key-file> [email protected]<domain name> 
    e.g. $
     ssh -i ~/Downloads/my-aws-key.pem [email protected] 
  3. Enter yes to the prompt "Are you sure you want to continue connecting (yes/no)?" to add the URL to your list of known hosts.

1. open in a window where you contained the private key value.

keyvalue pair in aws ec2

2. Connect to instance - check the instance and click on connect button in the top left where you find the ssh connection to ubuntu os.

ssh connect in aws iot

3. open git bash in the folder and connect to AWS ubuntu using ssh.

gitbash open to connect aws ec2

step3: Cloning the projects in the ubuntu os in amazon ec2.

Clone the Node.js + MongoDB API project into the ubuntu directory with the command 

sudo git clone https://github.com/EsC369/DevSpace20.git 


Commands should follow and type this command in ubuntu amazon ec2

sudo apt-get update
sudo git clone <project_name>

Step 4: Setup server with Node.js + MongoDB in amazon ec2 ubuntu server.

Option 1 - How to Install Nodejs On Ubuntu 20.04

How to Install NodeJS on Ununtu 18.04/20.04

sudo apt update
sudo apt install nodejs
node -v
sudo apt install npm

Option 2- Another way to Installing Node.js with Apt Using a NodeSource PPA

cd ~
curl -sL https://deb.nodesource.com/setup_16.x -o nodesource_setup.sh
nano nodesource_setup.sh
sudo bash nodesource_setup.sh
sudo apt install nodejs
node -v

Option 3- Installing Node Using the Node Version Manager

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.38.0/install.sh
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.38.0/install.sh | bash
source ~/.bashrc
nvm list-remote
nvm install v14.10.0 (enter version name)
nvm list

How to Install MongoDB On Ubuntu 20.04

wget -qO - https://www.mongodb.org/static/pgp/server-5.0.asc | sudo apt-key add -

or if this not work try this command to install 

sudo apt-get install gnupg

wget -qO - https://www.mongodb.org/static/pgp/server-5.0.asc | sudo apt-key add -

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/5.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list

sudo apt-get update

sudo apt-get install -y mongodb-org

Run MongoDB Community Edition

sudo systemctl start mongod

sudo systemctl status mongod

Optional Commands 

sudo systemctl stop mongod

sudo systemctl enable mongod

sudo systemctl restart mongod

Uninstall MongoDB Community Edition

To completely remove MongoDB from a system, you must remove the MongoDB applications themselves, the configuration files, and any directories containing data and logs. The following section guides you through the necessary steps.

sudo service mongod stop

sudo apt-get purge mongodb-org*

sudo rm -r /var/log/mongodb

sudo rm -r /var/lib/mongodb

How To Installing PM2 on Ubuntu 20.04

Next let’s install PM2, a process manager for Node.js applications. PM2 makes it possible to daemonize applications so that they will run in the background as a service.

Use npm to install the latest version of PM2 on your server:

sudo npm install [email protected] -g

pm2 start hello.js

start mongo db in amazon ec2

Step 5: Setup and install all the packages in the clone project in ec2.

1. Install packages on server-side 

cd <repo name>

sudo npm install

2. install packages on the client-side

 cd <client-folder>

 sudo npm install

sudo npm run build

If you face any error in client permission denied error 

sudo chmod +x node_modules/.bin/react-scripts

and start the build again

 sudo npm start

permission error

Step6: Change proxy server in server.js in the ubuntu server.

cd <client_foldername>

sudo nano package.json 

change proxy server URL into and click ctrl+x - Y - enter

change proxy in amazon ec2 aws

Step7: install pm2 and run the pm2 in both server and client in AWS ec2

PM2 is a daemon process manager that will help you manage and keep your application online. Getting started with PM2 is straightforward, it is offered as a simple and intuitive CLI, installable via NPM.

sudo npm install -g pm2 

Start Run pm2 in server Side of the Mern Stack

cd <repo_name>

pm2 start server.js

Start Run pm2 in client of the Mern Stack

 cd <client_folder>

 pm2 start --name <repo_name> npm -- start 

 pm2 start "npm start"


pm2 list 

 pm2 stop 0 (0 means pm2 is running id)

Managing application state in pm2 and this is optional is simple here are the commands:

sudo pm2 restart app_name
sudo pm2 reload app_name
 sudo pm2 stop app_name
 sudo pm2 delete app_name 

Step8: Test your new MERN Stack application running on AWS

  1. Enter the hostname of your AWS EC2 instance in a browser to access and test your new MERN stack application.
  2. The hostname is the "Public DNS (IPv4)" property located on the instance description tab in the AWS Console.
  3. open the public IP in the instance and with port number http:// :3000 and you will get.

open the web with public ip

Step 9: Setting Up Nginx as a Reverse Proxy Server On MERN Applications:

Your application is up and running on localhost, but you need to make it accessible to your users. For this, we will use the Nginx web server as a reverse proxy.

You put up your Nginx settings in the /etc/nginx/sites-available/notes4free.in a file in the required instruction. To edit this file, go to:

sudo nano /etc/nginx/sites-available/notes4free.in 

You should already have a location/block within the server block. The following configuration should be used to replace the contents of that block. Update the highlighted area to the correct port number if your application is set to listen on a different port:

server {
    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;

This tells the server to reply to requests from the root directory. Assuming our server is available at notes4free.in, a web browser request to https://example.com/ would be sent to hello.js, which is listening on port 3000 at localhost.

To enable access to other applications on the same server, you can add other location blocks to the same server block. If you had another Node.js application running on port 3001, for example, you might use this location block to allow access to it via https://notes4free.in/app2:

server {
    location /app2 {
        proxy_pass http://localhost:3001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;

Once you are done adding the location blocks for your applications, save the file and exit your editor.

Make sure you didn’t introduce any syntax errors by typing:

sudo nginx -t

Restart Nginx:

sudo systemctl restart nginx

If your Node.js application is up and running, and your application and Nginx configurations are proper, you should be able to access it using the Nginx reverse proxy now. Try it out by going to the URL of your server (its public IP address or domain name).

The page will open with the public IP and MongoDB and reactjs is connected with each other with the help of pm2, and the MERN application works good in the public IP and link this public IP to the domain name.