Initial admin setup wizard in Jenkins - Commands & Configuration

Introduction

When you install Jenkins for the first time, it needs some basic setup to secure and configure the system. The initial admin setup wizard helps you create the first admin user and install recommended plugins to get started quickly.

Right after installing Jenkins on a new server or machine.

When you want to secure Jenkins by creating an admin user before opening it to others.

When you want to quickly install essential plugins recommended by Jenkins.

When you need to configure basic settings like system URL and security options.

When setting up Jenkins for the first time to prepare it for your projects.

Commands

This command shows the initial admin password Jenkins generates during installation. You need this password to unlock Jenkins in the setup wizard.

Terminal

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

Expected Output

5f3d2a1b4c6e7f8d9a0b1c2d3e4f5678

This command starts the Jenkins service so you can access the setup wizard through the web browser.

Terminal

sudo systemctl start jenkins

Expected Output

No output (command runs silently)

This command checks if Jenkins is running and listening on port 8080 by requesting the HTTP headers.

Terminal

curl -I http://localhost:8080

Expected Output

HTTP/1.1 200 OK

Content-Type: text/html;charset=UTF-8

Content-Length: 1234

Date: Tue, 20 Jun 2024 12:00:00 GMT

→

-I - Fetch only HTTP headers to verify service availability

Key Concept

If you remember nothing else from this pattern, remember: the initial admin setup wizard secures Jenkins by creating the first admin user and installing essential plugins.

Common Mistakes

Trying to access Jenkins before starting the service.

Jenkins won't respond because the service is not running yet.

Always start Jenkins with 'sudo systemctl start jenkins' before accessing the setup wizard.

Not using the initial admin password from the secrets file.

You cannot unlock Jenkins without this password, so setup cannot continue.

Use 'sudo cat /var/lib/jenkins/secrets/initialAdminPassword' to get the password and enter it in the wizard.

Skipping plugin installation during setup.

Jenkins may lack important features needed for your projects.

Choose to install the recommended plugins during the wizard for a smooth start.

Summary

Use the initial admin password from the Jenkins secrets file to unlock the setup wizard.

Start the Jenkins service before accessing the web interface.

Install recommended plugins during the wizard to get essential features.

Practice

1. What is the main purpose of the Jenkins initial admin setup wizard?

easy

A. To deploy Jenkins jobs automatically

B. To configure Jenkins system settings like memory and CPU usage

C. To guide users through installing plugins and creating the first admin user

D. To backup Jenkins data to the cloud

Solution

1. Step 1: Understand the wizard's role

   The initial admin setup wizard helps new Jenkins users start quickly by guiding them through essential setup steps.

2. Step 2: Identify key tasks of the wizard

   It installs recommended plugins and creates the first admin user to secure Jenkins access.

3. Final Answer:

   To guide users through installing plugins and creating the first admin user -> Option C

4. Quick Check:

   Wizard purpose = guide setup [OK]

Hint: Wizard sets up plugins and admin user first [OK]

Common Mistakes:

• Thinking it configures system resources
• Assuming it deploys jobs automatically
• Believing it handles backups

2. Which of the following commands is used to unlock Jenkins during the initial admin setup?

easy

A. cat /var/lib/jenkins/secrets/initialAdminPassword

B. jenkins unlock --start

C. sudo service jenkins unlock

D. unlock-jenkins --password

Solution

1. Step 1: Identify the unlock method

   Jenkins stores the initial admin password in a file named initialAdminPassword inside the secrets directory.

2. Step 2: Use the correct command to read the password

   The cat command displays the password content to unlock Jenkins.

3. Final Answer:

   cat /var/lib/jenkins/secrets/initialAdminPassword -> Option A

4. Quick Check:

   Unlock command = cat password file [OK]

Hint: Use cat on initialAdminPassword file to unlock [OK]

Common Mistakes:

• Using non-existent Jenkins unlock commands
• Trying to unlock via service commands
• Confusing unlock with start or restart commands

3. After completing the initial admin setup wizard, what will Jenkins display when you access the dashboard for the first time?

medium

A. A prompt to create a new admin user

B. The Jenkins dashboard with default plugins installed

C. An error message about missing plugins

D. A blank page with no content

Solution

1. Step 1: Understand wizard completion effects

   Completing the wizard installs recommended plugins and sets up the admin user.

2. Step 2: Identify the dashboard state after setup

   Jenkins shows the dashboard with default plugins ready for use, not an error or blank page.

3. Final Answer:

   The Jenkins dashboard with default plugins installed -> Option B

4. Quick Check:

   Dashboard after setup = plugins installed [OK]

Hint: Dashboard shows plugins after setup wizard completes [OK]

Common Mistakes:

• Expecting a prompt to create admin again
• Thinking an error appears about plugins
• Assuming the page is blank initially

4. You ran the initial admin setup wizard but Jenkins still asks for the unlock password repeatedly. What is the most likely cause?

medium

A. The initialAdminPassword file was deleted or inaccessible

B. The Jenkins service is not running

C. The plugins failed to install

D. The admin user was created twice

Solution

1. Step 1: Identify why unlock repeats

   Jenkins requires the initial admin password from the initialAdminPassword file to unlock.

2. Step 2: Understand impact of missing password file

   If the file is deleted or unreadable, Jenkins cannot verify unlock and keeps asking for the password.

3. Final Answer:

   The initialAdminPassword file was deleted or inaccessible -> Option A

4. Quick Check:

   Unlock repeats if password file missing [OK]

Hint: Check if initialAdminPassword file exists and is readable [OK]

Common Mistakes:

• Assuming Jenkins service stopped causes unlock loop
• Blaming plugin installation failure for unlock issue
• Thinking duplicate admin users cause unlock prompt

5. You want to automate Jenkins initial setup without manual unlock. Which approach correctly achieves this?

hard

A. Pre-create the initialAdminPassword file with a known password before Jenkins starts

B. Install Jenkins plugins manually after first login

C. Use Jenkins CLI to skip the unlock step after startup

D. Disable the initial admin setup wizard in Jenkins configuration files

Solution

1. Step 1: Understand automation goal

   To avoid manual unlock, the initial setup wizard must be disabled or bypassed.

2. Step 2: Identify correct method

   Disabling the wizard in Jenkins configuration allows automated startup without unlock prompts.

3. Step 3: Evaluate other options

   Pre-creating password file is insecure and unreliable; CLI cannot skip unlock; manual plugin install is after unlock.

4. Final Answer:

   Disable the initial admin setup wizard in Jenkins configuration files -> Option D

5. Quick Check:

   Disable wizard to automate setup [OK]

Hint: Disable wizard in config to skip manual unlock [OK]

Common Mistakes:

• Trying to pre-create password file manually
• Assuming CLI can skip unlock step
• Thinking manual plugin install automates unlock