# Error: credential helper 'desktop' is not installed or not configured. Run 'docker login' to configure credentials.

- **ID:** `cicd/docker-credential-helper-not-configured`
- **Domain:** cicd
- **Category:** auth_error
- **Verification:** ai_generated
- **Fix Rate:** 85%

## Root Cause

Docker credential helper (e.g., desktop, ecr-login) is not installed or configured in the CI environment, preventing authentication to private registries.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| Docker 24.0.5 | active | — | — |
| Docker Desktop 4.22.0 | active | — | — |
| Amazon ECR Docker Credential Helper 0.7.1 | active | — | — |

## Workarounds

1. **Install the credential helper: For Docker Desktop on Linux, run: sudo apt-get install docker-credential-desktop. Then verify: docker-credential-desktop list. Alternatively, use the 'pass' credential store.** (90% success)
   ```
   Install the credential helper: For Docker Desktop on Linux, run: sudo apt-get install docker-credential-desktop. Then verify: docker-credential-desktop list. Alternatively, use the 'pass' credential store.
   ```
2. **Disable credential helpers temporarily by setting the config to store credentials in plain text (not recommended for production): echo '{"credsStore":""}' > ~/.docker/config.json && docker login** (80% success)
   ```
   Disable credential helpers temporarily by setting the config to store credentials in plain text (not recommended for production): echo '{"credsStore":""}' > ~/.docker/config.json && docker login
   ```

## Dead Ends

- **** — Running docker login without specifying the credential store may still fail if the helper path is missing. (40% fail)
- **** — Setting DOCKER_CONFIG to a non-existent path can break other Docker commands. (30% fail)