How To Configure Nginx with SSL as a Reverse Proxy for Jenkins

If you want to use Jenkins behind a reverse proxy with SSL, you can use Nginx as a reverse proxy. This tutorial will guide you through the steps to configure Nginx with SSL as a reverse proxy for Jenkins.

Step 1: Install Nginx

You can install Nginx on your server using the following command:

sudo apt-get update
sudo apt-get install nginx

Step 2: Generate SSL Certificate

You need to generate an SSL certificate to use SSL with Nginx. You can use the following command to generate a self-signed SSL certificate:

sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/ssl/private/nginx-selfsigned.key -out /etc/ssl/certs/nginx-selfsigned.crt

Step 3: Configure Nginx

Edit the Nginx configuration file /etc/nginx/sites-available/default using the following command:

sudo nano /etc/nginx/sites-available/default

Replace the contents of the file with the following configuration:

server {
    listen 80;
    server_name jenkins.example.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl;
    server_name jenkins.example.com;

    ssl_certificate /etc/ssl/certs/nginx-selfsigned.crt;
    ssl_certificate_key /etc/ssl/private/nginx-selfsigned.key;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

Replace jenkins.example.com with your domain name or IP address.

Step 4: Test Configuration and Restart Nginx

Test the Nginx configuration using the following command:

sudo nginx -t

If the configuration is valid, restart Nginx using the following command:

sudo systemctl restart nginx

You should now be able to access Jenkins using SSL through Nginx.

Conclusion

Configuring Nginx with SSL as a reverse proxy for Jenkins is a simple and effective way to secure your Jenkins installation. By following the steps outlined in this tutorial, you can easily set up a secure reverse proxy for Jenkins.

Keywords: nginx, SSL, reverse proxy, Jenkins, configuration, self-signed SSL certificate, proxy_pass, proxy_set_header, domain name, IP address.