spring-projects/spring-boot · error · IllegalStateException

Docker API version must be at least %s to support this featu

Error message

Docker API version must be at least %s to support this feature, but current API version is %s

What it means

Error "Docker API version must be at least %s to support this feature, but current API version is %s" thrown in spring-projects/spring-boot.

Source

Thrown at buildpack/spring-boot-buildpack-platform/src/main/java/org/springframework/boot/buildpack/platform/docker/DockerApi.java:151

	private URI buildUrl(String path, @Nullable Collection<?> params) {
		return buildUrl(Feature.BASELINE, path, (params != null) ? params.toArray() : null);
	}

	private URI buildUrl(String path, Object... params) {
		return buildUrl(Feature.BASELINE, path, params);
	}

	URI buildUrl(Feature feature, String path, Object @Nullable ... params) {
		ApiVersion version = getApiVersion();
		if (version.equals(UNKNOWN_API_VERSION) || (version.compareTo(PREFERRED_API_VERSION) >= 0
				&& version.compareTo(feature.minimumVersion()) >= 0)) {
			return buildVersionedUrl(PREFERRED_API_VERSION, path, params);
		}
		if (version.compareTo(feature.minimumVersion()) >= 0) {
			return buildVersionedUrl(version, path, params);
		}
		throw new IllegalStateException(
				"Docker API version must be at least %s to support this feature, but current API version is %s"
					.formatted(feature.minimumVersion(), version));
	}

	private URI buildVersionedUrl(ApiVersion version, String path, Object @Nullable ... params) {
		try {
			URIBuilder builder = new URIBuilder("/v" + version + path);
			if (params != null) {
				int param = 0;
				while (param < params.length) {
					builder.addParameter(Objects.toString(params[param++]), Objects.toString(params[param++]));
				}
			}
			return builder.build();
		}
		catch (URISyntaxException ex) {
			throw new IllegalStateException(ex);
		}

View on GitHub (pinned to 5b2dbdbb8b)

When it happens

Trigger: Thrown at buildpack/spring-boot-buildpack-platform/src/main/java/org/springframework/boot/buildpack/platform/docker/DockerApi.java:151 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of spring-projects/spring-boot@5b2dbdbb8b (2026-08-04). Data as JSON: /data/errors/d3a3f9eb92952038.json. Report an issue: GitHub.