Jenkins is an accessible, open-source, self-hosted automation server that helps developers automate all parts of the software development process. It is based on Java and offers 1800+ plugins to support the automation of all kinds of tasks. Jenkins aims to continuously deliver your software by integrating with many testing and deployment technologies. It is cross-platform and can run on all major platforms including, macOS, Linux, and Windows.

In this post, we will show you how to install Jenkins on Arch Linux.

Step 1 – Configure the Repository

By default, the default repository is outdated in Arch Linux, so you will need to modify the default mirror list. You can do it by editing the mirror list configuration file:

nano  /etc/pacman.d/mirrorlist

Remove all lines and add the following lines:

## Score: 0.7, United States
Server = http://mirror.us.leaseweb.net/archlinux/$repo/os/$arch
## Score: 0.8, United States
Server = http://lug.mtu.edu/archlinux/$repo/os/$arch
Server = http://mirror.nl.leaseweb.net/archlinux/$repo/os/$arch
## Score: 0.9, United Kingdom
Server = http://mirror.bytemark.co.uk/archlinux/$repo/os/$arch
## Score: 1.5, United Kingdom
Server = http://mirrors.manchester.m247.com/arch-linux/$repo/os/$arch
Server = http://archlinux.dcc.fc.up.pt/$repo/os/$arch
## Score: 6.6, United States
Server = http://mirror.cs.pitt.edu/archlinux/$repo/os/$arch
## Score: 6.7, United States
Server = http://mirrors.acm.wpi.edu/archlinux/$repo/os/$arch
## Score: 6.8, United States
Server = http://ftp.osuosl.org/pub/archlinux/$repo/os/$arch
## Score: 7.1, India
Server = http://mirror.cse.iitk.ac.in/archlinux/$repo/os/$arch
## Score: 10.1, United States
Server = http://mirrors.xmission.com/archlinux/$repo/os/$arch

Save and close the file, then update all the package indexes with the following command:

pacman -Syu

Step 2 – Install Docker

In this post, we will use Docker to deploy Jenkins. You can install Docker and Docker Compose using the following command.

pacman -S docker docker-compose

Once the Docker is installed, enable the Docker service to start at system reboot.

systemctl enable docker

Next, restart your system to apply the system.

reboot

Step 3 – Create a Docker Compose File for Jenkins

First, create directories for Jenkins using the following command.

mkdir jenkins jenkins_home

Next, navigate to the Jenkins directory and create a docker-compose.yml file.

cd jenkins
nano docker-compose.yml

Add the following configurations.

version: '3.7'
services:
  jenkins:
    image: jenkins/jenkins:lts
    privileged: true
    user: root
    ports:
      - 8080:8080
      - 50000:50000
    container_name: jenkins-lts
    volumes:
      - ~/jenkins_home:/var/jenkins_home
      - /var/run/docker.sock:/var/run/docker.sock
      - /usr/local/bin/docker:/usr/local/bin/docker

Save and close the file when you are done.

Step 4 – Start Jenkins Container

At this point, the docker-compose.yml file is ready to launch the Jenkins container. Run the following command inside the Jenkins directory to create a container.

docker-compose up -d

You should see the following output.

[+] Running 14/14
 ✔ jenkins 13 layers [⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿]      0B/0B      Pulled                                                                                                       24.0s 
   ✔ 32fb02163b6b Pull complete                                                                                                                                    8.9s 
   ✔ c09d5e9e1188 Pull complete                                                                                                                                   14.3s 
   ✔ a56533012712 Pull complete                                                                                                                                   15.0s 
   ✔ 7936e107ffe7 Pull complete                                                                                                                                   15.1s 
   ✔ 3ca683058265 Pull complete                                                                                                                                   15.2s 
   ✔ c2ecd304b4b8 Pull complete                                                                                                                                   17.4s 
   ✔ be3512d810d6 Pull complete                                                                                                                                   17.5s 
   ✔ 56b37d7c2a7a Pull complete                                                                                                                                   17.9s 
   ✔ 99ed1e723e52 Pull complete                                                                                                                                   22.5s 
   ✔ 256db5485b13 Pull complete                                                                                                                                   22.6s 
   ✔ ee8c7eaf5e6b Pull complete                                                                                                                                   22.7s 
   ✔ 509f66c2f317 Pull complete                                                                                                                                   22.8s 
   ✔ 820296a845d6 Pull complete                                                                                                                                   22.9s 
[+] Running 2/2
 ✔ Network jenkins_default  Created                                                                                                                                0.1s 
 ✔ Container jenkins-lts    Started                                                                                                                                0.6s 

You can verify the Jenkins container status using the following command.

docker-compose ps

You will get the following output.

NAME                IMAGE                 COMMAND                  SERVICE             CREATED              STATUS              PORTS
jenkins-lts         jenkins/jenkins:lts   "/usr/bin/tini -- /u…"   jenkins             About a minute ago   Up About a minute   0.0.0.0:8080->8080/tcp, :::8080->8080/tcp, 0.0.0.0:50000->50000/tcp, :::50000->50000/tcp

You will also need Jenkins’s initial admin password to perform the Jenkins web-based installation. You can get the Jenkins admin password with the following command.

docker exec jenkins-lts cat /var/jenkins_home/secrets/initialAdminPassword

You should see the password in the following output.

99b844a4ad13404796e1ab8bcf05edd1

You can also check the Jenkins logs to get the password.

docker logs jenkins-lts | less

You should see the following output.

Jenkins initial setup is required. An admin user has been created and a password generated.
Please use the following password to proceed to installation:

99b844a4ad13404796e1ab8bcf05edd1

Running from: /usr/share/jenkins/jenkins.war
webroot: /var/jenkins_home/war
This may also be found at: /var/jenkins_home/secrets/initialAdminPassword

*************************************************************
*************************************************************
*************************************************************

2023-03-26 05:25:19.934+0000 [id=28]    INFO    jenkins.InitReactorRunner$1#onAttained: Completed initialization
2023-03-26 05:25:19.956+0000 [id=22]    INFO    hudson.lifecycle.Lifecycle#onReady: Jenkins is fully up and running
2023-03-26 05:25:20.151+0000 [id=44]    INFO    h.m.DownloadService$Downloadable#load: Obtained the updated data file for hudson.tasks.Maven.MavenInstaller
2023-03-26 05:25:20.153+0000 [id=44]    INFO    hudson.util.Retrier#start: Performed the action check updates server successfully at the attempt #1

Step 5 – Access Jenkins Web UI

At this point, Jenkins is installed and listens on port 8080. You can now access it using the URL http://your-server-ip:8080. You should see the Jenkins initial setup password screen.

Provide your password and click on the Continue button. You should see the customized Jenkins screen.

Click on Install suggested plugins. You should see the Getting Started screen.

Create your new admin user and click on the Save and Continue buttons. You should see the instance configuration screen.

Click on the Save and Finish button. You should see the following screen.

Click on the Start using Jenkins. You should see the Jenkins dashboard.

Conclusion

In this post, we explained how to install Jenkins with Docker on Arch Linux. You can now explore the Jenkins features and implement them in your organization to automate all kinds of tasks. You can also try to deploy Jenkins on dedicated server hosting from Atlantic.Net!