Introduction of Jenkins and Steps to Install 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".