Jenkins home directory structure - Commands & Configuration

Introduction

Jenkins stores all its data and configuration in a special folder called the home directory. This folder keeps your jobs, plugins, and settings safe so Jenkins can run smoothly.

When you want to back up your Jenkins jobs and settings.

When you need to move Jenkins to a new server without losing data.

When troubleshooting Jenkins issues related to plugins or job configurations.

When you want to clean up old build data to save disk space.

When installing new plugins manually by placing files in the correct folder.

Commands

This command shows the path of the Jenkins home directory where all Jenkins data is stored.

Terminal

echo $JENKINS_HOME

Expected Output

/var/lib/jenkins

Lists the contents of the Jenkins home directory to see folders like jobs, plugins, and config files.

Terminal

ls -l /var/lib/jenkins

Expected Output

total 48

drwxr-xr-x 2 jenkins jenkins 4096 Apr 25 10:00 jobs

drwxr-xr-x 2 jenkins jenkins 4096 Apr 25 10:00 plugins

-rw-r--r-- 1 jenkins jenkins  123 Apr 25 10:00 config.xml

-rw-r--r-- 1 jenkins jenkins  456 Apr 25 10:00 hudson.tasks.Mailer.xml

→

-l - Shows detailed list including permissions, owner, and timestamps

Shows the list of all Jenkins jobs stored in the jobs folder inside the home directory.

Terminal

ls -l /var/lib/jenkins/jobs

Expected Output

total 8

drwxr-xr-x 3 jenkins jenkins 4096 Apr 25 10:00 example-job

→

-l - Detailed listing of job folders

Displays the main Jenkins configuration file that controls global settings.

Terminal

cat /var/lib/jenkins/config.xml

Expected Output

<?xml version='1.0' encoding='UTF-8'?>

<jenkins>

  <numExecutors>2</numExecutors>

  <mode>EXCLUSIVE</mode>

  <label></label>

  <quietPeriod>5</quietPeriod>

  <scmCheckoutRetryCount>0</scmCheckoutRetryCount>

</jenkins>

Key Concept

If you remember nothing else from Jenkins home directory, remember: it holds all your jobs, plugins, and settings in one place to keep Jenkins running.

Common Mistakes

Trying to edit Jenkins files directly without stopping Jenkins.

Jenkins may overwrite changes or get corrupted if files are changed while running.

Always stop Jenkins before editing files in the home directory, then restart it.

Deleting files inside the home directory without backup.

You can lose important job configurations or plugin data permanently.

Make a backup of the entire Jenkins home directory before deleting or modifying files.

Assuming Jenkins home is always /var/lib/jenkins.

Jenkins home can be different depending on installation or environment.

Check the actual Jenkins home path using 'echo $JENKINS_HOME' or Jenkins system info.

Summary

The Jenkins home directory stores all Jenkins data including jobs, plugins, and configuration files.

Use commands like 'echo $JENKINS_HOME' and 'ls' to explore the directory structure.

Always handle files in the home directory carefully to avoid data loss or corruption.