Skip to main content

DL3024: FROM aliases must be unique

Error Reliability

Why This Matters

Duplicate FROM aliases (AS name) cause ambiguity in multi-stage builds. When COPY --from=alias is used, Docker resolves to the last stage with that alias, silently ignoring earlier stages. This leads to builds that copy files from the wrong stage, producing incorrect images that may pass tests but fail at deployment. Every build stage alias must be unique.

How to Fix

Give each build stage a unique alias

Before (incorrect)

FROM node:20 AS build
# ...
FROM node:20 AS build

After (correct)

FROM node:20 AS build
# ...
FROM node:20 AS runtime

Rule Details

Rule Code
DL3024
Severity
Error
Category
Reliability

Related Rules