This tutorial will guide you on how you can deploy your MERN application on AWS ( ec2 instance ) with the step by step instructions.
- AWS instance creation
- Connection with ec2 instance by ssh
- nvm, Nginx, and default HTML page setup to confirm everything is working according to our expectation
- Steps to change the default Nginx config file for MERN application
- Procedure to clone project repo
- Running Demo
You can download the sample MERN application to learn the concept. later on, you can deploy your own project
How you can create an instance in AWS?
Step -1
Open ec2 service and on the left side there is an instances section, click on it
Step-2
Click on the launch instance button
Step-3
Enter name, select amazon Linux, key pair ( make sure your key-pair name should be the same name as your username otherwise you would face a problem), and then allow traffic from all sources ( SSH, HTTP, HTTPS ).
Step-4
launch the instance and wait 2-5 minutes for proper completion
How to connect with ec2 instance by ssh
First select instance and then click on connect button at the top of the table
After redirecting to the connection page, select the ssh tab and follow all the steps which are mentioned. (step-3 and the example are important to connect your terminal with the instance ) but if you are using Windows you can connect with the ec2 instance by putty.
Environment setup to run MERN application on AWS ( ec2 instance )
download nvm to install the node
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.34.0/install.sh | bash
. ~/.nvm/nvm.sh
nvm install 16.13.0
nvm use 16.13.0
download nginx
sudo amazon-linux-extras install nginx1
in order to check whether Nginx is working or not, do the following steps
When the Nginx service is stopped, you will get the following message:
curl localhost:80
if your nginx is not working then you will see the following error
[root@ip-ADDRESS ec2-user]# curl localhost:80
curl: (7) Failed to connect to localhost port 80 after 0 ms: Connection refused
So, let’s start the Nginx service:
sudo service nginx start
and then type
curl localhost:80
You will get an HTML page
You can also see the HTML page by visiting the public ipaddress of your ec2 instance
If you are not seeing the html page then you need to allow port 80 in your security group.
-> visit ec2 -> select instance -> on the bottom -> select security -> scroll down -> click on group name -> scroll and then click on edit inbound rule -> allow http and https both
Still, if you are facing the problem, recreate your instance with the following settings
create a new security group -> allow HTTP, HTTPS, and ssh
Steps to change the default Nginx config file to deploy the MERN application
First, open the config file by entering the following command
sudo nano /etc/nginx/nginx.conf
and paste the following code in the config file and change the port number according to your used port number. I am using 3000 for frontend and 8000 for the backend
location /api {
rewrite /api/(.*) /$1 break;
proxy_pass http://localhost:8000;
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;
}
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;
}
complete Nginx config code to deploy the MERN application
# For more information on configuration, see:
# * Official English Documentation: http://nginx.org/en/docs/
# * Official Russian Documentation: http://nginx.org/ru/docs/
user nginx;
worker_processes auto;
error_log /var/log/nginx/error.log;
pid /run/nginx.pid;
# Load dynamic modules. See /usr/share/doc/nginx/README.dynamic.
include /usr/share/nginx/modules/*.conf;
events {
worker_connections 1024;
}
http {
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
access_log /var/log/nginx/access.log main;
sendfile on;
tcp_nopush on;
tcp_nodelay on;
keepalive_timeout 65;
types_hash_max_size 4096;
include /etc/nginx/mime.types;
default_type application/octet-stream;
# Load modular configuration files from the /etc/nginx/conf.d directory.
# See http://nginx.org/en/docs/ngx_core_module.html#include
# for more information.
include /etc/nginx/conf.d/*.conf;
server {
listen 80;
listen [::]:80;
server_name _;
root /usr/share/nginx/html;
# Load configuration files for the default server block.
include /etc/nginx/default.d/*.conf;
location /api {
rewrite /api/(.*) /$1 break;
proxy_pass http://localhost:8000;
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;
}
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;
}
error_page 404 /404.html;
#location = /404.html {
#}
error_page 500 502 503 504 /50x.html;
#location = /50x.html {
#}##
}
# Settings for a TLS enabled server.
#
# server {
# listen 443 ssl http2;
# listen [::]:443 ssl http2;
# server_name _;
# root /usr/share/nginx/html;
#
# ssl_certificate "/etc/pki/nginx/server.crt";
# ssl_certificate_key "/etc/pki/nginx/private/server.key";
# ssl_session_cache shared:SSL:1m;
# ssl_session_timeout 10m;
# ssl_ciphers PROFILE=SYSTEM;
# ssl_prefer_server_ciphers on;
#
# # Load configuration files for the default server block.
# include /etc/nginx/default.d/*.conf;
#
# error_page 404 /404.html;
# location = /40x.html {
# }
#
# error_page 500 502 503 504 /50x.html;
# location = /50x.html {
# }
# }
}
reload your Nginx
sudo systemctl reload nginx
after it, when you will visit your public ip address then you will see 502 bad gateway error, it’s mean everything is ready now we need to run our frontend and backend application
Procedure to clone project repo
sudo yum install git
if your repo is public then you only need to run the git clone command but if your repo is private do the following steps
generate ssh key
ssh-keygen -t ed25519 -C "your_email@example.com"
go to your .ssh folder
cd ~/.ssh
now copy your id_ed25519.pub by running the following command
cat id_ed25519.pub
add this to your github account
visit your github profile -> go to settings by clicking on the top right corner of your profile -> select ssh and GPG keys -> click on new ssh key button -> paste the public key on the description box and you can add any name
Now clone your repo by ssh URL
go to your frontend and install all the packages but if you find an error in installing the packages then do the following steps
first way
sudo npm install
second way
chmod -R 777 yourreponame
npm i
Now we will install pm2
You can further read about pm2
npm i pm2 -g
after it adds the following config in your frontend folder, push it to your GitHub repo and then run the git pull origin master command so you can pull the latest changes in your ec2 server
app.config.json
{
"apps": [
{
"name": "react-app",
"script": "npx",
"interpreter": "none",
"args": "serve -s build -p 3000"
}
]
}
add the following command in your package.json file
"start:production": "npm run build && pm2 delete app.config.json && pm2 start app.config.json"
after pulling the latest changes in your ec2 server then run the following command to run your frontend but before this make sure your react app knows your latest backend URL and your latest backend URL will be like /api
npm run start:production
for this, I will suggest your code must get the URL from the env file and you only need to update your env file to update the backend URL
you can create an env file in your frontend folder or backend folder like
nano .env
paste your .env variables in your env file and then press
control X
press y
press enter
it will create your .env file
npm run start:production
if you want to check whether your react app is working or not then run the following commands
pm2 logs
Similarly, we will run the node app
First, copy the following app.config.json code in your node project and push the latest changes in your github repo and then pull it in your ec2 instance
{
"apps": [
{
"name": "node-app",
"script": "index.js",
"watch": true,
"env": {
"NODE_ENV": "production"
}
}
]
}
add the following command in your package.json file
"start:production": "pm2 delete app.config.json && pm2 start app.config.json"
if you want to check whether your node app is working or not then run the following commands
pm2 logs
Running Demo
now you can visit the public ipaddress again and you will see your website
In the next upcoming lecture, I will show you how you can assign a domain and encrypt your domain properly. I will also write an article on how you can create a pipeline so you don’t need to do these steps again and again instead of it you only need to push the code into your repo and everything will occur automatically.
if you like my article, connect me on LinkedIn and share it with your friends😊
Thanks