I'm working on a dockerfile.
I just realised that I've been using FROM
with indexed images all along.
So I wonder:
- How can I use one of my local (custom) images as my base (
FROM
) image withoutpushing
it to the index?
You can use it without doing anything special. If you have a local image called blah
you can do FROM blah
. If you do FROM blah
in your Dockerfile, but don't have a local image called blah
, then Docker will try to pull it from the registry.
In other words, if a Dockerfile does FROM ubuntu
, but you have a local image called ubuntu
different from the official one, your image will override it.
docker image list
.
Commented
May 22, 2020 at 12:40
docker image ls
Commented
Nov 6, 2020 at 2:05
For anyone who faces this issue in the future, where you have the image in your local but docker build
still tries to pull the image from docker hub, the problem might be that the architecture types are different.
You can check the architecture of the image using
docker inspect --format='{{.Os}}/{{.Architecture}}' IMAGE_NAME
Now in your Dockerfile
change FROM IMAGE_NAME
to something like FROM --platform=linux/amd64 IMAGE_NAME
and docker would now use the local image.
Verified: it works well in Docker 1.7.0.
Don't specify --pull=true
when running the docker build
command
From this thread on reference locally-built image using FROM at dockerfile:
If you want use the local image as the base image, pass without the option
--pull=true
--pull=true
will always attempt to pull a newer version of the image.
-
character (my-image
for example) in name then your docker will not resolve this image locally, I don't know why, anyway to fix it simply not use -
character, tested on docker-compose 1.8 and docker 1.11
Commented
Jun 20, 2016 at 22:25
Docker version 17.06.2-ce, build cec0b72
, but make sure if you tagged your image you include the tag as part of the image specification (FROM localimage:tag).
I had to disable BUILDKIT
on a mac with M1 to be able to use a local image.
You can do it by setting the DOCKER_BUILDKIT
environment variable to 0.
DOCKER_BUILDKIT=0 docker build -t YOUR_TAG --pull=false .
For anyone with a MAC os m1 architecture I needed to add the --platform=linux/amd64
parameter before the base image. Example
FROM --platform=linux/amd64 baseImage:tag
I found that that if you are using docker-compose.yml
, you can move the platform parameter in the service section, a lot more clean:
version: "3.7"
services:
test:
platform: linux/amd64
image: baseImage
You can have - characters in your images. Assume you have a local image (not a local registry) named centos-base-image with tag 7.3.1611.
docker version
Client:
Version: 1.12.6
API version: 1.24
Package version: docker-common-1.12.6-16.el7.centos.x86_64
Go version: go1.7.4
Server:
Version: 1.12.6
API version: 1.24
Package version: docker-common-1.12.6-16.el7.centos.x86_64
Go version: go1.7.4
docker images
REPOSITORY TAG
centos-base-image 7.3.1611
Dockerfile
FROM centos-base-image:7.3.1611
RUN yum -y install epel-release libaio bc flex
Result
Sending build context to Docker daemon 315.9 MB
Step 1 : FROM centos-base-image:7.3.1611
---> c4d84e86782e
Step 2 : RUN yum -y install epel-release libaio bc flex
---> Running in 36d8abd0dad9
...
In the example above FROM
is fetching your local image, you can provide additional instructions to fetch an image from your custom registry (e.g. FROM localhost:5000/my-image:with.tag
). See https://docs.docker.com/engine/reference/commandline/pull/#pull-from-a-different-registry and https://docs.docker.com/registry/#tldr
Finally, if your image is not being resolved when providing a name, try adding a tag to the image when you create it
This GitHub thread describes a similar issue of not finding local images by name.
By omitting a specific tag, docker will look for an image tagged "latest", so either create an image with the :latest tag, or change your FROM
On M1 mac I had to both specify image platform and name:tag
FROM --platform=linux/amd64 myimagename:2.0.0.a
i.e.
docker build . --tag chrome-nodejs-java --platform=linux/amd64
,FROM
docker images
with specific name and tag (not tag latest
), then you must specify that tagMuch simpler way may be just using IMAGE ID.
FROM c08a03a92df0
Anyways use docker images
more often.
It does not list platforms of images.
For that use docker inspect imagenameOrID
or docker inspect --format='{{.Os}}/{{.Architecture}}' imagenameOrID
So in my case it did not worked for myimagename (as there was no latest
, i.e. built without tag), but worked for myimagename:2.0.0.a
In other words, if docker images
does not have your image with tag latest
, then you cannot use FROM
without specific version tag
Thanks to above highvoted answers by @jpetazzo, @Anuj Bansal and @SomeGuy.
Remember to put not only the tag but also the repository in which that tag is, this way:
docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
elixir 1.7-centos7_3 e15e6bf57262 20 hours ago 925MB
You should reference it this way:
elixir:1.7-centos7_3
26.1.4
docker context use default
Thanks @ben-whaley
23.0
and before 26.1.4
docker buildx use default
Since Docker 23.0, docker build
has become an alias for docker buildx build
.
You might be using a custom builder instance, set the builder instance to default
with this command and run your build command again.
You can list your builder instances with this command:
Since 26.1.4:
docker context ls
Before 26.1.4:
docker buildx ls
You should see a wildcard next to the default builder.
NAME/NODE DRIVER/ENDPOINT STATUS BUILDKIT PLATFORMS
mybuilder docker-container
mybuilder0 unix:///var/run/docker.sock running v0.12.1 linux/arm64*, linux/amd64, linux/amd64/v2, linux/amd64/v3, linux/386
default * docker
default default running v0.11.6+0a15675913b7 linux/amd64, linux/amd64/v2, linux/amd64/v3, linux/386
docker buildx build
solved the problem for me.
docker context use default
. This solved it for me when nothing else did.
Commented
Jul 17 at 23:17
I just ran into this on an M1 Mac with engine version 20.10.14. It wasn't obvious from docker build --help
, but passing --pull=false
worked for me.
This is a dumb workaround but... if your image has the name blah
and an id b2d34289abae
, then you could change the FROM
line in your docker file from
FROM blah
to
FROM b2d34289abae
You can get the image ids by doing docker images
I would just treat that as a temporary workaround however for like local testing or something along those lines.
For users with M1 chips, problem can be arisen when platform differs of local image differs from target Dockerfile. In my case, I've built base image with M1 support and then tried to use command FROM
in image that was building with platform linux/amd64
Our /etc/docker/daemon.json
had a line declaring
"disable-legacy-registry" : true,
With that line in, the local registry was refusing access.
With it removed, it's working.
For latest Docker versions that happens because you haven't pointed base image platform type so you should:
docker build --platform=${DESIRED_PLATFORM} -t ${TAG} .
Try to define pull_policy: never
in your docker-compose.yml
's service record:
services:
app:
build:
context: ./
dockerfile: Dockerfile
image: my/image:latest
pull_policy: never
...
Read the specification for more information about:
https://github.com/compose-spec/compose-spec/blob/main/spec.md#pull_policy