Jenkins "Could not find credentials entry with ID"
A step referenced a credential by ID that Jenkins could not find in the available scope, so the build failed before using it.
What this error means
A stage fails with "Could not find credentials entry with ID NAME" at a withCredentials, git, or docker step. The build runs up to the credential lookup.
jenkins
ERROR: Could not find credentials entry with ID 'dockerhub-token'Diagnose it: agent, workspace, or sandbox?
Jenkinsfile
sh 'hostname && whoami && pwd'
sh 'java -version 2>&1'
sh 'env | sort | head -40'
// workspaces are reused between builds by default
cleanWs()Common causes
Credential ID typo or wrong ID
The pipeline references an ID that does not match the stored credential.
Credential in the wrong scope
The credential exists in a folder or store the job cannot see.
Credential deleted or not created
The referenced credential was never added or was removed.
How to fix it
Match the exact credential ID and scope
- Open Manage Jenkins > Credentials and copy the exact ID.
- Ensure the credential lives in a store visible to the job (global or the job's folder).
Jenkinsfile
withCredentials([usernamePassword(credentialsId: 'dockerhub-token',
usernameVariable: 'U', passwordVariable: 'P')]) { sh 'docker login -u $U -p $P' }How to prevent it
- Define credentials at the right folder scope and reference them by stable IDs; this is a configuration mismatch, so retrying will not resolve it.
Frequently asked questions
What causes Jenkins "Could not find credentials entry with ID"?
There are 3 common causes: credential id typo or wrong id, credential in the wrong scope, and credential deleted or not created. The pipeline references an ID that does not match the stored credential.
How do I fix Jenkins "Could not find credentials entry with ID"?
Match the exact credential ID and scope. Open Manage Jenkins > Credentials and copy the exact ID.
What does Jenkins "Could not find credentials entry with ID" actually mean?
A stage fails with "Could not find credentials entry with ID NAME" at a withCredentials, git, or docker step.
How do I stop Jenkins "Could not find credentials entry with ID" happening again?
Define credentials at the right folder scope and reference them by stable IDs; this is a configuration mismatch, so retrying will not resolve it.