Configuring the Nginx Server

Nginx is a Web server and reverse proxy used by the IzoT Server, IzoT example Web pages, and may be used for your custom Web pages. It is configured by the $IZOT/etc/nginx/izot file.

Most of the Nginx configuration for the IzoT Server should not be changed. The following is an example of some entries that may be reconfigured:

server {
    # listen on HTTP port(s) (this is the default server)
    # NOTE: Only use non-SSL ports for debugging!
    listen      80 default_server;
    listen             [::]:80 default_server ipv6only=on;
    # listen on IPv4 HTTPS port (using a self-signed certificate)
    listen      443 ssl;
    # SSL information
    ssl_certificate         /etc/nginx/server.crt;
    ssl_certificate_key     /etc/nginx/server.key;
    # redirect server error pages to the static page /50x.html
    error_page 500 502 503 504 /50x.html;
    #location = /50x.html {
    #    root /usr/share/nginx/www;
    #}
    # enable debug logging
    #error_log /var/log/nginx/debug.log debug;
}

where:

 
Setting Description
listen Specifies an address and port for the Nginx Server to listen on. By default, the IzoT Server will be served on the default HTTP (80) (for both IPv4 and IPv6) and HTTPS (443) ports.

The use of the non-SSL ports is not secure. They are typically only used during development or for servers behind firewalls.
ssl_certificate
ssl_certificate_key
The path to an SSL certificate and private key for use by HTTPS. By default, a self-generated certificate and key will be used. This can be replaced by an official certificate and key.
error_page Allows error pages to be customized.
error_log Enables and configures Nginx Server error logging.

 

For further details on these and other settings, see the Supervisor Documentation.