NGINX Configuration

NGINX Configuration

When using NGINX as a reverse proxy, there are a few extra things to take care of

1. Extend the file upload limit (default NGINX limit seems to be 1MB)
2. Enable HTTP 1.1

Enabling HTTP 1.1

NGINX will use HTTP 1.0 by default. However, Recogito needs support for chunked responses which is only supported in HTTP 1.1. (This is used specifically for fetching CSV data in the table view.)

Add proxy_http_version 1.1; to the site configuration.

Port Forwarding Configuration

Example site configuration:

server {
    listen 80;
    
    location /recogito {
        proxy_pass http://127.0.0.1:9001;
    }

    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_redirect     off;

        proxy_set_header   Host             $host;
        proxy_set_header   X-Real-IP        $remote_addr;
        proxy_set_header   X-Forwarded-For  $proxy_add_x_forwarded_for;

        client_max_body_size       500m;
        client_body_buffer_size    128k;

        proxy_connect_timeout      90;
        proxy_send_timeout         90;
        proxy_read_timeout         90;

        proxy_buffer_size          4k;
        proxy_buffers              4 32k;
        proxy_busy_buffers_size    64k;
        proxy_temp_file_write_size 64k;
    }

}

Extending the file upload limit

To set the limit globally, add the line client_max_body_size 200M; to the http section of the nginx.conf file.

To set it for Recogito specifically (recommended), add client_max_body_size 200M; to the server or location part of the site configuration.