In this article, we are going to deploy a NodeJS application on <a href="http://app.patr.cloud">Patr</a>. Before we get started, let's get a quick overview of <a href="https://nodejs.org/en/">NodeJS</a>.
<h2>What is NodeJS?</h2>
In the simplest terms, NodeJS is a runtime for JavaScript. Node.js is not a silver-bullet new platform that will dominate the web development world, it instead, serves as a platform that fulfils a particular requirement. When it comes to real-time applications such as chat, news feeds and web push notifications, this open-source server-side JavaScript execution platform is useful for developing persistent connections from a browser to a server.
With the basic understanding of NodeJS let's see move on to deploying a NodeJS app on <a href="http://app.patr.cloud">Patr</a>.
<h2>Step 1: Create a Patr account</h2>
Platforms shouldn't make deploying NodeJS applications harder than it already is, right? We've chosen Patr for deploying our app, as it completely simplifies the entire process. To get started all you need to do is sign up on <a href="https://app.patr.cloud/">app.patr.cloud.</a>
<img src="/static/images/blogs/blogs/common-images/sign-up.webp" alt="">
<h2>Step 2: Create a Docker repository on Patr</h2>
<a href="https://www.docker.com/">Docker</a> has become the preferred way to containerize modern applications and services. Patr provides first-class support for running docker images. We will create a docker registry for your docker images.
For deploying docker images on Patr, we first need to create a private Docker Repository on Patr.
<ol>
<li>Go to Docker Repository -> Create Repository</li>
</ol>
<img src="/static/images/blogs/blogs/common-images/sidebar-docker-repo.webp" alt="">
<img src="/static/images/blogs/blogs/common-images/create-docker-repo-button.webp" alt="">
2. Enter the repository name of your choice, for this example let it be “NodeJS”.
<img src="/static/images/blogs/blogs/how-to-deploy-a-node-js-app-on-patr/fill-docker-repo-details.webp" alt="">
3. Then click Create. Once you open you can view all the information related to your docker repo — repository URL, size etc.
<img src="/static/images/blogs/blogs/how-to-deploy-a-node-js-app-on-patr/docker-repo-details.webp" alt="">
<h2>Step 3: Dockerize your NodeJS app</h2>
To deploy your NodeJS application you need to dockerize your NodeJS app. You can dockerize your app using the following steps in Docker File. Now in your project directory create a file Docker File with:
<pre><code># base image
FROM node:latest

# working directory inside container
WORKDIR /app

# copy everything to working directory, can add .dockerignore file to ignore node_modules
COPY . .

# install all the dependencies
RUN npm install

# run the server
CMD ["node", "server.js"]
</code></pre>
Note: you should use a package like pm2 for running your production server.
<h2>Step 4: Build and push your Docker image to Patr</h2>
Now that you have your Docker File, it's time to build it and push it to the Docker registry that you have created in Step 3.
<pre><code># Build you docker image from Docker File you created
docker build -t my-node-app .

# tag the node image to your Patr's private NodeJs repo
docker tag my-node-app:latest {link_to_your_node_docker_repo_in_patr}:latest

# login to patr's docker registry with your Patr credentials
docker login registry.patr.cloud

# push the tagged image to your Patr's NodeJS docker repo
docker push {link_to_your_node_docker_repo_in_patr}:latest
</code></pre>
You can now see the change in the size of the image.
<img src="/static/images/blogs/blogs/how-to-deploy-a-node-js-app-on-patr/docker-image-size.webp" alt="">
<h2>Step 5: Create a deployment for your app</h2>
Go to Infrastructure -> Deployment -> Create a new deployment on Patr
<img src="/static/images/blogs/blogs/common-images/sidebar-deployment.webp" alt="">
<img src="/static/images/blogs/blogs/common-images/create-deployment-button.webp" alt="">
i. Enter the name as “nodejs”.
ii. Choose image details as “nodejs”.
iii. Choose tag as “latest”.
iv. Choose a region nearest to your location in the dropdown menu.
<img src="/static/images/blogs/blogs/how-to-deploy-a-node-js-app-on-patr/create-deployment-step-1.webp" alt="">
v. Click “Next”.
Based on your app select the port, environment variables or secrets in case you have created any. In this tutorial, we will proceed with port only.
<img src="/static/images/blogs/blogs/how-to-deploy-a-node-js-app-on-patr/create-deployment-step-2.webp" alt="">
vi. Then press next and select the deployment strategy on push or on create.
vii. Select the number of replications for the app.
viii. Choose the machine type and press Create.
You should witness a status similar to the image attached below.
<img src="/static/images/blogs/blogs/how-to-deploy-a-node-js-app-on-patr/deployment-deploying.webp" alt="">
Step 6: Copy Deployment ID
I. Within seconds, your application will be live on Patr.
<img src="/static/images/blogs/blogs/how-to-deploy-a-node-js-app-on-patr/deployment-running.webp" alt="">
II. To access your application from your browser, click on the created deployment and copy the deployment-id in the URL.
<img src="/static/images/blogs/blogs/how-to-deploy-a-node-js-app-on-patr/deployment-details.webp" alt="">
III. Using your app — You can now access your application by using the URL
{port}-{deployment-id}.patr.cloud
where — {port} is the port which we allowed during the deployment (in our case 8000) — {deployment-id} is the id which we copied in the previous step.
<img src="/static/images/blogs/blogs/how-to-deploy-a-node-js-app-on-patr/live-deployment.webp" alt="">
Voila! You have successfully deployed a NodeJS app using Patr within seconds.

How to deploy a Node.js app on Patr

Patr takes care of everything,
so you can focus on what really matters.

How to deploy a Node.js app on Patr

Patr takes care of everything, so you can focus on what really matters.

Patr takes care of everything,
so you can focus on what really matters.