Error Knowledge Base DOCKER unauthorized_incorrect_password

unauthorized: incorrect username or password

Docker login failed because the registry rejected the username or password, so the stored credentials or access token are wrong.

What This Error Means

Docker login failed because the registry rejected the username or password, so the stored credentials or access token are wrong.

How to Fix It

Clear the bad credential first:docker logout <registry>

Log in again with the correct username and a current password or access token.

If you use a credential helper or OS keychain, remove the stale entry there as well before retrying.

If this fails in CI only, rotate the secret and verify the job is using the updated value.

Why It Happens

The username, password, or access token is wrong.

A credential helper returned stale credentials after the token was rotated.

CI is using the wrong secret or the wrong account for the target registry.

How to Verify

Retry the same pull or push and confirm the incorrect-password error is gone.

Perform a fresh docker login <registry> and confirm it succeeds without reusing cached credentials.

Manual authentication checks

Check whether Docker is pulling credentials from a keychain helper instead of plain auths in ~/.docker/config.json.

Verify the registry username matches the account that owns or can access the repository.

If the secret was rotated recently, confirm the old value is not still cached in CI.

Examples

unauthorized: incorrect username or password

How registry authentication works

Docker attaches stored credentials for the target registry host when it authenticates.

If those credentials are stale or wrong, the registry rejects the login or repository request immediately.

Prevention Tips

Prefer scoped tokens over long-lived passwords for automation.

Rotate registry tokens on a schedule and update all consuming jobs together.

Avoid sharing one mutable credential across unrelated environments.

Need help or found a mistake? Contact RepoFlow support for questions.

Join our mailing list