Docker Docs

Appearance

Fresh

RedundantTargetPlatform ​

Back

Reference

RedundantTargetPlatform ​

Copy as Markdown

Open MarkdownAsk Docs AIClaudeOpen in Claude

Table of contents

Output ​

text
Setting platform to predefined $TARGETPLATFORM in FROM is redundant as this is the default behavior

Description ​

A custom platform can be used for a base image. The default platform is the same platform as the target output so setting the platform to $TARGETPLATFORM is redundant and unnecessary.

Examples ​

❌ Bad: this usage of --platform is redundant since $TARGETPLATFORM is the default.

dockerfile
FROM --platform=$TARGETPLATFORM alpine AS builder
RUN apk add --no-cache git

✅ Good: omit the --platform argument.

dockerfile
FROM alpine AS builder
RUN apk add --no-cache git