FerryDocs
GuidesTroubleshooting

Builds fail on an old Docker Engine

A service with environment variables needs Docker Engine 27.3 or newer for its build.

Edit on GitHub

What you see

Deploy log
… (secret env mounts need Docker Engine 27.3 or newer: upgrade Docker on the Ferry server)

The deploy gets the status build_failed. The live deploy continues to answer.

Why it occurs

Variablesof the serviceBuildKit secretdocker buildneeds Engine 27.3

The service has . They go to the as BuildKit secrets. A BuildKit secret is a . The Docker Engine of the server is older than 27.3.

How to repair it

Upgrade Docker on the Ferry server.

Ferry cannot detect the runtime

The build finds no file that tells Ferry how to build the app.

ferryd cannot find the docker CLI

ferryd runs docker build, but it finds no docker command.

On this page

What you seeWhy it occursHow to repair it