You are viewing the legacy version of AdonisJS. Visit for newer docs. This version will receive security patches until the end of 2021.

Nginx proxy

Table of Contents

This recipe shares the minimally required steps to serve AdonisJs app using nginx proxy.

First steps

Before getting started, make sure you can run your application on the defined port. Also, it is recommended to make use of a process manager like pm2 to start your Node.js server.

pm2 start server.js

Verify it is working

pm2 list

To check application logs, you can run the following command

pm2 logs

Nginx proxy

Open the default server configuration file.

# empty the file
echo > /etc/nginx/sites-available/default

# open in editor
vi /etc/nginx/sites-available/default

Moreover, paste the following code inside it.

server {
  listen 80;


  location / {
      proxy_pass http://localhost:3333;
      proxy_http_version 1.1;
      proxy_set_header Upgrade $http_upgrade;
      proxy_set_header Connection 'upgrade';
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-Proto $scheme;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_cache_bypass $http_upgrade;

Points to note

  1. It is assumed that nginx is installed and working as expected.

  2. Your app is running on PORT 3333. If not, then do change proxy_pass block inside the nginx file and define the appropriate port.

  3. Do replace with the actual domain of your app.

  4. Change value of trustProxy to true inside config/app.js file.

Now visiting shows your Adonisjs application, since nginx is proxying all the requests to the application running on a specified port.