Setting up HTTPS with LetsEncrypt for Redash Docker Deployment

README.md

1. Make sure the domain you picked points at the IP of your Redash server.
2. Switch to the root user (sudo su).
3. Create a folder named nginx in /opt/redash.
4. Create in the nginx folder two additional folders: certs and certs-data.
5. Create the file /opt/redash/nginx/nginx.conf and place the following in it: (replace example.redashapp.com with your domain name)

   upstream redash {
       server server:5000;
   }
   
   server {
       listen      80;
       listen [::]:80;
       server_name example.redashapp.com;
   
       location ^~ /ping {
           proxy_set_header Host $http_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 $http_x_forwarded_proto;
   
           proxy_pass       http://redash;
       }
   
       location / {
           rewrite ^ https://$host$request_uri? permanent;
       }
   
       location ^~ /.well-known {
           allow all;
           root  /data/letsencrypt/;
       }
   }
   

6. Edit /opt/redash/docker-compose.yml and update the nginx service to look like the following:

   nginx:
    image: nginx:latest
    ports:
      - "80:80"
      - "443:443"
    depends_on:
      - server
    links:
      - server:redash
    volumes:
      - /opt/redash/nginx/nginx.conf:/etc/nginx/conf.d/default.conf
      - /opt/redash/nginx/certs:/etc/letsencrypt
      - /opt/redash/nginx/certs-data:/data/letsencrypt
    restart: always
   

7. Update Docker Compose: docker compose up -d.
8. Generate certificates: (remember to change the domain name)

   docker run -it --rm \
      -v /opt/redash/nginx/certs:/etc/letsencrypt \
      -v /opt/redash/nginx/certs-data:/data/letsencrypt \
      deliverous/certbot \
      certonly \
      --webroot --webroot-path=/data/letsencrypt \
      -d example.redashapp.com
   

9. Assuming the previous step was succesful, update the nginx config to include the SSL configuration:

   upstream redash {
       server redash:5000;
   }
   
   server {
       listen      80;
       listen [::]:80;
       server_name example.redashapp.com;
   
       location ^~ /ping {
           proxy_set_header Host $http_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;
   
           proxy_pass       http://redash;
       }
   
       location / {
           rewrite ^ https://$host$request_uri? permanent;
       }
   
       location ^~ /.well-known {
           allow all;
           root  /data/letsencrypt/;
       }
   }
   
   server {
    listen      443           ssl http2;
    listen [::]:443           ssl http2;
    server_name               example.redashapp.com;
   
    add_header                Strict-Transport-Security "max-age=31536000" always;
   
    ssl_session_cache         shared:SSL:20m;
    ssl_session_timeout       10m;
   
    ssl_protocols             TLSv1 TLSv1.1 TLSv1.2;
    ssl_prefer_server_ciphers on;
    ssl_ciphers               "ECDH+AESGCM:ECDH+AES256:ECDH+AES128:!ADH:!AECDH:!MD5;";
   
    ssl_stapling              on;
    ssl_stapling_verify       on;
    resolver                  8.8.8.8 8.8.4.4;
   
    ssl_certificate           /etc/letsencrypt/live/example.redashapp.com/fullchain.pem;
    ssl_certificate_key       /etc/letsencrypt/live/example.redashapp.com/privkey.pem;
    ssl_trusted_certificate   /etc/letsencrypt/live/example.redashapp.com/chain.pem;
   
    access_log                /dev/stdout;
    error_log                 /dev/stderr info;
   
    # other configs
   
    location / {
        proxy_set_header Host $http_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;
   
        proxy_pass       http://redash;
    }
   }    
   

10. Restart nginx: docker compose restart nginx.
11. All done, your Redash instance should be available via HTTPS now. 👏

To renew the certificate in the future, you can use the following command:

$ docker run -t --rm -v /opt/redash/nginx/certs:/etc/letsencrypt \ 
                     -v /opt/redash/nginx/certs-data:/data/letsencrypt \ 
                     deliverous/certbot renew --webroot --webroot-path=/data/letsencrypt

$ docker-compose kill -s HUP nginx