This section describes how to install Jenkins on a machine that does not have an internet connection.
To install Jenkins itself, download the appropriate war file and transfer it to your machine.
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:
4 GB+ of RAM
50 GB+ of drive space
Comprehensive hardware recommendations:
Hardware: see the Hardware Recommendations page
Software requirements:
Java 21 or later: see the Java Requirements page
Web browser: see the Web Browser Compatibility page
For Windows operating system: Windows Support Policy
For Linux operating system: Linux Support Policy
For servlet containers: Servlet Container Support Policy
Offline plugin installations require additional effort due to dependency requirements.
The Plugin Installation Manager Tool is the recommended tool for offline plugin installation. It downloads user specified plugins and all dependencies of the user specified plugins. The Plugin Installation Manager Tool also reports available plugin updates and plugin security warnings. It is included in the official Jenkins Docker images. It is also used to install plugins as part of the Docker install instructions. Refer to the Gitter chat channel for questions and answers
If you want to transfer the individual plugins, you’ll need to retrieve all dependencies as well. There are several dependency retrieval scripts and tools on Github. For example:
Plugin installation manager tool - Java command line utility to install Jenkins plugins and their dependencies.
samrocketman/jenkins-bootstrap-shared - Java is required; packages Jenkins and plugins into an immutable package installer. Supported formats include: RPM, DEB, Docker. Can proxy Jenkins and plugins through Nexus or Artifactory since Gradle is used to assemble plugins.
After installing Jenkins offline, the post-installation setup wizard begins.
When you first access a new Jenkins controller, you are asked to unlock it using an automatically-generated password.
Browse to http://localhost:8080 and wait until the Unlock Jenkins page appears.
From the Jenkins console log output, copy the automatically generated alphanumeric password (between the 2 sets of asterisks).
On the Unlock Jenkins page, paste this password into the Administrator password field and click Continue.
The initial admin password can be found at /var/lib/jenkins/secrets/initialAdminPassword. Run sudo cat /var/lib/jenkins/secrets/initialAdminPassword to print it in the console.
|
After unlocking Jenkins, the Customize Jenkins page appears.
| Because this is an offline installation, Jenkins cannot download plugins. To skip plugin installation during setup: |
Click Select plugins to install.
Click None to deselect all suggested plugins.
Click Install to proceed without downloading plugins.
You can use one of the techniques described in offline plugin installation to install plugins.
Please submit your feedback about this page through this quick form.
Alternatively, if you don't wish to complete the quick form, you can simply indicate if you found this page helpful?
See existing feedback here.