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
[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
-
162What about when you have multiple Dockerfiles in the same directory? Aug 13, 2016 at 12:12
-
11
-
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
-
1You could also use the STDIN to pass the file as an standard input:
docker build - < rarename.dockerfile
and should work– AosiOct 14, 2021 at 1:18
dev.Dockerfile
, test.Dockerfile
, build.Dockerfile
etc.
On VS Code I use <purpose>.Dockerfile
and it gets recognized correctly.
-
3
-
12
-
1How 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.– MityaApr 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 youdocker 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 viabuild > dockerfile: foo.Dockerfile
– MityaApr 13, 2022 at 10:29
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 aDockerfile
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.
-
13It makes sense too because like this, when sorted alphabetically and sitting alongside other files in a directory, all Dockerfiles are grouped together.– hasloJan 6, 2021 at 11:13
-
4That reasoning can be applied to all files, yet by convention we have extentions, i.e. types of files, as suffix to the filename.– hbogertJan 13, 2021 at 13:29
-
8The 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 -
2Read 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
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 .
-
-
-
10It is not good enough many cases. Docker can not see files up. For example target, build, etc.– CyvaNov 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
-
1but 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
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..
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.
-
2I 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
If you want to use the autobuilder at hub.docker.com, it has to be Dockerfile
. So there :)
-
4I 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.– vhsJul 6, 2018 at 7:07
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.
-
2I prefer using <name>.Dockerfile in such a scenario. Works well with Jetbrains IDEs as well.– NishantMar 3, 2021 at 14:35
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
-
1I've seen this method used for specifying architectures as well. For example, placing a
Dockerfile.armv7hf
next to aDockerfile.i386
.– vhsJul 6, 2018 at 7:05
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'.
Dockerfile (custom name and folder):
docker/app.Dockerfile
docker/nginx.Dockerfile
Build:
docker build -f ./docker/app.Dockerfile .
docker build -f ./docker/nginx.Dockerfile .