CODEWITHSUNDEEP
dockerdockerfile
flow2k
flow2k

Reputation: 4357

Is `FROM` clause required in Dockerfile?

For all the Dockerfiles I've come across thus (which admittedly is not many), all of them have used a FROM clause to base off an existing image, even if it's FROM scratch.

Is this clause required? Is it possible to have a Dockerfile with no FROM clause? Will this container created thus be able to do anything?

EDIT
I read

A Dockerfile with no FROM directive has no parent image, and is called a base image.

https://docs.docker.com/glossary/?term=parent%20image

But I think this may be an error.

Upvotes: 7

Views: 6229

Answers (3)

Ivan Velichko
Ivan Velichko

Reputation: 6709

Short answer is yes, the FROM clause is required. But it's easier to come to this conclusion if you think of the image building process a bit.

Dockerfile is just a way to describe a sequence of commands to be executed by Docker build subsystem to create an image. And an image is just a bunch of regular files, most notably, user land files of a particular Linux distribution, but possibly with some extra files on top of it. Every Docker image is based on the parent image and adds its own files to the parent's set. Every image has to start FROM something, i.e. specify its parent. And the parent of all parents is a scratch image defined as noop, i.e. an empty set of files.

Take a look at busybox image:

FROM scratch
ADD busybox.tar.xz /
CMD ["sh"]

It starts from scratch, i.e. an empty set of files, and adds (i.e. copies) to this set a bunch of files from busybox.tar.xz archive.

Now, if you want to create your own image, you can start from busybox image and describe what files (and how) you are going to add:

FROM busybox:latest

ADD myfile.txt /

But every time a new image has to start FROM something.

Upvotes: 7

Marek Skiba
Marek Skiba

Reputation: 2184

Based on the official documentation it's required:

The FROM instruction initializes a new build stage and sets the Base Image for subsequent instructions. As such, a valid Dockerfile MUST start with a FROM instruction. The image can be any valid image – it is especially easy to start by pulling an image from the Public Repositories.

https://docs.docker.com/engine/reference/builder/#from

Upvotes: 10

Jaime Noel Alvarez Luna
Jaime Noel Alvarez Luna

Reputation: 468

Yes, it is. It defines the layers on which the image you are building is based on. If you want to start an image from scratch docker offers an image called scratch

The documentation also says:

A parent image is the image that your image is based on

also

A base image has FROM scratch in its Dockerfile.

Refer to base images documentation

Upvotes: 1

Related Questions