Upgrading on Docker Standalone
Always match the agent version to the Portainer Server version. In other words, when you're installing or upgrading to Portainer 2.18.3 make sure all of the agents are also on version 2.18.3.
Before beginning any upgrade, we highly recommend taking a backup of your current Portainer configuration.
Starting from Portainer CE 2.9 and BE 2.10, HTTPS is enabled by default on port
9443.These instructions will configure Portainer to use 9443 for HTTPS and do not expose 9000 for HTTP. If you need to retain HTTP access, you can add:
to your command.
You can also choose to completely disable HTTP after the upgrade. Before you make Portainer HTTPS only, make sure you have all your Agents and Edge Agents already communicating with Portainer using HTTPS.
This article assumes that you used our recommended deployment scripts.
To upgrade to the latest version of Portainer Server, use the following commands to stop then remove the old version. Your other applications/containers will not be removed.
docker stop portainer
docker rm portainer
Now that you have stopped and removed the old version of Portainer, you must ensure that you have the latest version of the image locally. You can do this with a
docker pull portainer/portainer-ee:latest
docker pull portainer/portainer-ce:latest
Finally, deploy the updated version of Portainer:
docker run -d -p 8000:8000 -p 9443:9443 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ee:latest
docker run -d -p 8000:8000 -p 9443:9443 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest
docker runcommands include opening port
8000which is used for Edge Agent communication as included in our installation instructions. If you do not need this port open, you can remove it from the command.
To provide your own SSL certs you may use
--sslkeyflags as below to provide the certificate and key files. The certificate file needs to be the full chain and in PEM format. For example, for Business Edition:
docker run -d -p 8000:8000 -p 9443:9443 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ee:latest --sslcert /path/to/cert/portainer.crt --sslkey /path/to/cert/portainer.key
The newest version of Portainer will now be deployed on your system, using the persistent data from the previous version, and will also upgrade the Portainer database to the new version.
When the deployment is finished, go to
http://your-server-address:9000and log in. You should notice that the update notification has disappeared and the version number has been updated.
To upgrade to the latest version of Portainer Agent, use the following commands to stop then remove the old version. Your other applications/containers will not be removed.
docker stop portainer_agent
docker rm portainer_agent
Next, pull the updated version of the image:
docker pull portainer/agent:latest
Finally, start the agent with the updated image:
docker run -d -p 9001:9001 --name portainer_agent --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v /var/lib/docker/volumes:/var/lib/docker/volumes portainer/agent:latest
If you have set a custom
AGENT_SECRETon your Portainer Server instance you must remember to explicitly provide this when updating your agent: