342

I just downloaded Docker Toolbox for Windows 10 64-bit today. I'm going through the tutorial. I'm receiving the following error when trying to build an image using a Dockerfile.

Steps:

  • Launched Docker Quickstart terminal.
  • testdocker after creating it.
  • Prepare Dockerfile as documented in "Build your own image" web link
  • ran the below command

docker build -t docker-whale .

Error: $ docker build -t docker-whale .

unable to prepare context: unable to evaluate symlinks in Dockerfile path: GetFileAttributesEx C:\Users\Villanueva\Test\testdocker\Dockerfile: The system cannot find the file specified.

BTW: I tried several options mentioned @ https://github.com/docker/docker/issues/14339

docker info

Output:

Containers: 4
 Running: 0
 Paused: 0
 Stopped: 4
Images: 2
Server Version: 1.10.1
Storage Driver: aufs
 Root Dir: /mnt/sda1/var/lib/docker/aufs
 Backing Filesystem: extfs
 Dirs: 20
 Dirperm1 Supported: true
Execution Driver: native-0.2
Logging Driver: json-file
Plugins:
 Volume: local
 Network: bridge null host
Kernel Version: 4.1.17-boot2docker
Operating System: Boot2Docker 1.10.1 (TCL 6.4.1); master : b03e158 - Thu Feb 11 22:34:01 UTC 2016
OSType: linux
Architecture: x86_64
CPUs: 1
Total Memory: 996.2 MiB
Name: default
ID: C7DS:CIAJ:FTSN:PCGD:ZW25:MQNG:H3HK:KRJL:G6FC:VPRW:SEWW:KP7B
Debug mode (server): true
 File Descriptors: 32
 Goroutines: 44
 System Time: 2016-02-19T17:37:37.706076803Z
 EventsListeners: 0
 Init SHA1:
 Init Path: /usr/local/bin/docker
 Docker Root Dir: /mnt/sda1/var/lib/docker
Labels:
 provider=virtualbox
4
  • 10
    Update: docker build -t XXX --file ./Dockefile . worked. Docker may want to update their documentation for Windows users.
    – villanux
    Feb 19, 2016 at 19:09
  • 4
    If docker build -t XXX --file ./Dockefile it might be because you got the filename wrong it's missing the R.
    – eXa
    May 9, 2016 at 11:14
  • 37
    This is an amazingly bad error message, it just means "cannot open file" - same on Linux and macOS.
    – RichVel
    Dec 19, 2016 at 9:42
  • 4
    Mind-blowingly bad error message. Apr 5, 2020 at 19:30

36 Answers 36

313

While executing the following command,

docker build -t docker-whale .

check that Dockerfile is present in your current working directory.

8
  • 32
    Thanks. My issue was I had created my Dockerfile in Notepad and it had automatically appended .txt to the filename.
    – IanGSY
    Nov 15, 2016 at 9:07
  • 15
    You may also explicitly write the Dockerfile name with the fflag, as in docker build -f Dockerfile-dev.yaml -t my_container . This may prove useful if you have several Dockerfile in your project, one per environment, for example. The same applies to docker-compose. Putting them in different subdirectories will not work, since the context (.) will not match. Feb 17, 2017 at 8:16
  • 1
    @IanGSY I wish I could give you more points for that. That was exactly my problem too! Nov 12, 2017 at 5:57
  • 9
    Notepad is an excessively evil program. Dec 29, 2017 at 8:18
  • When you need a reminder that you're calling from the wrong directory xD
    – Kraken
    Jan 28, 2021 at 11:27
221

The error message is misleading

The problem has nothing to do with symbolic links really. Usually, the problem is only that Docker cannot find the Dockerfile describing the build.

Typical reasons are these:

  • Dockerfile has wrong name. It must be called Dockerfile. If it is called, for instance, dockerfile, .Dockerfile, Dockerfile.txt, or other, it will not be found.
  • Dockerfile is not in context. If you say docker build contextdir, the Dockerfile must be at contextdir/Dockerfile. If you have it in, say, ./Dockerfile instead, it will not be found.
  • Dockerfile does not exist at all. Does it sound silly? Well, I got the above error message from my GitLab CI after I had written a nice Dockerfile, but I had forgotten to check it in. Silly? Sure. Unlikely? No.
6
  • 1
    I think this would be a lot stronger (and more relevant) an answer without the 2nd half.
    – Paul Gear
    Nov 8, 2019 at 5:38
  • 2
    Great answer, and thanks for the background information
    – leon.io
    Nov 19, 2019 at 13:34
  • Additional tip that solved my problem with the same message: be sure to have your CaSinG correct. For Directory path as well as the Dockerfile. Since linux is pretty picky about that.
    – RaimondB
    Jul 3, 2020 at 19:57
  • 2
    Filename did the trick for me. I had to change DockerFile to Dockerfile
    – Junaid
    Nov 25, 2020 at 7:51
  • 2
    Likewise, check for simple spelling errors. I landed here because Dockefile is certainly not the same as Dockerfile :facepalm: Since building with docker build -f <tab-completed filename> . worked, I looked closer and realized I had mistyped it.
    – Saites
    Dec 20, 2020 at 21:27
46

If you are working on Windows 8, you would be using Docker toolbox.

From the mydockerbuild directory, run the below command as your Dockerfile is a textfile:

docker build -t docker-whale -f ./Dockerfile.txt .
4
  • 4
    for future reference if you need to do this it is because your Dockerfile has an extension whereas by default Docker expects it not too. Setting the file manually with the extension adds headaches you do not need. You should set Windows explorer to show extensions and then remove the extension.
    – Alex
    Dec 11, 2017 at 19:08
  • if you're following along on the docker documentation "getting started" tutorial you would use this: docker build -t friendlyhello -f ./Dockerfile.txt . Jan 31, 2018 at 3:23
  • Its really bad semantics that you have to specify the file name and the dummy path also. and/or always name your file as Dockerfile.. :-(
    – myloginid
    Mar 26, 2018 at 6:20
  • This saved my day. By the way, I'm using a Mac machine. But the catch here is that the Dockerfile was created a plain text file. Thanks buddy for the help. Sep 14, 2019 at 20:06
28

The name of the file should be Dockerfile and not .Dockerfile. The file should not have any extension.

27
  1. Make sure you moved to the directory where Dockerfile is located.
  2. Make sure your Dockerfile is extension-less. That is, not Dockerfile.txt, Dockerfile.rtf, or any other.
  3. Make sure you named Dockerfile, and not DockerFile, dockerfile or any other.
1
  • big help on the Dockerfile instead of DockerFile Apr 6, 2022 at 16:22
20

I had named my file dockerfile instead of Dockerfile (capitalized), and once I changed that, it started processing my "Dockerfile".

1
  • 1
    I cloned a json file instead of creating a new file. Once i renamed it to Dockerfile and updated it contents, it didn't show .json extension and later realised thats the culprit! Thanks for the note!
    – Ayyappa
    Aug 1, 2020 at 17:09
16

Just remove the extension .txt from Dockerfile and run the command

docker build -t image-name

It will work for sure.

0
10

I have got this error (in a MacBook) though I used the correct command to create the image,

docker build -t testimg .

Later I found that the path is the problem. Just navigate to the correct path that contains the Docker file. Just double check your current working directory. Nothing to panic about!

5

This command worked for me:

docker build -t docker-whale -f Dockerfile.txt .
1
  • 1
    Dockerfile is not a .txt file. If you have it as a .txt file it will give error again. Nov 20, 2019 at 7:21
5

That's just because Notepad add ".txt" at the end of Dockerfile.

1
4

I had created my DockerFile by the Visual Studio 2017 Docker Support tool and had the same error.

After a while, I realised I was not in the correct directory that contains the Dockerfile (~\source\repos\DockerWebApplication\). I cd'ed to the correct file (~/source/repos/DockerWebApplication/DockerWebApplication) which was inside the project and successfully created the Docker image.

1
  • DockerFile is the wrong file name. It should be Dockerfile. Dec 12, 2022 at 22:45
4

In WSL, there seems to be a problem with path conversion. The location of the Dockerfile in Ubuntu (where I'm running Docker and where Dockerfile lives) is "/home/sxw455/App1", but neither of these commands worked:

$ pwd

/home/sxw455/App1

$ ll

total 4
drwxrwxrwx 0 sxw455 sxw455 4096 Dec 11 19:28 ./
drwxr-xr-x 0 sxw455 sxw455 4096 Dec 11 19:25 ../
-rwxrwxrwx 1 sxw455 sxw455  531 Dec 11 19:26 Dockerfile*
-rwxrwxrwx 1 sxw455 sxw455  666 Dec 11 19:28 app.py*
-rwxrwxrwx 1 sxw455 sxw455   12 Dec 11 19:27 requirements.txt*

$ docker build -t friendlyhello .

unable to prepare context: unable to evaluate symlinks in Dockerfile path: GetFileAttributesEx C:\Windows\System32\Dockerfile: The system cannot find the file specified.

$ docker build -t friendlyhello "/home/sxw455/App1"
unable to prepare context: path "/home/sxw455/App1" not found

But in Windows, the actual path is:

C:\Users\sxw455\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc\LocalState\rootfs\home\sxw455\App1

And so I had to do this (even though I ran it from Bash):

$ docker build -t friendlyhello

"C:\Users\sxw455\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc\LocalState\rootfs\home\sxw455\App1"

Sending build context to Docker daemon   5.12kB
Step 1/7 : FROM python:2.7-slim
 ---> 0dc3d8d47241
Step 2/7 : WORKDIR /app
 ---> Using cache
 ---> f739aa02ce04
Step 3/7 : COPY . /app
 ---> Using cache
 ---> 88686c524ae9
Step 4/7 : RUN pip install --trusted-host pypi.python.org -r requirements.txt
 ---> Using cache
 ---> b95f02b14f78
Step 5/7 : EXPOSE 80
 ---> Using cache
 ---> 0924dbc3f695
Step 6/7 : ENV NAME World
 ---> Using cache
 ---> 85c145785b87
Step 7/7 : CMD ["python", "app.py"]
 ---> Using cache
 ---> c2e43b7f0d4a
Successfully built c2e43b7f0d4a
Successfully tagged friendlyhello:latest
SECURITY WARNING: You are building a Docker image from Windows against a non-Windows Docker host. All files and directories added to build context will have '-rwxr-xr-x' permissions. It is recommended to double check and reset permissions for sensitive files and directories.

I had similar problems with environment variables during the initial installation, and followed some advice that said to install the Windows DockerCE and hack the environment variables rather than installing the Ubuntu DockerCE, because (I hope I remembered this correctly) that WSL does not fully implement systemctl. Once the Windows Docker CE installation is done and environment variables are set, docker then works fine under WSL/Ubuntu.

1
  • This worked for me! I only installed Docker Toolbox and didn't install it in WSL; instead, I'm using the windows executables directly, since WSL can do that now. Jan 2, 2019 at 0:50
3

Two ways to build a dockerfile:

You can decide not to specify the file name of which to build from and just build it specifying a path (doing it this way the file name must be Dockerfile with no extension appended, eg: docker build -t docker-whale:tag path/to/Dockerfile

or

You can specify a file with -f and it doesn't matter what extension (within reason .txt, .dockerfile, .Dockerfile etc..) you decide to use, eg docker build -t docker-whale:tag /path/to/file -f docker-whale.dockerfile.

3

The error means that docker build is either using a PATH | URL that are incorrectly input or that the Dockerfile cannot be found in the current directory. Also, make sure that when running the command from an integrated terminal (e.g. bash inside your IDE or text editor) you have the admin permissions to do so. Best if you can check the PATH from your terminal with pwd (in bash shell or dir if using a simple cli on windows) and copy the exact path where you want the image to be build.

docker build C:\windows\your_amazing_directory

docker build --help will also show you available options to use in case of malformed or illegal commands.

3

In Windows 10, period is the first parameter:

docker build . -t docker-whale

1
  • 14
    not anymore (if ever) docker build -t docker-whale . is a valid command
    – sebagomez
    Jun 20, 2017 at 1:16
2

Be sure your DOCKERfile is in the ROOT of the application directory, I had mine in src which resulted in this error because Docker was not finding the path to DOCKERfile

1
  • Is this a bogus answer? The name of the file is Dockerfile, not DOCKERfile. Dec 12, 2022 at 23:16
2

Make sure you run the command

docker build . -t docker-whale 

from the directory that has the dockerfile

1
  • This seems to be repeat of previous answers. Dec 12, 2022 at 23:25
2

Installing docker.io instead of docker helped me

i.e.

apt install docker.io
2
2

I had originally created my Dockerfile in PowerShell and though I didn't see an extension on the file it showed as a PS File Type...once I created the file from Notepad++ being sure to select the "All types (.)" File Type with no extension on the File Name (Dockerfile). That allowed my image build command to complete successfully...Just make sure your Dockerfile has a Type of "File"...

2

The problem is that the file name should be Dockerfile and not DockerFile or dockerfile. It should be D capital followed by ockerfile in lowercase. Please note.

2

I my case (run from Windows 10):

  1. Rename the file myDockerFile.Dockerfile to Dockerfile (without file extension).

Then run this command from outside the folder:

docker build .\Docker-LocalNifi\

This is working for me and for my colleagues at work.

1

To build Dockerfile, save the automated content in Dockerfile. Not Dockerfile because while opening a file command:

notepad Dockerfile

(A text file is written so the file cannot build.)

To build the file, run:

notepad Dockerfile

and now run:

docker build -t docker-whale .

Make sure you are in the current directory of Dockerfile.

1
  • What do you mean by the first part? That file Dockerfile can not be changed while it is open in Notepad? Dec 12, 2022 at 22:20
1

Most importantly, make sure your file name is Dockerfile. If you use another name it won't work (at least it did not for me).

Also if you are in the same directory where the Dockerfile is use a ., i.e.,

docker build -t Myubuntu1:v1 .

Or use the absolute path, i.e.,

docker build -t Myubuntu1:v1 /Users/<username>/Desktop/Docker

1

Make sure file name "Dockerfile" is not saved with any extension. Just create a file without any extension.

And make sure Dockerfile is in the same directory from where you are trying to build the Docker image.

1

In case if we have multiple Docker files in our environment just Dockerfile won’t suffice for our requirement.

docker build -t ihub -f Dockerfile.ihub .

So use the file (-f argument) command to specify your docker file (Dockerfile.ihub).

2
0

I erroneously created Dockerfile.txt in my working directory leading to the above-mentioned error while build

The fix was to remove the .txt extension from the file.

The file name should be Dockerfile only without any extension.

0

Execute docker build -t getting-started . in your project directory and make sure Dockerfile is present and having no .txt extension. If you are on Windows, check the 'file name extension' in the under the view tab in the File Explorer to show whether .txt is there or not and remove it if the former is true. Good Luck.

0

If you have mounted a second drive to an NTFS folder as a 'mounted volume' then you can get this issue.

Move you files to a drive location outside of the mounted volume.

2
0

docker build -t docker-whale -f DockerFile .

1
  • 1
    How is this different from the previous answers? What is it supposed to do? Dec 12, 2022 at 23:29
0

I got this on Windows when the path I was working in was under a junction point directory. So my fix was to not work under that path.

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