// troubleshooting guide · jenkins

Jenkins Forgot Admin Password: How to Reset It

Status
Workaround available
platforms:
Jenkins controller (Linux, Docker, Windows)
updated:
November 16, 2026
reports:
3
Method
how we research
Share

RUNBOOK · jenkins/reset-admin-password4 FIXES

// quick answer

Stop Jenkins, set useSecurity to false in $JENKINS_HOME/config.xml, start it, reset the password under Manage Jenkins > Users, then re-enable security immediately.

Most likely fix: Disable security temporarily

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Disable security temporarily

    1. 01Stop Jenkins: sudo systemctl stop jenkins
    2. 02Back up $JENKINS_HOME/config.xml (usually /var/lib/jenkins/config.xml; /var/jenkins_home/config.xml in Docker)
    3. 03Change <useSecurity>true</useSecurity> to false and save
    4. 04Start Jenkins: sudo systemctl start jenkins
    Did this fix it?
  2. FIX 2Set a new password

    1. 01Open Manage Jenkins > Security and set Security Realm to Jenkins' own user database (leave Allow users to sign up unticked), save
    2. 02Go to Manage Jenkins > Users, open your admin user > Configure (or Security)
    3. 03Set the new password and save
    Did this fix it?
  3. FIX 3Re-enable security right away

    1. 01In Manage Jenkins > Security set Authorization to Logged-in users can do anything (or your previous strategy)
    2. 02Untick Allow anonymous read access and save
    3. 03While security is off anyone who can reach Jenkins has full access
    Did this fix it?
  4. FIX 4If useSecurity flips back to true

    1. 01Check for a Configuration as Code file (jenkins.yaml or CASC_JENKINS_CONFIG)
    2. 02Temporarily move it aside or change the password there, then restart
    Did this fix it?

SANDBOX · jenkins RUNS IN YOUR BROWSER

Try it: push, review, run CI and merge in a code host and cloud workspace

A hands-on Jenkins-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.

Symptoms

You can't log in to Jenkins because the admin password is lost, or you locked yourself out after changing Global Security settings.

Why it happens

  • C-01Forgotten or never-recorded admin password
  • C-02A wrong Security Realm or Authorization setting saved
  • C-03Configuration as Code (jenkins.yaml) re-applies security on restart

// this guide also covers

  • jenkins forgot admin password
  • jenkins reset admin password
  • jenkins locked out
  • jenkins usesecurity false

Still not working?

If Jenkins keeps failing, you're not alone. See every Jenkins problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us

Watch Jenkins Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other Jenkins errors

All 14 Jenkins errors and fixes →