Enable and configure the GitLab Dependency Proxy for a group to cache Docker Hub images and reduce pull rate-limit failures in CI pipelines

domain: docs.gitlab.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Enable the Dependency Proxy for the group in GitLab by navigating to Settings > Packages and registries > Dependency Proxy, or via the Groups API: PUT /api/v4/groups/<GROUP_ID> with dependency_proxy_enabled: true
  2. In CI pipeline jobs, replace docker.io/<image>:<tag> references with <GITLAB_HOST>/<GROUP_PATH>/dependency_proxy/containers/<image>:<tag> to route pulls through the proxy
  3. Authenticate CI runners against the proxy using the predefined CI_DEPENDENCY_PROXY_USER and CI_DEPENDENCY_PROXY_PASSWORD variables in the docker login step targeting CI_DEPENDENCY_PROXY_SERVER
  4. Configure Docker Hub credentials on the group proxy settings to use an authenticated Docker Hub account and avoid anonymous rate limits: set the upstream credentials via Settings or the API
  5. Purge stale cached images using the DELETE /api/v4/groups/<GROUP_ID>/dependency_proxy/cache endpoint to force re-pulls of updated base images

Known gotchas

Related routes

Configure GitLab CI parent-child pipelines where a parent pipeline dynamically generates a child pipeline YAML based on changed paths and triggers it with the artifact strategy
GitLab CI · 6 steps · unrated
Configure GitLab CI needs: keyword with DAG to eliminate sequential stage bottlenecks and fan out parallel jobs
docs.gitlab.com · 6 steps · unrated
Configure a GitLab CI DAG pipeline using needs: with artifacts to fan out parallel jobs and aggregate results, then use rules: with if and changes to skip unchanged components
GitLab CI · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans