2.14.2

See Upgrading Portainer instructions.

Overview of changes

New Portainer CE 2.14.2 release

Kubernetes:

• Fixed an issue where the kubeconfig downloadable from Portainer always had port 9443 in its URLs, even though the actual Portainer instance was being accessed via another port. https://github.com/portainer/portainer/issues/7059

Docker:

• Fixed certificate file validation for .pem files. https://github.com/portainer/portainer/issues/7183

Portainer:

• Fixed an issue where the original admin user was unable to change their password when external authentication is enabled. https://github.com/portainer/portainer/issues/7291
• Fixed toggle state reset issue for custom logo and anonymous statistics. https://github.com/portainer/portainer/issues/7278
• Fixed issue with not being able to add users to teams while LDAP authentication is enabled without auto teams population. https://github.com/portainer/portainer/issues/7252

Edge:

• Fixed pagination issue on Add edge jobs page for listed environments. https://github.com/portainer/portainer/issues/7312

2.14.1

See Upgrading Portainer instructions.

Known issues:

• There is an issue when using a Mustache variable (e.g. {{service}}) multiple times in the YAML, where the UI also prompts for it multiple times, rather than prompting for it a single time and then reusing it.

Overview of changes

New Portainer CE 2.14.1 release

Docker:

• Resolved an issue where users running Portainer with non-root access were receiving a 'Permission denied on docker-compose' error since the recent update to v2 Docker Compose. https://github.com/portainer/portainer/issues/6906

Portainer:

• Resolved an issue where users upgrading a Portainer install, where the portainer_data volume is stored on a network volume, receive a 'Permission denied' error when the upgrade attempts a backup of the database. https://github.com/portainer/portainer/issues/7144
• Fixed "Create user" button in disabled stage when external Auth enabled. https://github.com/portainer/portainer/issues/7214

Edge:

• Fixed issue where the edge agent could not connect when running Portainer behind a reverse proxy only supporting TLS v1.2. https://github.com/portainer/portainer/issues/7167

2.14.0

See Upgrading Portainer instructions.

Known issues:

• Known issue with manually adding an Edge Device environment through the edge device page when using Async mode, does not retain Async settings and needs to be manually added through the environment details page.

Breaking changes:

• With the upgrade to Docker Compose V2, container names now use hyphens as separators instead of underscores. This may affect you if you are generating container names instead of explicitly defining them, then using them as references.

Overview of changes

New Portainer CE 2.14.0 release

Kubernetes:

• Fixed issue around Git clone working with Main (in addition to existing Master) branch type. https://github.com/portainer/portainer/issues/6002
• Updated packaged components to recent stable release versions: Docker 20.10.9, Docker Compose plugin 2.5.1, kubectl 1.24.1, Helm 3.9.0. https://github.com/portainer/portainer/issues/6074
• Fixed a typo in the Kubernetes -> Namespaces -> Create from manifest (advanced deployment) page. https://github.com/portainer/portainer/issues/6968

Docker:

• Fixed issue around Git clone working with Main (in addition to existing Master) branch type. https://github.com/portainer/portainer/issues/6002
• Updated packaged components to recent stable release versions: Docker 20.10.9, Docker Compose plugin 2.5.1, kubectl 1.24.1, Helm 3.9.0. https://github.com/portainer/portainer/issues/6074
• Fixed issue for standard user having an empty network as default when creating containers on Windows environments https://github.com/portainer/portainer/issues/6959
• Provide a stack template for dokku deployment within portainer. https://github.com/portainer/portainer/issues/7011
• Resolved an issue when updating an application and changing its service from replicated to global, where an error occurs and the deployed application is deleted. https://github.com/portainer/portainer/issues/7056
• Third-party developer Inedo has fixed their ProGet registry software to resolve an intermittent error admins were experiencing in Portainer on retag or delete of a tagged image. This is planned to ship 10 June 2022 in ProGet 6.0.16, before Portainer 2.14. https://github.com/portainer/portainer/issues/7073
• Fixed an issue where, when calling Swarm update API through Portainer, incorrect overriding of the registry authentication header occurred, preventing pull of an image. https://github.com/portainer/portainer/issues/7095
• Fixed an issue where the Docker binary was not being downloaded on Mac platforms. https://github.com/portainer/portainer/issues/7114

Portainer:

• Redesigned team leader feature. https://github.com/portainer/portainer/issues/7093
• Provided demo flag for running Portainer Community Edition in demo mode https://github.com/portainer/portainer/issues/6992
• Fixed an issue where the delete environment confirmation dialog was positioned too low on-screen. https://github.com/portainer/portainer/issues/6983
• Fixed an issue where agent and edge agent install command instructions do not list the agent_secret option. https://github.com/portainer/portainer/issues/6801
• Fixed an issue where the home (environments) page no longer showed the words 'No tags' for environments without tags. https://github.com/portainer/portainer/issues/6967
• The Add environment page and Environment wizard are now consolidated into a single consistent, improved wizard-style experience. https://github.com/portainer/portainer/issues/7022
• Fixed Go panic state for the environments list handler https://github.com/portainer/portainer/issues/7047
• Introduced ability for admin to set required password length. https://github.com/portainer/portainer/issues/7055
• Increased the click/touch area in expandable panels so it's easier to open/close them. https://github.com/portainer/portainer/issues/7036
• The 'Connected environments' title in the environment wizard is now 'New environments', as only those environments set up in that wizard session now show there. https://github.com/portainer/portainer/issues/7079

Edge:

• Fixed issue with status indicator on Edge Stacks not updating when removing tags from edge environments/groups https://github.com/portainer/portainer/issues/6950
• For edge agents, the URL shown in the Environment summary page (access from the Home page) has now been removed, as it caused confusion since it simply showed the Portainer Server URL. https://github.com/portainer/portainer/issues/6978
• Fixed Data race in the operations of the edge key in the Edge Agent https://github.com/portainer/portainer/issues/7024
• Added "goto page" to the Edge devices page view https://github.com/portainer/portainer/issues/6982
• Added the ability to add edge agents in the environment wizard https://github.com/portainer/portainer/issues/7023

Nomad:

• Added display of BE feature highlights in CE for new Nomad, KaaS provisioning and kubeconfig import functionality. https://github.com/portainer/portainer/issues/7051

2.13.1

See Upgrading Portainer instructions.

Portainer:

• Changed the minimum TLS version of Portainer from 1.3 to 1.2 to avoid issues with nginx reverse proxies: https://github.com/portainer/portainer/issues/6902
• Fixed issue with the Portainer authentication settings page not being able to save: https://github.com/portainer/portainer/issues/6899
• Changed the password policy to require 12 characters for all Portainer internal users: https://github.com/portainer/portainer/issues/6904

2.13.0

See Upgrading Portainer instructions.

Breaking change

• The minimum TLS version of Portainer was changed from 1.2 to 1.3. If you are running a proxy in front of Portainer with HTTPS you will need to ensure it is configured to support TLS 1.3: https://github.com/portainer/portainer/issues/6902
• Added strong password policy for all Portainer internal users. When using a weak password and logging in you will be required to update your password.

Overview of changes

New Portainer CE 2.13.0 release

Kubernetes:

• Fixed bug causing domain names to not displaying correctly under publish application options: https://github.com/portainer/portainer/issues/6841
• Fixed issue around deploying in default namespace via manifest using the Portainer namespace instead: https://github.com/portainer/portainer/issues/6831
• Improve how Portainer helps you set up ingresses (especially Nginx ones), including support of regular expressions in paths - by assisting with required annotations and correcting a rewrite issue: https://github.com/portainer/portainer/issues/6854
• Fixed an issue where, on setting up (on a namespace) an ingress controller for a k8s cluster and I create an app with two ingress routes on the controller, app details show only the second of the paths: https://github.com/portainer/portainer/issues/6856
• Fixed an issue where Portainer's validation of a K8s namespace's hostnames was disallowing wildcards (e.g. *abc.com): https://github.com/portainer/portainer/issues/6855
• Fixed issue with default helm repo not populating in settings page: https://github.com/portainer/portainer/issues/6849
• Created documentation around using GKE ingress with Portainer: https://github.com/portainer/portainer/issues/6848
• Added input validation for kubernetes workload names: https://github.com/portainer/portainer/issues/5363
• Fixed issue where changing Portainer to HTTPS crashed Portainer: https://github.com/portainer/portainer/issues/6836
• Fixed issue where Helm Charts could not be deployed when using SSL certs with Portainer: https://github.com/portainer/portainer/issues/6742
• Fixed issue of not being able to use a name previously used for kubernetes resources: https://github.com/portainer/portainer/issues/6830
• Fixed issue where the Kube cluster resource stats had a rounding issue: https://github.com/portainer/portainer/issues/6472
• Fixed an issue when deploying Portainer client with AGENT_SECRET without configuring Kubernetes agent with AGENT_SECRET where an "Failure unknown" error shows rather than "agent already paired" : https://github.com/portainer/portainer/issues/6791

Docker:

• Fixed issue where the Disable bind mounts for non-administrators setting would prevent existing volumes from being used: https://github.com/portainer/portainer/issues/6387
• Fixed issue with creating a CIFS volume that uses a hostname: https://github.com/portainer/portainer/issues/6338
• Fixed issue where webhooks for services were accepting invalid tags: https://github.com/portainer/portainer/issues/6493
• Fixed issue with libcompose logging where error output is attempted to be included when an error did not occur: https://github.com/portainer/portainer/issues/6857
• Fixed issue relating to Git stack update button being un-clickable : https://github.com/portainer/portainer/issues/6713
• Fixed an issue where 'Pull and Redeploy' and 'Force redeploy' don't work on ARM: https://github.com/portainer/portainer/issues/6788
• Improved the REST API documentation for images on private registries: https://github.com/portainer/portainer/issues/6712
• Fixed issue where credentials from different registries were being used: https://github.com/portainer/portainer/issues/6087
• Fixed issue where the stack name was displayed incorrectly: https://github.com/portainer/portainer/issues/6478
• Fixed issue with displaying container template when connected to docker swarm in the app templates page view: https://github.com/portainer/portainer/issues/6837
• Fixed text color on modal when updating a service: https://github.com/portainer/portainer/issues/6839

Portainer:

• Fixed trivy Helm and Portainer vulnerabilities relating to direct dependencies: https://github.com/portainer/portainer/issues/6342
• Enforced strong password policy for all Portainer Users: https://github.com/portainer/portainer/issues/6846
• Improved the database migration to become more resilient: https://github.com/portainer/portainer/issues/6778
• Introduced the ability to filter and sort environments on the Home page: https://github.com/portainer/portainer/issues/6823
• When changing the user password the user gets redirected to the login page: https://github.com/portainer/portainer/issues/6456
• Fixed issue where standard users were not able to generate API access tokens: https://github.com/portainer/portainer/issues/6753
• Improved security for custom templates when using Git repos that contain symlinks: https://github.com/portainer/portainer/issues/6847
• Improved how the installation page times out: https://github.com/portainer/portainer/issues/6740
• Fixed bug relating to environment status in home page: https://github.com/portainer/portainer/issues/6047
• Improved concurrency in agent code to prevent race conditions: https://github.com/portainer/portainer/issues/6677
• Improved concurrency in backend code to prevent race conditions: https://github.com/portainer/portainer/issues/6677
• Fixed duplicate naming issue for registries: https://github.com/portainer/portainer/issues/6838
• Fixed issue around user accessing agent environment after changing an invalid environment url to a valid one: https://github.com/portainer/portainer/issues/6824
• Fixed issue with the menu when connecting to another environment fails: https://github.com/portainer/portainer/issues/6449
• Updated registry form wording from Password to "Dockerhub access token" : https://github.com/portainer/portainer/issues/6308
• Fixed issue where Watchtower did not work for standalone stacks on Arm64: https://github.com/portainer/portainer/issues/5799
• Fixed an issue where the hover-over tooltip for nav menu items always just showed 'Settings' rather than the menu item text: https://github.com/portainer/portainer/issues/6779
• Fixed issue where the green success notification was not showing up after deleting a custom app template. https://github.com/portainer/portainer/issues/6724
• Improved UX for setting themes by removing save button: https://github.com/portainer/portainer/issues/6840

Edge:

• Fixed issue with edge job file content failing to load and issue with editing script content: https://github.com/portainer/portainer/issues/6845
• Resolved data race on stack deploy for edge agents: https://github.com/portainer/portainer/issues/6677
• Added environment variable to the agent to adjust the probe timeout and interval: https://github.com/portainer/agent/issues/293
• Introduce the ability to pass env variables from a local system on edge devices to the edge stack: https://github.com/portainer/portainer/issues/6832
• Fixed issue with edge environments having faulty heartbeat on Edge Devices page: https://github.com/portainer/portainer/issues/6825
• Improved concurrency in edge code to prevent race conditions: https://github.com/portainer/portainer/issues/6677
• Fixed data race in poll service on Edge Agent: https://github.com/portainer/portainer/issues/6677
• Resolved some race conditions with the edge agent: https://github.com/portainer/portainer/issues/6677
• Resolved data race on tunnels for edge agents: https://github.com/portainer/portainer/issues/6677
• Resolved data race with activity timer for edge agents: https://github.com/portainer/portainer/issues/6677
• Fixed issue with displaying AMT device table for non-activated devices: https://github.com/portainer/portainer/issues/6835
• Fixed minor UI issues in Edge devices page view around Action buttons: https://github.com/portainer/portainer/issues/6844
• Fixed issue when creating edge job from file returning 404: https://github.com/portainer/portainer/issues/6826

Development:

• Updated the Go library dependencies: https://github.com/portainer/portainer/issues/6777
• Migrated AngularJS components to ReactJS: https://github.com/portainer/portainer/issues/6031
• Reorganized the file structure of the agent installation yaml files: https://github.com/portainer/portainer/issues/6776
• Removed the integration with Storidge clusters: https://github.com/portainer/portainer/issues/6512

1.25.0

# Overview of changes

New Portainer CE 1.25.0 release

Users that deploy Portainer using portainer/portainer are using the old version 1 of Portainer, instead of version 2 which is deployed via portainer/portainer-ce.

Version 1.x of Portainer is no longer supported, maintained or enhanced. Continuing to use version 1 is at your own risk. Upgrade by using the tag portainer/portainer-ce:2.0.1

If you decide to stay on version 1, please use the tag portainer/portainer:1.24.2 to prevent automatically upgrading to version 2, as portainer:latest will be updated to version 2 from May.

Portainer:

• After logging in we notify the user to either upgrade or downgrade: https://github.com/portainer/portainer/issues/6723

2.11.1

See Upgrading Portainer instructions.

Known issues

The default Helm Repository defined in the Settings is not correctly populated and needs to be manually entered

Breaking change

• When OAuth is enabled, Portainer users can no longer use their Portainer internal password: https://github.com/portainer/portainer/issues/5889

Overview of changes

New Portainer CE 2.11.1 release

Kubernetes:

• Migrated to use the networking.k8s.io/v1 ingress API, available from Kubernetes v1.19: https://github.com/portainer/portainer/issues/6396
• Allow Services to be managed for Kubernetes applications, which can be deployed within Portainer or outside of it: https://github.com/portainer/portainer/issues/5941

Docker:

• Fixed issue where updating the Stack always recreated the containers: https://github.com/portainer/portainer/issues/6306
• Added the ability to filter the Swarm services published ports column: https://github.com/portainer/portainer/issues/6161
• Added a warning when the same Swarm secret is assigned multiple times to a service: https://github.com/portainer/portainer/issues/2821
• Added the option to detach Stacks deployed from Git to make them editable: https://github.com/portainer/portainer/issues/5748
• Removed the ability to edit the Portainer container: https://github.com/portainer/portainer/issues/5121
• Fixed issue where an error message would not be shown when failing to pull an image: https://github.com/portainer/portainer/issues/6239
• Fixed issue where the default user for the container console was incorrectly auto filled: https://github.com/portainer/portainer/issues/6315
• Fixed issue where uploading large files to a volume would fail: https://github.com/portainer/portainer/issues/4453
• Fixed issue where stacks deployed from App Templates behaved as if they were deployed from Git: https://github.com/portainer/portainer/issues/5748
• Fixed issue where stacks with environment variables in the networks section could not be removed: https://github.com/portainer/portainer/issues/5779

Portainer:

• Portainer users can no longer use their Portainer internal password when OAuth is enabled: https://github.com/portainer/portainer/issues/5889
• Option to encrypt values in Portainer database: https://github.com/portainer/portainer/issues/6412
• Added the ability to override the "Force HTTPS only" option: https://github.com/portainer/portainer/issues/6126
• Supporting the ability for Portainer to run inside a subpath: https://github.com/portainer/portainer/issues/3901
• Updated the defaults for the Git authentication toggles: https://github.com/portainer/portainer/issues/6406
• Fixed display issue for environment tags in the Home page view https://github.com/portainer/portainer/issues/6276
• Fixed issue where scrollbars would show in confirmation dialogs: https://github.com/portainer/portainer/issues/6257
• Fixed issue where the --sslcert flag was being ignored: https://github.com/portainer/portainer/issues/6021

Edge:

• Introduced the ability to control and interact with OpenAMT: devices https://github.com/portainer/portainer/issues/6444
• Introduce the ability to add edge devices through FDO: https://github.com/portainer/portainer/issues/6445
• Added behavior for Edge agents to reject connections if not connected to within 72hrs: https://github.com/portainer/portainer/issues/6420
• Optimize disk performance for Edge Agent https://github.com/portainer/portainer/issues/6455

Development:

• Upgraded golang version to 1.17 https://github.com/portainer/portainer/issues/6342
• Updated the Swagger documentation: https://github.com/portainer/portainer/issues/6019
• Deprecated EndpointProvider in the code and moving away from its use: https://github.com/portainer/portainer/issues/5524

2.11.0

See Upgrading Portainer instructions.

Known issues

• Deploying a manifest without a namespace definition and selecting the Default namespace in Portainer may deploy the application into the portainer namespace in certain circumstances

Overview of changes

New Portainer CE 2.11.0 release

Kubernetes:

• Restarting Portainer will no longer result in invalid kubeconfig credentials, which would have required the user to download a new kubeconfig file again: https://github.com/portainer/portainer/issues/5940
• Provides a single process so that users can gain access to all their environments contexts from within the Portainer UI: https://github.com/portainer/portainer/issues/5945
• Improved how a namespace gets selected when using Advanced deployment: https://github.com/portainer/portainer/issues/5557
• Added warning that a secret will be created when adding registry access to a namespace: https://github.com/portainer/portainer/issues/5845
• Fixed issue where selecting a Helm chart did not scroll to the top: https://github.com/portainer/portainer/issues/6146
• Fixed issue when clearing Helm repo in global settings and added text notification in Helm charts page: https://github.com/portainer/portainer/issues/5996
• Fixed issue where Helm charts fail to load in ARM cloud environments: https://github.com/portainer/portainer/issues/5937
• Fixed issue where the kubectl shell wasn't working when Portainer runs on ARM64: https://github.com/portainer/portainer/issues/5723
• Fixed bug so that Kubernetes terminology is used when deploying through Kubernetes: https://github.com/portainer/portainer/issues/6099
• Fixed issue where error notice was coming up when deleting an application through kubeshell: https://github.com/portainer/portainer/issues/5939
• Fixed issue where Portainer stacks were not being removed when removing a namespace: https://github.com/portainer/portainer/issues/5897
• Fixed issue where standard users were unable to access the pod and node stats view: https://github.com/portainer/portainer/issues/5898
• Fixed issue where the namespace details page showed an object object error: https://github.com/portainer/portainer/issues/5802
• Fixed issue when selecting Cluster Setup in the menu: https://github.com/portainer/portainer/issues/6033
• Fixed order of registries to be alphabetical in the select registry dropdown in namespaces: https://github.com/portainer/portainer/issues/6175
• Fixed issue with publishing method defaulting to Ingress when changing to Cluster IP: https://github.com/portainer/portainer/issues/6190

Docker:

• Allow the resource settings of a container to be updated without redeploying the container: https://github.com/portainer/portainer/issues/5906
• Added support for .bz2 and .xz compression formats when importing Docker images: https://github.com/portainer/portainer/issues/5220
• Enhancement of the Docker image import feature to support manually adding tags to the imported image: https://github.com/portainer/portainer/issues/5944
• Improved how to change the image when editing a Service by pre-populating the fields in the UI: https://github.com/portainer/portainer/issues/5150
• Fixed issue where automatic updates of stacks fail after restarting Portainer: https://github.com/portainer/portainer/issues/5914
• Fixed issue where pull and redeploy button was not functioning as expected: https://github.com/portainer/portainer/issues/5948
• Fixed UI issue when using a personal access token to deploy from Git: https://github.com/portainer/portainer/issues/5847
• Fixed issue where certain docker events showed as Unsupported: https://github.com/portainer/portainer/issues/2717
• Fixed issue with stack names when migrating from Swarm to docker standalone: https://github.com/portainer/portainer/issues/6139
• Fixed issue where migrating a stack shows up twice: https://github.com/portainer/portainer/issues/5159
• Fixed issue where using a webhook with an image registry running on a custom port did not work: https://github.com/portainer/portainer/issues/4526
• Fixed issue where downloading container log files added extra carriage returns: https://github.com/portainer/portainer/issues/5312
• Fixed issue where copying container log files added trailing commas: https://github.com/portainer/portainer/issues/4318
• Fixed issue where the scale labels of the stats graph was showing multiple times: https://github.com/portainer/portainer/issues/5843
• Fixed issue where stats were not working on windows containers: https://github.com/portainer/portainer/issues/5826
• Fixed UI issue with empty stack dropdown when deploying an application via the form: https://github.com/portainer/portainer/issues/5848
• Fixed issue with Custom Template on Docker being created when the file does not exist on a git repo: https://github.com/portainer/portainer/issues/6184

Portainer:

• The ability for users to easily interact with the Portainer API through the use of Personal Access Tokens: https://github.com/portainer/portainer/issues/813
• Automatically sync Portainer dark/light theme with the browser dark/light theme settings: https://github.com/portainer/portainer/issues/5753
• Fixed issue where the CPU and memory were not shown on the Home screen: https://github.com/portainer/portainer/issues/6143
• Added confirmation modal when deleting an Environment: https://github.com/portainer/portainer/issues/5952
• Fixed issue where removing an environment did not update the tree: https://github.com/portainer/portainer/issues/6127
• Fixed issue where the DockerHub anonymous registry was being used instead of one with an account: https://github.com/portainer/portainer/issues/5896
• Fixed issue where environment displayed as offline after starting Portainer: https://github.com/portainer/portainer/issues/5732
• Fixed issue where the custom logo settings showed incorrectly in the UI: https://github.com/portainer/portainer/issues/4437
• Fixed issue where uploading a backup file could not select a file on Mac: https://github.com/portainer/portainer/issues/5357
• Fixed issue where apple touch Portainer icon had non standard image dimensions https://github.com/portainer/portainer/issues/5887
• Fixed issue with widget header not displaying correctly for application settings: https://github.com/portainer/portainer/issues/6191
• Improvements to avoid access to sensitive data through various services: https://github.com/portainer/portainer/issues/6261
• Added validation when copying a template: https://github.com/portainer/portainer/issues/6263

Edge:

• Fixed issues with the Edge Agent reverse tunnel timing out: https://github.com/portainer/portainer/issues/5725
• Fixed issue where the URL of an Environment would change to localhost: https://github.com/portainer/portainer/issues/5803

Registry:

• Bring users the ability to use Amazon Elastic Container Registry: https://github.com/portainer/portainer/issues/1533

ACI:

• Fixed issue where ACI stopped working when the number of exposed ports and container ports were different: https://github.com/portainer/portainer/issues/5335

Development:

• Introduced ReactJS support in the frontend: https://github.com/portainer/portainer/issues/6031
• Updated docker and kubernetes library dependencies: https://github.com/portainer/portainer/issues/6137
• Updated the Swagger documentation: https://github.com/portainer/portainer/issues/5338
• Added logging to migrations: https://github.com/portainer/portainer/issues/6183

2.9.3

See Upgrading Portainer instructions.

Portainer:

• Fixed issue where upgrade to 2.9.2 fails: https://github.com/portainer/portainer/issues/5969 and https://github.com/portainer/portainer/issues/6062
• Added a build for Windows Server 21H2: https://github.com/portainer/portainer/issues/5763

2.9.2

Kubernetes:

• Fixed issue where Portainer stacks were not being removed when removing a namespace: https://github.com/portainer/portainer/issues/5897
• Fixed issue where standard users were unable to access the pod and node stats view: https://github.com/portainer/portainer/issues/5898
• Fixed issue where editing an application could not expose it via Ingress: https://github.com/portainer/portainer/issues/5915

Portainer:

• Fixed issue where the DockerHub anonymous registry was being used instead of one with an account: https://github.com/portainer/portainer/issues/5896
• Fixed issue where the Helm Repository URL could not be cleared: https://github.com/portainer/portainer/issues/5910