Requirements

Portainer is comprised of two elements, the Portainer Server, and the Portainer Agent. Both elements run as lightweight Docker containers on a Docker engine.

By default, Portainer will expose the UI over the port 9000 and expose a TCP tunnel server over the port 8000. The latter is optional and is only required if you plan to use the Edge compute features with Edge agents.

Every single release of Portainer goes through an extensive testing process (functional tests, release tests, post release tests) to ensure that what we are creating actually works as expected. Obviously though, we cannot possibly test Portainer against every single configuration variant out there, so we have elected to test against just a subset.

To try and alleviate confusion as to what we test against, we have documented the configurations that we personally validate as "functional"; any other variant is not tested (this does not mean it won't work, it just means its not tested).

Validated Configurations

Portainer Version Release Date Docker Version Kubernetes* Version Architectures
Community 2.6.1 (latest) July 12, 2021 20.10.5 / 20.10.6 1.19 1.20.2 1.21 ARM64, x86_64
Community 2.6.0 June 25, 2021 20.10.5 / 20.10.6 1.19 1.20.2 1.21 ARM64, x86_64
Community 2.5.1 May 18, 2021 20.10.5 / 20.10.6 1.19 1.20.2 1.21 ARM64, x86_64
Community 2.5.0 May 18, 2021 20.10.5 1.19 1.20.2 1.21 ARM64, x86_64
Community 2.1.x Feb 2, 2021 20.10.2 1.20.0 ARM64, x86_64
Community 2.0.1 Jan 7, 2021 20.10.0 1.17.13 1.18.9 1.19.3 1.20.0 ARM64, x86_64
Community 2.0 Aug 31, 2020 19.03.12 1.17.13 1.18.6 1.18.9 1.19.3 ARM64, x86_64
1.24.1. July 23, 2020 19.03.12 N/A ARM32, ARM64, x86_64
1.24.0 June 2, 2020 19.03.10 N/A ARM32, ARM64, x86_64
1.23.2 March 25, 2020 19.03.6 N/A ARM32, ARM64, x86_64

*RBAC needs to be enabled on Kubernetes for Portainer Access Control

Notes

If you report a bug for a configuration that is not on the list above, we will ask you to first update your environment to match a validated configuration before continuing.

Business Edition Validated Configurations can be found here

Contribute to these docs