1. Jenkins Tutorial
2. Jenkins Download Mac
3. Jenkins Download File To Local Machine
4. How To Install Jenkins
5. Jenkins Download Mac Os
6. Download Jenkins On Local Machine

• Download and restart Jenkins. Go into OSX System Settings/Users, select the jenkins user created by the installer and: Add a secure password to it. All of the next operations are done with your jenkins user, so switch: $ sudo su - jenkins Proceed to install the following.
• Hey guys, in this post will learn about how to download and install Jenkins on Mac. Jenkins is a self-contained, open-source automation server that can be used to automate all sorts of tasks related to building, testing, and delivering or deploying software.

You may be working on a personal project. Maybe your company has a different CI/CD system from what you are used to or it’s hard to be onboarded with the CI/CD system. I’ve come up with a way to create your own personal Jenkins server and agent all in one macOS. The following diagram shows what I am envisioning.

This whole things can easily fit on a laptop or a desktop. Obviously the architecture could be applied to Windows and Linux as well. I have Mac as my main development machine, so I will use Mac as an example here.

Install Docker on Mac

Installing Docker on macOS is very easy.

Jenkins can be installed on Windows, Mac OS X, Ubuntu/Debian, Red Hat/Fedora/CentOS, openSUSE, FReeBSD, OpenBSD, Gentoo. Java Container The WAR (Web Application Resource) file can be run in any container that supports Servlet 2.4/JSP 2.0 or later.

• First, download Docker for Mac from here.
• (Double-)click the downloaded Docker.dmg file.
• Drag and drop the Docker application file to /Applications directory.

• Double-click Docker.app file in /Applications directory.
• You may have to reboot your machine to get the daemon to work correctly.
• Open Terminal.
• Execute docker run -d -p 80:80 docker/getting-started
• Once it’s successful, it means your Docker installation was successful.

One thing to note is that you don’t have to add your account to docker group so you don’t have to sudo for every docker command to execute and docker-compose is bundled with Docker.app on Mac, which is nicer than the installation process on Linux.

Jenkins Master

We will spin up the Jenkins master using docker-compose. Create a directory such as ~/jenkins.

Copy and paste the following contents in docker-compose.yaml file in ~/jenkins.

Execute the following command to create a network for your Docker containers.

After that, execute the following command from at ~/jenkins

When you see the output like the following, you have Jenkins up and running

At this point, you could hit the Jenkins master by navigating your browser to http://localhost:8080 but this is not what I want. I would like to have Dockerized NGINX in front of it and route the traffic to the Jenkins so that it is easy to implement SSL certs for it.

You can Ctrl+C to stop Jenkins and then…

to completely remove the container.

NGINX as Reverse Proxy

As the diagram indicates, my plan is to have NGINX accept HTTP(S) traffic and route the traffic to the Jenkins instance via the Docker’s virtual network.

Please follow the steps below.

Create a directory like ~/nginx

Copy and paste the following YAML to ~/nginx/docker-compose.yaml file and save the file.

Next, create ~/nginx/data directory. While you are there, let’s create conf.d directory.

Copy and paste the following contents to ~/nginx/data/nginx.conf file and save it.

Next, paste the following configuration to ~/nginx/conf.d/ssl.conf file.

SSL Support

Since I’m just planning to run this locally, there isn’t a need for SSL but I would like to implement this for a good practice. And you never know, you may want to create a Jenkins instance in a real environment eventually.

I am planning to make the URL https://jenkins.local

Place the following files for SSL support. If you need to know how to create self-signed cert, please take a look my previous article.

To summarize, here are the files you have to create for NGINX to work in the nginx root directory.

Next, let’s edit /etc/hosts file so that https://jenkins.local will resolve to your local NGINX.

Add the following line in the file.

Now navigate to ~/jenkins and execute the following command.

This starts the instance of Jenkins. Now navigate to ~/nginx and execute the following command.

This starts the instance of NGINX as a reverse proxy that routes the traffic to the containerized Jenkins.

Access Jenkins UI and Initial Configuration

If you open your browser, and navigate it to https://jenkins.local/ you should see the following screen.

Beware that if you try to get the Administrator password from /var/jenkins_home/secrets/initialAdminPassword, your host side does not have the file at that location. Instead, you should cat the file at the following location.

Once you get the admin password from the location, enter it to pass the initial screen to start the containerized Jenkins master.

Connect Jenkins Slave

If you take a look at the UI, you see that the Jenkins master has 2 executors by default. If you want your Mac to run builds, you can do so. Here are the steps.

Navigate to Manage Jenkins -> Manage Nodes and Clouds and then click New Node.

Enter mac for Node name and click Permanent Agent and then click OK.

And click Save on the next screen.

When you go back to Manage Nodes and Clouds, you will see the following screen.

Click mac (or whatever you created) and you will see the following screen.

You can definitely follow the instruction on the screen to connect your mac as a Jenkins slave. First download the agent.jar file from the same page and store it in ~/jenkins-slave directory.

Next execute the following command.

This writes the secret to the secret-file in the directory. And then try to execute the following command to get your mac connected to Jenkins master as a slave.

You would expect that this should be the last step but you would get an error like the following.

This means that Java does not trust the self signed SSL certificate you created. I blogged about this in the past, so please refer to this blog article to resolve this issue.

Once the SSL cert issue is resolved, it connects to Jenkins master and it’s ready like the image below.

Recap

It took me a few nights to write up this article. To recap…

• Dockerizing Jenkins master
• Using NGINX as a reverse proxy
• Implementing SSL cert
• Jenkins slave

This give you an environment where you can manage your own Jenkins in Docker and do whatever you want!

In the last article regarding Jenkins's overview, we discussed the introductory aspects of Jenkins. Now, let's start with the actual practical implementation of Jenkins. As a part of it, firstly, we need to know the installation process of Jenkins on different operating systems based on our needs. Let's start our journey by understanding how to install Jenkins? by covering the details under the following topics:

• What are the pre-requisites for the installation of Jenkins?
  • Hardware Requirements.
  • Software Requirements.
• How to install Jenkins?
  • How to install Jenkins on Windows?
  • And how to install Jenkins on macOS?
  • How to install Jenkins on Linux?

What are the pre-requisites for the installation of Jenkins?

As we all know that before the installation of any tool, we need to check some pre-requisite. So, before the installation of Jenkins, let's understand the pre-requirements needed for Jenkins' successful installation and usage:

Hardware Requirements

The below table lists the minimum hardware requirements, which need to be present on a machine on which we are planning to install the Jenkins:

Jenkins Tutorial

But these are the minimum requirements, which will never suffice when we will be running multiple jobs on Jenkins, so generally following are the minimum recommended hardware configurations, which can work well with a small team:

Jenkins Download Mac

Still, the call out is that these requirements will be different for each team depending on the team's size, the parallel users of Jenkins, and the number of jobs running on the Jenkins server.

Software Requirements

The below table lists the minimum software requirements, which need to be present on a machine on which we are planning to install the Jenkins:

Alright, so after checking the pre-requisite, let's move towards the installation part in the next section.

How to install Jenkins?

So, let's start the installation process of Jenkins. Kindly follow the steps mentioned below:

Step 1: Firstly, go to the official Jenkins website and click on the Download button.

Step 2: Secondly, after clicking on the Download button, we will be redirected to the download page. Additionally, here we can see all the download related information, as shown below:

As we can see, Jenkins produces two releases, one is a stable release, and the other ones are the regular bug fixes, which comes every week. Just below the above section, it lists the latest stable (shown by marker 1 ) and the latest hotfix release (shown by marker 2 ) for all the platforms as shown below:

Step 3: Thirdly, we will see the list of operating systems for which Jenkins is available as an installer. Based on the operating system, we can select the corresponding option. Here, we are going with Generic Java Package(.war)file, a generic file that can set up Jenkins on all the operating systems that have JAVA installed. So click on Generic Java Package(.war) link highlighted in the image below. Consequently, it will download the file.

Step 4: Fourthly, place this jenkins.war file in any directory in your machine. Now open the command prompt and go to that directory and type the below command:

Java –jar jenkins.war

Step 5: Fifthly, after typing the above command, press the Enter key. Wait for some time, and you will see the below screen in which you will get the message like “Jenkins Initial setup is required. An admin user creation completes and a password generates ”.

Copy that password and save it somewhere on your machine. Moreover, kindly note that this password is different for everyone, and this is required to enter only once. Finally, you will see a message indicating, “Jenkins is fully up and running”.

Note: Don't close this terminal window till you are working with Jenkins because we are running Jenkins from the command line, and if we close this, the service will be killed.

However, if we want to run the Jenkins service in the background, use the below command, and the process will keep running even if we close the terminal window.

java –jar Jenkins.war &

Step 6: Now open the browser and navigate to URL: http://localhost:8080/ After that, press the Enter key, and you will see the below page for the first time by default.

7th Step: Here, we need to put that password that we copied from the previous step and click the continue button.

Step 8: As soon as you click on the Continue button, you will be redirected to the page to suggest you install suggested plugins. After that, click on “Install suggested plugins”. Kindly note that if users want to install only selected plugins required, it is recommended to select the option ' Select plugins to install'.

Step 9: After clicking on the suggested plugin button, the standard plugin installation will be started automatically, as displayed in the below screen:

Step 10: Finally, after installation of all suggested plugins, you will be redirected to the User Account Page like below:

Here we need to do the following things:

• Put username, new password that you want to put.
• Put confirm password, full name, email address, and click on the “Save and Continue” button.
• You can choose the option “Skip and continue as Admin” located beside the 'Save and Continue' button, and in this case, you need to put the same password that you put in the previous steps. It is always recommended that you need to put in a new password according to your choice.

Step 11: After clicking on the “Save and Continue Button”, you will be redirected to the instance configuration screen. Here click on the “Save and Finish Button”.

Step 12: After clicking, you will be redirected to a new screen that will display a message like “Jenkins is Ready”. Now click on the “Start using Jenkins” button.

Step 13: After clicking on the “Start using Jenkins ” button, you will be redirected to the Jenkins Dashboard.

Alright, so we successfully installed Jenkins. The above method briefing how to install Jenkins is generic for all the platforms/operating systems. So, no matter which operating system we are planning to install and setup Jenkins, we can download the war file and run it to make Jenkins up and run.

Apart from this generic way, Jenkins also provides installers specific to specific operating systems, which can only install Jenkins on a particular operating system. Let's see a few of them, how we can use the same to install Jenkins on specific platforms/operating systems:

How to install Jenkins on Windows?

As we mentioned above, Jenkins provides installers specific to operating systems also. To install Jenkins on Windows, follow the steps as mentioned below:

1. Firstly, navigate to the Jenkins download page.

2. Secondly, click on the link to download Jenkins for Windows, as highlighted below:

3. Thirdly, clicking on the Windows link will download the 'msi ' installer for Jenkins as shown below:

4. Fourthly, double-click the installer to start the installation of Jenkins; it will show the first screen, as shown below:

5. Fifthly, click on the 'Next ' button to start the installation and specify the path where Jenkins will be installed, as shown below:

6. After that, click on the 'Next ' button and specify the logon type. As we are installing on a local machine, we have selected the option to 'Run service as LocalSyste'. Moreover, you can specify/ mention the domain user name and password if you want to run Jenkins using organization credentials:

7. Seventhly, click on the 'Next ' button and specify the port on which Jenkins will be running:

8. After that, click on the 'Test Port ' button to validate whether the specified port if free on your machine or not. Consequently, if the port is free, it will show a green tick mark as shown below:

9. Ninthly, clicking on the 'Next ' button will check for 'JAVA' on your machine and will ask to install 'JDK ' if the needed version is not available on your machine:

10. Click on the 'Next ' button and Select other services that need to be installed with Jenkins:

11. Click on the 'Install ' button to start the installation of Jenkins:

Jenkins Download File To Local Machine

12. Additionally, clicking on the 'Install ' button will show the progress bar of installation, as shown below:

How To Install Jenkins

13. Once the installation completes, click on the 'Finish' button to complete the installation:

14. Jenkins will be installed as a 'Windows Service'. You can validate the same by browsing the 'services ' section, as shown below:

15. Consequently, once the installation will be done and Jenkins will be up and running, when you browse the link 'http://localhost:8080 ', it will show the initial screen, as shown below:

From here, you can follow the same steps as we did while installing Jenkins with the war file.

How to install Jenkins on macOS?

On macOS, apart from installing and running Jenkins using the generic way of the 'war ' file, we can install Jenkins using the package manager brew. Follow the steps as mentioned below to install Jenkins on macOS:

1. First, navigate to Jenkins download page.

2. Secondly, click on the link to download Jenkins for macOS, as highlighted below:

3. Thirdly, it will list all the brew command needed to install Jenkins, as shown below:

4. Consequently, to install Jenkins on macOS, execute the following command on the terminal:

brew install jenkins-lts

5. Fifthly, executing the above command will show the output, as shown below:

6. Sixthly, once the installation completes, you can start Jenkins as a service by typing the following command:

>brew services start jenkins-lts

7. After that, it will start Jenkins as a service and will show the output as shown below:

Jenkins Download Mac Os

8. After the installation completes and Jenkins will be up and running when you browse the link 'http://localhost:8080 ', it will show the initial screen, as shown below:

From here, you can follow the same steps as we did while installing Jenkins with the war file.

How to install Jenkins on Linux?

Installation on Linux depends on which flavor of Linux you are using. Depending on the types of Linux, you can use the wget package manager to download Jenkins, as per the steps mentioned below:

Download Jenkins On Local Machine

1. First, navigate to Jenkins download page.

2. Secondly, click on the link to download Jenkins for Linus, as per the flavor (such as Ubuntu, Centos, etc.), as highlighted below:

3. Thirdly, suppose we click on the Ubuntu option, it will list all the commands to install Jenkins, as shown below:

4. Fourthly, type the above-mentioned commands on the terminal one by one, as follows:// Download Jenkins packagewget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -

//Add the following entry in your /etc/apt/sources.list:deb https://pkg.jenkins.io/debian-stable binary/

// Update Local Packagesudo apt-get update

// Install Jenkinssudo apt-get install jenkins

5. Finally, once the installation will be done, Jenkins will be up and running when you browse the link 'http://localhost:8080'.

Additionally, we can either use the common way of running the 'war' file on all the platforms or use the corresponding installers as per the platform/operating system's choice to install Jenkins successfully.

Key Takeaways:

• Before installing Jenkins, kindly check the hardware as well as software requirements mentioned in the above sections.
• Additionally, on the Jenkins' download page, download the Jenkins.war file, and we can use this WAR file to run Jenkins on any OS.
• Lastly, if we want to download installers for specific operating systems, we need to go to Jenkins's download page and then download and install the respective installers according to your OS.