Is `FROM` clause required in Dockerfile?

Question

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

Answer 1

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

Answer 2

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

Answer 3

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.