Docker images within a running container do not update automatically. Once you have used an image to create a container, it continues running that version, even after new releases come out.
It is recommended to run containers from the latest Docker image unless you have a specific reason to use an older release.
In this tutorial, you will learn how to update the Docker image and container to the latest version.
- Access to a command line/terminal window
- A user account with sudo privileges
- An existing Docker installation
- An existing Docker container and Docker image
Update Docker Image and Container to the Latest Version
The best way to update an existing container with the newest image is to download the latest image and launch a new container with the same configuration. Follow the steps listed below to update your container with the newest Docker image.
Note: This tutorial uses an example of running a MySQL Docker container to illustrate how to update the Docker image and container to the latest version.
Step 1: Check Current Version
Verify you have an outdated image, by listing the images on your system with the command:
sudo docker images
The output displays downloaded images and their tags (version numbers). In the example below, the system shows it is using the mysql image version 5.7.31. Docker’s official MySQL images listed on DockerHub show that the latest version is 8.0.21.
Therefore, if you have a container running on that image, it is best to update it.
Note: To list only a specific image that may be outdated, use the docker images | grep [docker_image] command to narrow the search.
Step 2: Pull the Latest Image
Download the newer version of the image using the
docker pull command:
docker pull [docker_image]
By default, Docker pulls the latest version. To ensure it does so, you can add the
For instance, to pull the latest mysql image, you would run:
docker pull mysql/mysql-server:latest
Step 3: Launch a New Updated Container
Once you downloaded the latest Docker image, you need to stop and remove the old container. Then, create a new one with the latest image.
1. Find the name of the running container with the outdated image by listing the containers on the system:
In this example, the output shows a container using the mysql/mysql-server:5.7.31 image.
2. Stop and remove the existing container so you can launch a new one under the same name:
docker stop [container_id]
docker rm [container_id]
3. Recreate the container with the
docker run command and the wanted configuration, using the updated Docker image:
docker run --name=[container_name] [options] [docker_image]
If you have one, make sure to mount a Docker volume assigned to the previously used container to ensure the updated container has the same content. To do this, use the
-v option followed by the path to the volume directory.
For instance, to run an update MySQL container, you would run:
docker run --name=mysql --restart=always -e MYSQL_ROOT_PASSWORD=mypassword -v /path/to/directory:/var/lib/mysql -d mysql
4. You can check whether your container has been updated with the latest Docker image by listing the containers with:
sudo docker ps
With this, you should have successfully updated your Docker container with the latest release of a Docker image.
Want to learn more about managing containers? Read all about best practices for managing Docker containers.