Skip to content

Linux Web UI HTTPS with Let's Encrypt certificates and NGINX SSL reverse proxy

Francisco Pombal edited this page Jun 10, 2018 · 2 revisions


This is probably the easiest, most extensible and trouble-free way of setting up qBittorrent's WebUI with SSL. It combines ideas from these other articles of the wiki: 1, 2.

The benefit of this setup is that with one single domain and certificate you are able to setup secure HTTPS access to various different services in your server alongside one another. For example, you may have qBittorrent's WebUI accessible at, a simple homepage served with Apache at, your Nextcloud instance at, etc.

This guide assumes you have a working qbitorrent-nox setup (check this article if you haven't). This guide also assumes that:

  • you know how to and can forward ports on your router.
  • you have setup a DNS pointing to the IP you are running the Web UI from (you can use a free one like Duck DNS).

The overall architecture of the system will be:

Outside world (insecure)         |   Your machine (secure)                      |
You <-------HTTPS (secure)-------|->  NGINX <----HTTP-----> qbittorrent WebUI   |
                                 |                                              |

Install the prerequisites

Install certbot

certbot is the recommended ACME client for requesting and managing Let's Encrypt certificates. It is available on the official Ubuntu repositories, but there is an official PPA always updated with the most recent stable version, so that is the one to install. You will also need the nginx plugin.

sudo apt update && sudo apt upgrade -y # first update all packages in the system
sudo add-apt-repository ppa:certbot/certbot
sudo apt update
sudo apt install certbot 
sudo apt install python-certbot-nginx # this is needed for the nginx plugin

Install nginx

You can use the version on the repositories, but if you want the most recent version you can use the PPA.

sudo apt update && sudo apt upgrade -y # first update all packages in the system
sudo add-apt-repository ppa:nginx/stable
sudo apt update
sudo apt install nginx


Setup the Web UI

  1. Access your WebUI, and go to Tools -> Options -> WebUI
  2. Change the following settings if they are not already like so:
  • Server domains:
  • Port: some free port on your system that is NOT accessible through the outside world. In this case we will use 30000
  • Use UPnP / NAT-PMP to forward the port from my router: unchecked.
  • Use HTTPS instead of HTTP: unchecked.

Set up NGINX

  1. Forward ports 80 and 443 in your router, and let the them through your firewall. If you have ufw as your system firewall, it is as simple as sudo ufw allow 80 && sudo ufw allow 443 && sudo ufw reload

  2. Clear the default files

sudo rm /etc/nginx/sites-available/*
sudo rm /etc/nginx/sites-enabled/*
  1. Stop the nginx if it is running sudo systemctl stop nginx.service

  2. Create a config file for your reverse proxy

sudo touch /etc/nginx/sites-available/yoursite
cd /etc/nginx/sites-enabled/
sudo ln -s /etc/nginx/sites-available/yoursite yoursite 
  1. Open the file with your favourite text editor and paste something like the following (read the comments, which start with # to know what you have to change):
# change "" and similar to your actual domain
server {
    listen 80;
    listen [::]:80;
    return 301$request_uri;

server {
    listen 443;

    # at this point we haven't created the certificate yet, but that's ok.
    # if, when creating the certificate (see below) it goes to another folder, be sure
    # to change these lines accordingly
    ssl_certificate           /etc/letsencrypt/live/;
    ssl_certificate_key       /etc/letsencrypt/live/;

    ssl on;
    ssl_session_cache  builtin:1000  shared:SSL:10m;
    ssl_protocols  TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers HIGH:!aNULL:!eNULL:!EXPORT:!CAMELLIA:!DES:!MD5:!PSK:!RC4;
    ssl_prefer_server_ciphers on;
    ssl_stapling on;
    ssl_stapling_verify on;

    access_log            /var/log/nginx/yourdomain.access.log;

    location /qbt/ {
        # you can use any other port other than 30000 as long as it is available on your system
        proxy_pass    ;
        proxy_set_header        X-Forwarded-Host            $server_name:$server_port;
        proxy_hide_header       Referer;
        proxy_hide_header       Origin;
        proxy_set_header        Referer                     '';
        proxy_set_header        Origin                      '';
        add_header              X-Frame-Options             "SAMEORIGIN"; # see note

    # OPTIONAL: you can have a simple webpage, for example, served at the root of the domain (more below)
    #location / {
        # you can use any other port other than 8080 as long as it is available on your system
        #proxy_pass    ;
        #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_set_header        X-Forwarded-Proto           $scheme;

    # you can add more "location { (...) }" stanzas for other services, such as Nextcloud, etc

Obtain the certificate

Run the following commands to obtain your certificate (replace with your actual domain):

sudo certbot --nginx certonly --preferred-challenges http --must-staple --redirect --hsts --uir --staple-ocsp --rsa-key-size 4096 --domain --domain

Take note of the location where certbot stored the certificate, and adjust the nginx configuration file if needed. If your certbot is setup correctly, it will renew your certificate automatically, so you do not need to worry. You can manually test the renewal process with sudo certbot renew --dry-run, or actually manually renew your certificates with sudo certbot renew .

Note: the following five options used above are optional, but good for hardened security:

  • --rsa-key-size 4096
  • --must-staple
  • --redirect
  • --hsts
  • --uir
  • --staple-ocsp

Refer to the documentation for more info.

Test your setup

Start nginx: sudo systemctl restart nginx.service

Access your WebUI via You should see the qbittorrent Web UI and the indication that your connection is over HTTPS.

OPTIONAL: foundation for interoperability with other services

As stated before, you can add more "location { (...) }" stanzas to your nginx config file to enable access to other services.

Example for a simple homepage with Apache:

  1. In the nginx config example above, you can uncomment the location "/" { ... stanza to have a homepage accessible at

  2. Create a simple "hellow world" HTML file, index.html under /var/www/html

  3. Create an apache config for yout page (at /etc/apache2/sites-available), which can be as simple as:

<VirtualHost *:8080>
    DocumentRoot /var/www/html

    ErrorLog ${APACHE_LOG_DIR}/error-homepage.log
    CustomLog ${APACHE_LOG_DIR}/access-homepage.log combined

Don't forget to create the symbolic link at /etc/apache2/sites-enabled.

  1. Restart nginx and apache. You should now have:
  • A simple homepage, at
  • qBittorrent WebUI at
Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.