Installing Jenkins

The procedures on this page are for new installations of Jenkins on a single/local machine.

Jenkins is typically run as a standalone application in its own process with the built-in Java servlet container/application server (Jetty).

Jenkins can also be run as a servlet in different Java servlet containers such as Apache Tomcat or GlassFish. However, instructions for setting up these types of installations are beyond the scope of this page.

Note: Although this page focusses on local installations of Jenkins, this content can also be used to help set up Jenkins in production environments.

Prerequisites

Minimum hardware requirements:

• 256 MB of RAM
• 1 GB of drive space (although 10 GB is a recommended minimum if running Jenkins as a Docker container)

Recommended hardware configuration for a small team:

• 1 GB+ of RAM
• 50 GB+ of drive space

Sofware requirements:

• Java 8 - either a Java Runtime Environment (JRE) or a Java Development Kit (JDK) is fine
  Note: This is not a requirement if running Jenkins as a Docker container.

On macOS and Linux

1. Open up a terminal window.
2. Download the jenkinsci/blueocean image and run it as a container in
   Docker using the following docker run command:

   docker run \
     -u root \
     --rm \  
     -d \ 
     -p 8080:8080 \ 
     -v jenkins-data:/var/jenkins_home \ 
     -v /var/run/docker.sock:/var/run/docker.sock \
     jenkinsci/blueocean 

   On Windows

1. Open up a command prompt window.
2. Download the jenkinsci/blueocean image and run it as a container in Docker using the following docker run command:

   docker run ^
     -u root ^
     --rm ^
     -d ^
     -p 8080:8080 ^
     -v jenkins-data:/var/jenkins_home ^
     -v /var/run/docker.sock:/var/run/docker.sock ^
     jenkinsci/blueocean

   For an explanation of each of these options, refer to the macOS and Linux instructions above.
3. Proceed to the Post-installation setup wizard.

Accessing the Jenkins/Blue Ocean Docker container

If you have some experience with Docker and you wish or need to access the jenkinsci/blueocean container through a terminal/command prompt using the docker exec command, you can add an option like --name jenkins-blueocean (with the docker run above), which would give the jenkinsci/blueocean container the name "jenkins-blueocean".

This means you could access the container (through a separate terminal/command prompt window) with a docker exec command like:

docker exec -it jenkins-blueocean bash

macOS

To install from the website, using a package:

• Download the latest package
• Open the package and follow the instructions

Jenkins can also be installed using brew:

• Install the latest release version

brew install Jenkins

• Install the LTS version

brew install jenkins-lts