references/server/nginx_webserver/nginx.md

Nginx

Install

apt install nginx

Make the site directory, and index

`mkdir /var/www/' 'touch /var/www//index.html'

Git

If you're using git VC for the website then after making the directory just git clone <repo> and checkout the appropriate release/branch.

Make a config

vim /etc/nginx/sites-available/<website>

Basic config

server { listen 80 ; listen [::]:80 ; server_name <domain>, www.<domain> ; root /var/www/<website> ; index index.html index.htm ; location / { try_files $uri $uri/ =404 ; } }

Basic description of above:

listen - listen to port 80 on ipv4 and ipv6 server_name - the website/url that someone connecting to the server is looking for root - directory for the website (commonly kept in /var/www/<websitename> index - the default file to load when connecting to the site. In order of desc priority location - how the server should lookup files, if these aren't met throw a 404 error

Example Configs

Some examples can be found on nginx's site here

Enable the site

This uses the config we build, by creating a symbolic link to it. ln -s /etc/nginx/sites-available/<website> /etc/nginx/sites-enabled/<website>

Restart nginx

sudo systemctl reload nginx Using reload will not restart the service if a config is incorrect, so this is generally safer, especially in a working environment.

Allow http traffic

If you've not got a firewall installed, this can be ignored. If you do, for example after installing adar's _base you're going to want to allow traffic.

Http ufw allow 80 Https (recommended, all sites need SSL these days) ufw allow 443

WIP

Internal address

Edit /etc/hosts line 127.0.0.1 localhost to 127.0.0.1 \*.localhost Edit .../sites-available/<website> server_name and add

,localhost