How to Update a Docker Container using Portainer

  • Post author:WunderTech
  • Post published:February 18, 2021
  • Post last modified:November 14, 2023
  • Post category:Docker
  • Reading time:6 mins read

Today we are going to look at how to update a Docker container using Portainer.

There are many different ways to update Docker containers, but Portainer makes the process somewhat straightforward.

To demo how to update a Docker container using Portainer, I will be updating an Nginx Proxy Manager container. Currently, I’m running an old version (2.3.1) and we will be updating that to the latest version.

Before starting this process, ensure that your container is created properly and volumes exist with your important data. If the data is not mapped to a local folder, it will be overwritten with the latest image data.

How to Update a Docker Container using Portainer

Before you can update Docker Containers with Portainer, you must install Portainer.

Installing Portainer

1. Download and run the Portainer Container by running the commands below.

sudo docker run -d -p 8000:8000 -p 9000:9000 -p 9443:9443 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest
how to install docker and portainer on debian - downloading the portainer container

2. This will install Portainer and it will be accessible by the workstation’s IP address and port 9000. When you get there, create a username and password.

http://[WORKSTATION_IP_ADDRESS]:9000
portainer debian - creating an account for portainer

3. Select Docker and Connect.

portainer debian - connecting to the local docker instance
4. Select Local.

local docker instance

Updating Docker Containers Using Portainer

Now that Portainer is installed, you can run the steps below to update Docker Containers.

1. Select Containers, then stop the container that you’d like to update.

portainer update docker container - nginx proxy manager container

2. Select the container, and you’ll see a button named Recreate. By selecting this button, the container will take the persistent data and recreate the container. Keep in mind that the only data that will stay on the container is data that was mapped to a volume. This is explained in greater detail in the video above.

portainer update docker container - portainer recreate button

3. Select Pull latest image, then Recreate.

portainer update docker container - downloading latest container

4. When this process is finished, the container will be recreated with the latest image. Select the container and Start it. The status will change to running.

portainer update docker container - update a docker container using portainer

5. The container will now exist with the newest released version!

new nginx proxy manager version showing it was updated

Conclusion & Final Thoughts

This tutorial looked at how to update a Docker Container using Portainer. As I stated above, this is not the only way of doing this. There are various ways, but this is what I consider to be the easiest. It’s good to periodically check and ensure that your containers are running the latest version.

Keep in mind that you can always recreate an existing container using an older version if you run into any unexpected problems. This is what makes Docker containers so easy to work with!

Thanks for checking out the tutorial on how to update a Docker Container using Portainer. If you have any questions, feel free to leave them in the comments!