283

I'm unsure of how to name Dockerfiles. Many on GitHub use Dockerfile without a file extension. Do I give them a name and extension; if so what? Or do I just call them Dockerfile?

11 Answers 11

299

[Please read the full answer]Don't change the name of the dockerfile if you want to use the autobuilder at hub.docker.com. Don't use an extension for docker files, leave it null. File name should just be: (no extension at all)

Dockerfile

However, now you can name dockerfiles like,

test1.Dockerfile
$ docker build -f dockerfiles/test1.Dockerfile  -t test1_app .

or

Dockerfile.test1
$ docker build -f dockerfiles/Dockerfile.test1  -t test1_app .

This will also work.

If you handle multiple files that live in the same context, you could use STDIN:

test1.Dockerfile
$ docker build -t test1_app - < test1.Dockerfile
12
  • 162
    What about when you have multiple Dockerfiles in the same directory? Aug 13, 2016 at 12:12
  • 11
    @VisgeanSkeloru Don't have multiple Dockerfiles in the same directory. The containing directory becomes the context for the docker build command, which means that each image will be needlessly rebuilt if another image's dockerfile is changed.
    – Thomas
    Apr 26, 2018 at 12:07
  • 23
    @Thomas sometimes you need to place multiple Dockerfiles in the same directory in order to share common files across separate containers, because docker context doesn't allow to access "../some-common-stuff"
    – Devis L.
    May 3, 2019 at 20:30
  • 13
    Does the "D" have to be capitalized or it doesn't matter?
    – NoName
    Jun 13, 2020 at 23:14
  • 1
    You could also use the STDIN to pass the file as an standard input: docker build - < rarename.dockerfile and should work
    – Aosi
    Oct 14, 2021 at 1:18
167

dev.Dockerfile, test.Dockerfile, build.Dockerfile etc.

On VS Code I use <purpose>.Dockerfile and it gets recognized correctly.

5
  • 3
    Recognized correctly on IntelliJ Idea Community 2020.2 as well!
    – rahulmohan
    Nov 2, 2020 at 13:38
  • 12
    to build image: docker build . -f dev.Dockerfile
    – Daniel B
    Jan 3, 2021 at 18:20
  • 1
    How do you build with that? If I run docker build -f foo.Dockerfile . it just opens another terminal window (on top of the one I'm using) then closes it straight away and no image is built, with no error either. Weird. This is in Powershell, Windows.
    – Mitya
    Apr 12, 2022 at 11:54
  • @Mitya, not sure. If it helps, my build command is docker build -f base.Dockerfile . in linux and it works. Does a normal build command work for you docker build -f Dockerfile . ? Apr 13, 2022 at 5:14
  • Any time I specify -f <name> I get this weirdness with the new terminal window. The solution I worked out in the end was to use a docker-compose.yml and specify the Dockerfile in there via build > dockerfile: foo.Dockerfile
    – Mitya
    Apr 13, 2022 at 10:29
74

I know this is an old question, with quite a few answers, but I was surprised to find that no one was suggesting the naming convention used in the official documentation:

$ docker build -f dockerfiles/Dockerfile.debug -t myapp_debug .
$ docker build -f dockerfiles/Dockerfile.prod  -t myapp_prod .

The above commands will build the current build context (as specified by the .) twice, once using a debug version of a Dockerfile and once using a production version.

In summary, if you have a file called Dockerfile in the root of your build context it will be automatically picked up. If you need more than one Dockerfile for the same build context, the suggested naming convention is:

Dockerfile.<purpose>

These dockerfiles could be in the root of your build context or in a subdirectory to keep your root directory more tidy.

5
  • 13
    It makes sense too because like this, when sorted alphabetically and sitting alongside other files in a directory, all Dockerfiles are grouped together.
    – haslo
    Jan 6, 2021 at 11:13
  • 4
    That reasoning can be applied to all files, yet by convention we have extentions, i.e. types of files, as suffix to the filename.
    – hbogert
    Jan 13, 2021 at 13:29
  • 8
    The problem is that .purpose is now the extension of your file, which might confuse the system, text-editor or IDEs. <purpose>.Dockerfile has the advantage of always having .Dockerfile as extension Dec 19, 2021 at 10:09
  • 2
    Read the docs you linked and it does include references to both naming formats such as using .Dockerfile as the extension. From the official docs: For example, running docker build -f myapp.Dockerfile . will first look for an ignore file.... From here: docs.docker.com/engine/reference/commandline/build/… Jan 12 at 20:28
  • Having that capital "D" in the extension just doesn't sit right with me. :)
    – Josh M.
    Apr 26 at 20:36
39

I think you should have a directory per container with a Dockerfile (no extension) in it. For example:

  /db/Dockerfile
  /web/Dockerfile
  /api/Dockerfile

When you build just use the directory name, Docker will find the Dockerfile. e.g:

docker build -f ./db .
8
  • Will it build 3 containers from your example?
    – alvas
    Apr 11, 2017 at 1:56
  • @alvas Yes it will
    – garryp
    Apr 11, 2017 at 9:02
  • 10
    It is not good enough many cases. Docker can not see files up. For example target, build, etc.
    – Cyva
    Nov 9, 2017 at 10:14
  • Can we run this 3 docker file at single time using docker-compose command then? Jan 8, 2020 at 13:00
  • 1
    but this is why docker compose is good to use instead IMO. Then it's very flexible how you wanna structure or locate your actual dockerfile(s) Sep 14, 2020 at 4:47
26

I have created two Dockerfiles in same directory,

# vi one.Dockerfile
# vi two.Dockerfile

to build both Dockerfiles use,

# docker build . -f one.Dockerfile
# docker build . -f two.Dockerfile

Note: you should be in present working directory..

23

Do I give them a name and extension; if so what?

You may name your Dockerfiles however you like. The default filename is Dockerfile (without an extension), and using the default can make various tasks easier while working with containers.

Depending on your specific requirements you may wish to change the filename. If you're building for multiple architectures, for example, you may wish to add an extension indicating the architecture as the resin.io team has done for the HAProxy container their multi-container ARM example:

Dockerfile.aarch64
Dockerfile.amd64
Dockerfile.armhf
Dockerfile.armv7hf
Dockerfile.i386
Dockerfile.i386-nlp
Dockerfile.rpi

In the example provided, each Dockerfile builds from a different, architecture-specific, upstream image. The specific Dockerfile to use for the build may be specified using the --file, -f option when building your container using the command line.

1
  • 2
    I like using an extension to indicate architecture (or whatever). Unlike some other answers, all the Dockerfiles are dead simple to find in a big, cluttered directory; they naturally sort together. Feb 3, 2019 at 18:07
21

If you want to use the autobuilder at hub.docker.com, it has to be Dockerfile. So there :)

1
  • 4
    I believe the context of the question was more broad. Perhaps you could include additional information for individuals not using autobuilder to make this answer more complete.
    – vhs
    Jul 6, 2018 at 7:07
19

It seems this is true but, personally, it seems to me to be poor design. Sure, have a default name (with extension) but allow other names and have a way of specifying the name of the docker file for commands.

Having an extension is also nice because it allows one to associate applications to that extension type. When I click on a Dockerfile in MacOSX it treats it as a Unix executable and tries to run it.

If Docker files had an extension I could tell the OS to start them with a particular application, e.g. my text editor application. I'm not sure but the current behaviour may also be related to the file permisssions.

1
  • 2
    I prefer using <name>.Dockerfile in such a scenario. Works well with Jetbrains IDEs as well.
    – Nishant
    Mar 3, 2021 at 14:35
5

Dockerfile is good if you only have one docker file (per-directory). You can use whatever standard you want if you need multiple docker files in the same directory - if you have a good reason. In a recent project there were AWS docker files and local dev environment files because the environments differed enough:

Dockerfile
Dockerfile.aws
1
  • 1
    I've seen this method used for specifying architectures as well. For example, placing a Dockerfile.armv7hf next to a Dockerfile.i386.
    – vhs
    Jul 6, 2018 at 7:05
4

There are 2 main Dockerfile naming conventions:

1. Using a default Dockerfile:

Keeping it simple, this approach suits simple, standalone, and well-defined projects.

$ docker build -f ./Dockerfile.Dockerfile .

2. Using a custom Dockerfile:

Keeping it custom, this approach familiarises the developer with the application context, facilitates file manipulation and, improves debugging capability, especially in the case of multiple dockerfiles.

$ docker build -t <containername> . -f <mycustomdockerfile>.Dockerfile

Gentle Reminder:

These conventions are equally applicable for common docker image building commands such as 'docker image build' and 'docker-compose build'.

3

Dockerfile (custom name and folder):

   docker/app.Dockerfile
   docker/nginx.Dockerfile

Build:

   docker build  -f ./docker/app.Dockerfile .
   docker build  -f ./docker/nginx.Dockerfile .

Your Answer

Reminder: Answers generated by Artificial Intelligence tools are not allowed on Stack Overflow. Learn more

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.