Select Page


Via default, Jenkins comes with its personal integrated Winstone internet server listening on port 8080, which is handy for purchasing began. It is also a good suggestion, on the other hand, to protected Jenkins with SSL to give protection to passwords and delicate information transmitted during the internet interface.

On this educational, you’ll configure Nginx as a opposite proxy to direct consumer requests to Jenkins.

Must haves

To start, you can want the next:

Step 1 — Configuring Nginx

Within the prerequisite educational How to Secure Nginx with Let’s Encrypt on Ubuntu 18.04, you configured Nginx to make use of SSL within the /and so on/nginx/sites-available/ report. Open this report so as to add your opposite proxy settings:

  • sudo nano /and so on/nginx/sites-available/

Within the server block with the SSL configuration settings, upload Jenkins-specific get right of entry to and mistake logs:

/and so on/nginx/sites-available/

. . . 
server {
        . . .
        # SSL Configuration
        concentrate [::]:443 ssl ipv6only=on; # controlled by means of Certbot
        concentrate 443 ssl; # controlled by means of Certbot
        access_log            /var/log/nginx/jenkins.get right of entry to.log;
        error_log             /var/log/nginx/jenkins.error.log;
        . . .

Subsequent let’s configure the proxy settings. Since we are sending all requests to Jenkins, we’re going to remark out the default try_files line, which might in a different way go back a 404 error ahead of the request reaches Jenkins:

/and so on/nginx/sites-available/

. . .
           location / {
                # First try to serve request as report, then
                # as listing, then fall again to showing a 404.
                # try_files $uri $uri/ =404;        }
. . . 

Let’s now upload the proxy settings, which come with:

  • proxy_params: The /and so on/nginx/proxy_params report is provided by means of Nginx and guarantees that essential data, together with the hostname, the protocol of the buyer request, and the buyer IP deal with, is retained and out there within the log information.
  • proxy_pass: This units the protocol and deal with of the proxied server, which on this case would be the Jenkins server accessed by means of localhost on port 8080.
  • proxy_read_timeout: This allows an build up from Nginx’s 60 2d default to the Jenkins-recommended 90 2d worth.
  • proxy_redirect: This guarantees that responses are correctly rewritten to incorporate the right kind host identify.

Remember to change your SSL-secured area identify for within the proxy_redirect line underneath:

/and so on/nginx/sites-available/

Location /  
. . .
           location / {
                # First try to serve request as report, then
                # as listing, then fall again to showing a 404.
                # try_files $uri $uri/ =404;
                come with /and so on/nginx/proxy_params;
                proxy_pass          http://localhost:8080;
                proxy_read_timeout  90s;
                # Repair possible "It appears that your reverse proxy setup is broken" error.
                proxy_redirect      http://localhost:8080;

As soon as you have made those adjustments, save the report and go out the editor. We will grasp off on restarting Nginx till when we’ve configured Jenkins, however we will take a look at our configuration now:

If all is easily, the command will go back:


nginx: the configuration report /and so on/nginx/nginx.conf syntax is fine nginx: configuration report /and so on/nginx/nginx.conf take a look at is a success

If no longer, repair any reported mistakes till the take a look at passes.

Be aware:
In the event you misconfigure the proxy_pass (by means of including a trailing slash, for instance), you’ll get one thing very similar to the next on your Jenkins Configuration web page.

Jenkins error: Reverse proxy set up is broken

In the event you see this mistake, double-check your proxy_pass and proxy_redirect settings within the Nginx configuration.

Step 2 — Configuring Jenkins

For Jenkins to paintings with Nginx, it is very important replace the Jenkins configuration in order that the Jenkins server listens most effective at the localhost interface somewhat than on all interfaces ( If Jenkins listens on all interfaces, it is probably available on its unique, unencrypted port (8080).

Let’s regulate the /and so on/default/jenkins configuration report to make those changes:

  • sudo nano /and so on/default/jenkins

Find the JENKINS_ARGS line and upload --httpListenAddress= to the prevailing arguments:

/and so on/default/jenkins

. . .
JENKINS_ARGS="--webroot=/var/cache/$NAME/warfare --httpPort=$HTTP_PORT --httpListenAddress="

Save and go out the report.

To make use of the brand new configuration settings, restart Jenkins:

  • sudo systemctl restart jenkins

Since systemctl does not show output, verify the standing:

  • sudo systemctl standing jenkins

You must see the energetic (exited) standing within the Energetic line:


● jenkins.provider - LSB: Get started Jenkins at boot time Loaded: loaded (/and so on/init.d/jenkins; generated) Energetic: energetic (exited) since Mon 2018-07-09 20:26:25 UTC; 11s in the past Medical doctors: guy:systemd-sysv-generator(8) Procedure: 29766 ExecStop=/and so on/init.d/jenkins quit (code=exited, standing=0/SUCCESS) Procedure: 29812 ExecStart=/and so on/init.d/jenkins delivery (code=exited, standing=0/SUCCESS)

Restart Nginx:

  • sudo systemctl restart nginx

Take a look at the standing:

  • sudo systemctl standing nginx


● nginx.provider - A top efficiency internet server and a opposite proxy server Loaded: loaded (/lib/systemd/machine/nginx.provider; enabled; seller preset: enabled) Energetic: energetic (operating) since Mon 2018-07-09 20:27:23 UTC; 31s in the past Medical doctors: guy:nginx(8) Procedure: 29951 ExecStop=/sbin/start-stop-daemon --quiet --stop --retry QUIT/5 --pidfile /run/ (code=exited, standing=0/SUCCESS) Procedure: 29963 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, standing=0/SUCCESS) Procedure: 29952 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, standing=0/SUCCESS) Primary PID: 29967 (nginx)

With each servers restarted, you must be capable of talk over with the area the use of both HTTP or HTTPS. HTTP requests can be redirected mechanically to HTTPS, and the Jenkins website can be served securely.

Step 3 — Checking out the Configuration

Now that you’ve got enabled encryption, you’ll be able to take a look at the configuration by means of resetting the executive password. Let’s delivery by means of visiting the website by means of HTTP to ensure that you’ll be able to succeed in Jenkins and are redirected to HTTPS.

For your internet browser, input, substituting your area for After you press ENTER, the URL must delivery with https and the positioning bar must point out that the relationship is protected.

You’ll input the executive username you created in How To Install Jenkins on Ubuntu 18.04 within the Person box, and the password that you just decided on within the Password box.

As soon as logged in, you’ll be able to alternate the password to make sure it is protected.

Click on to your username within the upper-right-hand nook of the display screen. At the primary profile web page, make a selection Configure from the checklist at the left facet of the web page:

Navigate to Jenkins password page

This may take you to a brand new web page, the place you’ll be able to input and ensure a brand new password:

Jenkins create password page

Verify the brand new password by means of clicking Save. You’ll now use the Jenkins internet interface securely.


On this educational, you configured Nginx as a opposite proxy to Jenkins’ integrated internet server to protected your credentials and different data transmitted by means of the internet interface. Now that Jenkins is protected, you’ll be able to be informed how to set up a continuous integration pipeline to mechanically take a look at code adjustments. Different assets to imagine if you’re new to Jenkins are the Jenkins project’s “Creating your first Pipeline” educational or the library of community-contributed plugins.