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
- Open up a terminal window.
- Download the
jenkinsci/blueocean
image and run it as a container in
Docker using the followingdocker 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
- Open up a command prompt window.
- Download the
jenkinsci/blueocean
image and run it as a container in Docker using the followingdocker 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. - 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:
- 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