A short guide of commands I've found myself using on Ubuntu for NGINX, I'll update this post as I find more.

Installing NGINX

sudo apt-get update

sudo apt-get install nginx

Restarting NGINX

To restart NGINX

sudo systemctl restart nginx

To just reload the NGINX

nginx -s reload

This will reload the NGINX config and any changes you make to it.

NGINX Config

A Sample Config for one of my static sites.

server {
  listen 80;

  listen [::]:80;

  root /var/www/jameskenny.co;

  index index.html;

  server_name jameskenny.io www.jameskenny.io;

  location / {
    try_files $uri $uri/ =404;
  }
}

A sample config of a reverse proxy for a docker container.

server {
  listen 80;

  listen [::]:80;

  server_name touroperator.io www.touroperator.io;

   set $upstream 127.0.0.1:8080;

 location / {
 
 proxy_pass_header Authorization;
 proxy_pass http://$upstream;
 proxy_set_header Host $host;
 proxy_set_header X-Real-IP $remote_addr;
 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
 proxy_http_version 1.1;
 proxy_set_header Connection "";
 proxy_buffering off;
 client_max_body_size 0;
 proxy_read_timeout 36000s;
 proxy_redirect off;

 }
}

I wanted to host my own personal site https://jameskenny.io on a Linode Linux server and run NGINX to host the static site.

I've used Linode before and really recommend them. Also will be doing some work with hosting docker containers. Over the next few blog posts I'll go into the details of how to do it.

Linode

Linode are a hosting company that offer Linux hosts with SSD hard drives. Linode offers some great management systems. It's quick and easy to start a server.

I create a new Linode a Linode 1GB in Frankfurt, Germany. This server will cost $5 a month. Not bad for my own site and a few other test ideas. I deployed with Ubuntu Linux.

Once it's deployed we go ahead and ssh onto the server.

Install NGINX

So on our Ubuntu Linux, we first run

sudo apt-get update

sudo apt-get install nginx

NGINX is now installed.

Setting up our site

My site is just a simple HTML page wiht some css behind it.

By default, NGINX expects your static files to be in a specific directory. You can override this in the configuration. But for what I'm doing the defaults are ok.

/var/www/

So I go ahead and create a new folder jameskenny.io and upload my files.

/var/www/jameskenny.io

Configure NGINX to serve the website

Next we need to setup the config on the NGINX to serve the sites.

/etc/nginx/

We're interested in two folders here.

• sites-available this contains individual configuration files for all of your possible static websites.
• sites-enabled this contains links to the configuration files that NGINX will actually read and run.

So in our 'sites-available' folder we create a new config file called

jameskenny.io

server {
  listen 80;
  
  listen [::]:80;
  
  root /var/www/jameskenny.io;
  
  index index.html;
  
  server_name jameskenny.io www.jameskenny.io;
  
  location / {
    try_files $uri $uri/ =404;
  }
}

Make sure to replace the jameskenny.io with your domain and folder path.

This file tells NGINX a few things:

• Listen to any traffic on port 80
• Deliver files from the folder /var/www/jameskenny.io
• The main index page is called index.html.
• Requests that are requesting jameskenny.io should be served by this server block.
• Note the www is also listed separately. This tells nginx to also route requests starting with www to the site. There’s actually nothing special about the www — it’s treated like any other subdomain but you can see how you can use this for other subdomains very quickly.

Next we need to create a short cut in our sites-enabled folder. In our SSH shell we run the command.

ln -s /etc/nginx/sites-available/jameskenny.io /etc/nginx/sites-enabled/jameskenny.io

This will create a shortcut pointing to our config to tell NGINX to server our site.

Now we restart NGINX to load it all up ok.

sudo systemctl restart nginx

Just point your A record to your new server and go check out your site.