{"id":9600,"date":"2024-10-27T19:35:53","date_gmt":"2024-10-27T19:35:53","guid":{"rendered":"https:\/\/www.webhi.com\/how-to\/?p=9600"},"modified":"2024-10-27T19:35:55","modified_gmt":"2024-10-27T19:35:55","slug":"guide-to-install-and-configure-jenkins","status":"publish","type":"post","link":"https:\/\/www.webhi.com\/how-to\/guide-to-install-and-configure-jenkins\/","title":{"rendered":"Guide to Install and Configure Jenkins"},"content":{"rendered":"\n
\"Jenkins<\/figure>\n\n\n\n

Introduction to Jenkins<\/strong><\/h3>\n\n\n\n

Jenkins is a popular open-source automation server used for orchestrating software builds, testing, and deployment. It supports a variety of plugins that enhance its functionality, making it one of the go-to tools for automating almost any part of the software development lifecycle. Jenkins\u2019 extensibility, combined with its active community, has made it a staple in DevOps toolchains.<\/p>\n\n\n\n

Understanding how to install and configure Jenkins is vital for anyone involved in DevOps or development. This guide will walk you through the installation process, configuring Jenkins for your environment, and setting up your first Jenkins job.<\/p>\n\n\n\n

Prerequisites<\/strong><\/h3>\n\n\n\n

Before diving into the Jenkins installation process, ensure you have the following:<\/p>\n\n\n\n

    \n
  1. A Linux Server<\/strong>: Jenkins works best on a Unix-based system, but it can also run on Windows. In this guide, we will focus on Ubuntu\/Debian-based distributions.<\/li>\n\n\n\n
  2. Java Installed<\/strong>: Jenkins runs on Java, so you need to ensure Java is installed. Jenkins requires either Java 8 or 11.<\/li>\n\n\n\n
  3. Root or sudo Access<\/strong>: You will need root or sudo privileges to install packages and configure Jenkins on your server.<\/li>\n<\/ol>\n\n\n\n

    Installing Jenkins on Ubuntu<\/strong><\/h3>\n\n\n\n

    Let\u2019s start with installing Jenkins on an Ubuntu-based system. We will cover installing Jenkins using both the default Ubuntu package and Jenkins\u2019 official repository, ensuring you get the latest version.<\/p>\n\n\n\n

    1. Update Your System<\/strong><\/h4>\n\n\n\n

    The first step before installing any new software is to ensure your system is up-to-date. Use the following commands to update your system\u2019s package index and upgrade all the installed packages:<\/p>\n\n\n\n

    $ sudo apt update\n$ sudo apt upgrade<\/code><\/pre>\n\n\n\n
    This will update your package lists and install any available upgrades for your existing packages.<\/p>\n\n\n\n
    2. Install Java<\/strong><\/h4>\n\n\n\n
    Jenkins requires Java to run. You can install OpenJDK, which is the free and open-source implementation of the Java Platform. To install Java 11, use the following command:<\/p>\n\n\n\n
    $ sudo apt install openjdk-11-jdk<\/code><\/pre>\n\n\n\n
    After the installation completes, verify that Java is installed by checking the version:<\/p>\n\n\n\n
    $ java -version<\/code><\/pre>\n\n\n\n
    You should see output indicating that Java 11 is installed.<\/p>\n\n\n\n
    3. Add Jenkins Repository<\/strong><\/h4>\n\n\n\n
    Now, you need to add the Jenkins repository to your system so that you can install the latest version of Jenkins. Start by importing the GPG key for the Jenkins repository:<\/p>\n\n\n\n
    $ curl -fsSL https:\/\/pkg.jenkins.io\/debian\/jenkins.io.key | sudo tee \\\n  \/usr\/share\/keyrings\/jenkins-keyring.asc > \/dev\/null<\/code><\/pre>\n\n\n\n
    Next, add the Jenkins repository to your system\u2019s sources list:<\/p>\n\n\n\n
    $ echo deb [signed-by=\/usr\/share\/keyrings\/jenkins-keyring.asc] \\\n  https:\/\/pkg.jenkins.io\/debian binary\/ | sudo tee \\\n  \/etc\/apt\/sources.list.d\/jenkins.list > \/dev\/null<\/code><\/pre>\n\n\n\n
    4. Install Jenkins<\/strong><\/h4>\n\n\n\n
    Once the Jenkins repository is added, update your package list again to reflect the new repository:<\/p>\n\n\n\n
    $ sudo apt update<\/code><\/pre>\n\n\n\n
    Now, install Jenkins using the following command:<\/p>\n\n\n\n
    $ sudo apt install jenkins<\/code><\/pre>\n\n\n\n
    5. Start and Enable Jenkins<\/strong><\/h4>\n\n\n\n
    After installation, you need to start the Jenkins service and enable it to run at boot:<\/p>\n\n\n\n
    $ sudo systemctl start jenkins\n$ sudo systemctl enable jenkins<\/code><\/pre>\n\n\n\n
    You can check the status of Jenkins to ensure it\u2019s running properly:<\/p>\n\n\n\n
    $ sudo systemctl status jenkins<\/code><\/pre>\n\n\n\n
    6. Configure Firewall<\/strong><\/h4>\n\n\n\n
    Jenkins by default runs on port 8080. If you are using a firewall, such as UFW (Uncomplicated Firewall), you need to open port 8080 to allow traffic:<\/p>\n\n\n\n
    $ sudo ufw allow 8080\n$ sudo ufw status<\/code><\/pre>\n\n\n\n
    Accessing Jenkins for the First Time<\/strong><\/h3>\n\n\n\n
    Now that Jenkins is installed and running, you can access its web interface to complete the setup.<\/p>\n\n\n\n
    1. Retrieve the Initial Admin Password<\/strong><\/h4>\n\n\n\n
    The first time you access Jenkins, it will ask for an admin password. This password is stored in a file on your server. Use the following command to view the password:<\/p>\n\n\n\n
    $ sudo cat \/var\/lib\/jenkins\/secrets\/initialAdminPassword<\/code><\/pre>\n\n\n\n
    Copy the password and paste it when prompted in the Jenkins setup wizard.<\/p>\n\n\n\n
    2. Open Jenkins in Your Web Browser<\/strong><\/h4>\n\n\n\n
    Open your web browser and navigate to:<\/p>\n\n\n\n
    http:\/\/your-server-ip:8080<\/code><\/pre>\n\n\n\n
    You will be greeted by the Jenkins setup wizard, where you\u2019ll need to paste the password you retrieved earlier.<\/p>\n\n\n\n
    3. Install Suggested Plugins<\/strong><\/h4>\n\n\n\n
    Jenkins will prompt you to install plugins. Select the “Install Suggested Plugins”<\/strong> option. Jenkins will automatically install the most commonly used plugins, such as Git, Pipeline, and more.<\/p>\n\n\n\n
    4. Create an Admin User<\/strong><\/h4>\n\n\n\n
    After the plugins are installed, Jenkins will prompt you to create an admin user. Fill in the required details and click Save and Finish<\/strong>.<\/p>\n\n\n\n
    5. Jenkins Is Ready<\/strong><\/h4>\n\n\n\n
    You have now successfully installed and configured Jenkins. You will be redirected to the Jenkins dashboard, where you can start creating jobs and automating your tasks.<\/p>\n\n\n\n
    Configuring Jenkins<\/strong><\/h3>\n\n\n\n
    Now that you have Jenkins installed, it\u2019s time to configure it to suit your project\u2019s needs. Jenkins offers a wide range of configuration options that can be tailored to fit almost any workflow.<\/p>\n\n\n\n
    1. Configure System<\/strong><\/h4>\n\n\n\n
    From the Jenkins dashboard, navigate to Manage Jenkins > Configure System<\/strong>. This section allows you to set global configurations, such as environment variables, email notifications, and paths to build tools like Maven, Gradle, and more.<\/p>\n\n\n\n
    For instance, to configure Java and Git:<\/p>\n\n\n\n