Automated Dependency Updates for Dockerfile

Categories: docker

Renovate supports updating Dockerfile dependencies.

File Matching¶

By default, Renovate will check any files matching any of the following regular expressions:

(^|/|\.)([Dd]ocker|[Cc]ontainer)file$
(^|/)([Dd]ocker|[Cc]ontainer)file[^/]*$

For details on how to extend a manager's fileMatch value, please follow this link.

Supported datasources¶

This manager supports extracting the following datasources: docker.

Default config¶

{
  "fileMatch": [
    "(^|/|\\.)([Dd]ocker|[Cc]ontainer)file$",
    "(^|/)([Dd]ocker|[Cc]ontainer)file[^/]*$"
  ]
}

Additional Information¶

Supported dependencies¶

This manager extracts image references in a Dockerfile and/or Containerfile and supports:

FROM images
COPY --from images
syntax images

`FROM` support¶

Renovate can update images referenced in FROM directives. This even works for multi-stage builds with many FROM directives in one Dockerfile.

FROM node:20.9.0

Advanced FROM flags like --platform or AS <name> are also supported:

FROM --platform=linux/amd64 node:20.9.0 AS installer

Also, Renovate will automatically expand variables and ARG directives:

ARG TAG=3.19.4
FROM alpine:${TAG}

`COPY --from` support¶

Renovate can update images referenced in COPY --from directives.

FROM node:20.9.0
COPY --from alpine:3.19.4 /bin/sh /usr/local/sh

`syntax` support¶

Renovate can update syntax references.

# syntax=docker/dockerfile:1.9.0
FROM alpine:3.19.4

Versioning¶

Renovate's managers does not understand versioning, that's up to Renovate's versioning modules. The default docker versioning for container image datasources treats suffixes as "compatibility", for example: -alpine. Many container images are not SemVer compliant because they use such suffixes in their tags.

If Renovate does not update your container images correctly, you may need to tell Renovate what versioning it should use. For example, if you know that an image follows SemVer, you can tell Renovate to use "semver" versioning for that image:

{
  "packageRules": [
    {
      "matchDatasources": ["docker"],
      "matchPackageNames": ["whitesource/renovate"],
      "versioning": "semver"
    }
  ]
}

Read Renovate's Docker Versioning docs to learn more.

Open items¶

The below list of features were current when this page was generated on November 21, 2024.

Feature requests¶

Dockerfile FROM version pinning support #1027