Installing kTBS behind an Nginx HTTP server¶

Nginx can be used as a proxy in front of a running instance of kTBS. This has a number of advantages:

adds HTTPS support;
allows kTBS to co-exist with other services under the same domain name and port number;
allows to add access control (not documented yet).

kTBS configuration¶

kTBS must first be installed and run independently, listening on a local port. It must also be aware of the public URI under which it is published (in the example above: https://your.domain.com/path/to/ktbs/). This is achieved with the following configuration directives:

[server]
scheme = http
host-name = localhost
port = 8002

fixed-root-uri = https://your.domain.com/path/to/ktbs/

Nginx configuration¶

Here is an example Nginx configuration file:

server {
        server_name your.domain.com;
        listen 443;
        ssl on;
        # ... other parameters

        location /path/to/ktbs {
            proxy_pass http://localhost:8002/;
        }
}