Updating Portainer

Portainer releases contain new features and bug fixes so it's important to keep your installation up to date. We have tested and validated all Portainer version upgrades from 2.0.0 up to the latest release.

While it's possible that an untested unvalidated update path might work, we recommend that all update paths are tested and validated on a non-critical system before applying them to your production systems.

We added a backup and restore feature to Portainer BE 2.7 and strongly recommend that you take a backup of your Portainer instance before updating.

Starting with CE 2.9 and BE 2.10 Portainer is HTTPS enabled by default and uses port 9443 to serve the UI. HTTP can still be enabled on port 9000 if required.

Update order

In general, we recommend updating your Portainer Server deployment before you update the Portainer Agents. When we release new versions of Portainer we ensure that Portainer Server is able to talk to older versions of the Agent, and in most cases the reverse is true, but in some instances we make changes to the Agent that are not fully backward compatible with older versions of Portainer Server.

Updating Portainer

From within Portainer

Updating from within Portainer to STS versions (or within STS versions) is currently not available. Only LTS versions will be offered through the in-app update. To switch to or update to STS versions, follow the manual instructions below.

From 2.19, Business Edition users are able to update their Portainer installation directly from within Portainer. To do so, click the Update now link in the update notification in the bottom left of the Portainer UI.

In the confirmation dialog, click Start update to proceed with the update.

Remember to back up your Portainer installation before updating!

Manually update Portainer

If you would prefer to manually update your Portainer installation, choose your platform then follow the instructions:

Updating on Docker StandaloneUpdating on Docker SwarmUpdating on Kubernetes

If you are coming from the Portainer 1.x branch, there are steps you must follow in order to update successfully:

Updating from Portainer 1.x

Update the Portainer Agent

To update the standard (non-Edge) Portainer Agent, you can find instructions in the above platform-specific links (Docker Standalone, Docker Swarm, and Kubernetes).

If you are using the Portainer Edge Agent, we have specific update instructions for you:

Updating the Edge Agent

Upgrading to Business Edition

If you are coming from Portainer CE and want to move to BE, we have guides for you as well.

Switching to Portainer Business Edition