Skip to main content
⭐️ If you love EverShop, give it a star on GitHub. Thanks!

Deploy EverShop To Microsoft Azure

This document describes step by step how to deploy EverShop to Microsoft Azure using Azure App Service.


  1. An active Microsoft Azure account.
  2. An EverShop project installed on your local machine.
  3. Git installed (for version control if your app is in a Git repository).

Step 1: Create a New Azure Web App

  1. Log in to the Azure portal (

    Azure Create A Resource

  2. Click on the "+ Create a resource" button.

  3. Search for "Web App & Database" and select "Web App & Database" from the results. Azure Select Web And Database

  4. Click the "Create" button to start configuring your web app.

  5. Fill out the necessary information, including the App name, subscription, resource group, OS (Linux or Windows), and other settings.

For the app, let's use the following settings:

Azure Configure Web App

And for the database, let's use the following settings:

Azure Configure Database

  1. Click "Review + create" and then "Create" to create the web app. This is how it looks like when the web app is created:

Azure Resource List

Step 2: Configure Deployment Options

Azure supports several deployment options, including FTP, local Git, GitHub, Bitbucket, and Azure Repos. In this guide, we will use the local Git option.

  1. Once the web app is created, go to the "Deployment Center" in the Azure portal.
  2. Choose local Git as the deployment option.
  3. Click the "Save" button to save the configuration.

Azure Configure Deployment Option

Step 3: Add Git Remote To Your Local Project

After saving the deployment configuration, Azure will generate a Git URL for you. You can find the Git URL in the "Deployment Center" page.

Azure Git Remote Url

Now, let's add the Git remote to your local project.

git remote add azure <your-git-url>

If your local project is not in a Git repository, you need to initialize a Git repository first by running the following command:

git init

Step 4: Configure Your Local Project

Configure Your Npm Scripts

During the deployment process, Azure will run the npm install command to install the dependencies and then run the npm run build command to build the project. Let's configure the package.json file to make sure that Azure can run these commands.

"name": "evershop",
"version": "1.0.0",
"description": "",
"main": "index.js",
"scripts": {
"build": "evershop build --skip-minify", // Skip the minification process, if you want to minify the code, remove the --skip-minify flag
"start": "evershop start",
"user:create": "evershop user:create",
"user:changePassword": "evershop user:changePassword"
"workspaces": [
"author": "EverShop",
"license": "ISC",
"dependencies": {
"@evershop/evershop": "^1.0.0-rc.8"

Add PM2 Configuration File

Azure uses PM2 to run the Node.js application by default. What we need to do is to add a PM2 configuration file to the root folder of the project. Let's go ahead and create a ecosystem.config.js file with the following content:

module.exports = {
apps: [
name: "evershopAzure",
script: "npm",
env: {
NODE_ENV: "production",
args: "run start",

Adding The Git Ignore File

You local project will look like this:

├── .evershop
├── .log
├── extensions
├── media
├── themes
├── node_modules
├── public
├── .env
├── ecosystem.config.js
├── package.json
├── package-lock.json

We will need to add a .gitignore file to the root folder of the project. This file will tell Git to ignore some files/folders when we push the code to the Azure remote.


Step 5: Configure Environment Variables

EverShop will get the database connection information from the environment variables. So we need to configure the environment variables in the Azure portal.

  1. Go to the "Configuration" page in the Azure portal.

Azure Environment Variable List

  1. Add/Update the following environment variables:

By default, Azure already has some environment variables for the database connection. We need to update the name of these variables to match our database connection information.

Here is the list of environment variables that we need to update the name:


We also need to add 2 more environment variables:

  • DB_SSLMODE: Set the value to require.
  • PORT: Set the value to 3000. This is the port that EverShop will use to start the server.

Azure Configure Environment Variables

Azure Configure Environment Variables

Step 6: Deploy Your Project

We almost finish the configuration. Now, let's deploy the project to Azure.

To trigger the deployment process, we need to push the code to the Azure remote.

git push azure master

On the first deployment, Azure will ask you for the Git credentials. You can find the Git credentials in the "Deployment Center" page.

Azure Git Credentials

This step will take a few minutes to complete. Once the deployment is completed, you can access your site at the URL that Azure provides.

Azure Default Domain

Step 7: Create An Admin User

Now, let's create an admin user for your store.

Back to the npm scripts section, you can see that we have a user:create script. Let's run this script to create an admin user.

In the Azure portal, click SSH to terminal into the server.

Azure SSH

Normally, our project is located in the /home/site/wwwroot folder. Let's go to this folder and run the user:create script.

cd /home/site/wwwroot
npm run user:create -- --email "user email" --password "user password" --name "user name"

Now you can access the admin panel at https://<your-domain>/admin and log in with the admin user that you just created.

Step 8: Configure Custom Domain

By default, Azure will assign a domain to your web app. If you want to use your own domain, you can follow the this document from Azure