// 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
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
FIX 1Disable security temporarily
- 01Stop Jenkins: sudo systemctl stop jenkins
- 02Back up $JENKINS_HOME/config.xml (usually /var/lib/jenkins/config.xml; /var/jenkins_home/config.xml in Docker)
- 03Change <useSecurity>true</useSecurity> to false and save
- 04Start Jenkins: sudo systemctl start jenkins
Did this fix it?FIX 2Set a new password
- 01Open Manage Jenkins > Security and set Security Realm to Jenkins' own user database (leave Allow users to sign up unticked), save
- 02Go to Manage Jenkins > Users, open your admin user > Configure (or Security)
- 03Set the new password and save
Did this fix it?FIX 3Re-enable security right away
- 01In Manage Jenkins > Security set Authorization to Logged-in users can do anything (or your previous strategy)
- 02Untick Allow anonymous read access and save
- 03While security is off anyone who can reach Jenkins has full access
Did this fix it?FIX 4If useSecurity flips back to true
- 01Check for a Configuration as Code file (jenkins.yaml or CASC_JENKINS_CONFIG)
- 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 usOther Jenkins errors
- Jenkins Build Stuck 'Waiting for Next Available Executor'
- Jenkins Build Stuck and Won't Abort
- Jenkins Plugins Failed to Load After Update
- Jenkins Not Starting: 'Job for jenkins.service failed'
- Jenkins java.lang.OutOfMemoryError: Java Heap Space
- Why Is Jenkins So Slow?
- Jenkins 'Scripts Not Permitted to Use Method' Error
- Jenkins GitHub Webhook Not Triggering Build