2.19.0

See Upgrading Portainer instructions.

Overview of changes

New Portainer CE 2.19.0 release

Breaking Changes

• A number of components/views have been migrated from Angular to React.
• Internal versioning on stacks feature has introduced file structure changes in 2.19.
• We have addressed an API issue in which an incorrect parameter was being used for API endpoint /edge_groups. Users relying on the HasEdgeGroup parameter should now use HasEdgeJob to achieve the intended functionality.

Resolved CVE's

• Updated the Docker Compose binary to v2.20.2, to resolve CVEs. https://github.com/portainer/portainer/issues/10099
• Updated the Helm binary to v3.12.2, to resolve CVEs. https://github.com/portainer/portainer/issues/10100
• Updated various packages to resolve CVEs. https://github.com/portainer/portainer/issues/9224
• Updated various packages in the agent, to resolve CVEs.

Edge

• Fixed an issue where deploying a large volume edge stack triggered a 'URI too large' error. https://github.com/portainer/portainer/issues/10128
• Fixed an API issue where the incorrect parameter HasEdgeGroup was being used instead of HasEdgeJob for endpoint /edge_groups. Users relying on the HasEdgeGroup parameter should now use HasEdgeJob to achieve the intended functionality. https://github.com/portainer/portainer/issues/10133
• Improved logging for edge agent when polling fails. This enhancement provides more informative and detailed logs when polling encounters failures, aiding in quicker identification and resolution of issues. https://github.com/portainer/portainer/issues/10143
• Resolved an issue where users were able to create schedulers with an empty edge group, which is no longer allowed to ensure proper functionality and avoid potential errors https://github.com/portainer/portainer/issues/10149
• Resolved an issue where the edge agent default poll frequency selector was not lining up correctly https://github.com/portainer/portainer/issues/10150
• Resolved an issue where users were unable to create an edge group when there were no members present in that group. Edge groups can now be created without requiring initial members, offering greater flexibility in edge device and configuration management. https://github.com/portainer/portainer/issues/10153
• Introduce an enhancement to our snapshot creation process for edge devices which streamlines the snapshot creation experience, providing users with a more efficient and user-friendly way to capture snapshots on edge devices. https://github.com/portainer/portainer/issues/10154
• Fixed an issue where environment files were not functioning properly in Git deployments for edge stacks. https://github.com/portainer/portainer/issues/10171
• Introduced webhooks for edge stack, you can now set up webhooks for your edge stacks, enabling automated polling for GitOps updates. https://github.com/portainer/portainer/issues/10178
• Fixed an issue where the agent was unintentionally flushing edge job entries when collecting logs. https://github.com/portainer/portainer/issues/10172

Docker

• Addressed an issue where the Docker client was not utilising version negotiation. https://github.com/portainer/portainer/issues/10125
• Resolved an issue where the image name was displayed incorrectly when a user tried to duplicate or edit a container https://github.com/portainer/portainer/issues/10126
• Fixed an issue in the API where sending files to a Docker endpoint resulted in a panic. https://github.com/portainer/portainer/issues/10129
• Resolved an issue with Docker Proxy's performance, resulting in improved overall performance and responsiveness when using the Docker Proxy feature. https://github.com/portainer/portainer/issues/10131
• Resolved an issue in the Docker Container List where searching by published ports was no longer working. https://github.com/portainer/portainer/issues/6656
• Resolved an issue where '.' was not allowed in the image name (but should be) when building a Docker image via the UI. https://github.com/portainer/portainer/issues/8047
• Resolved some minor UI issues in Docker Services-related screens. https://github.com/portainer/portainer/issues/10117

Swarm

• Fixed an issue in Docker Swarm version 24.0.0 where image tags were not being displayed. https://github.com/portainer/portainer/issues/10134
• Resolved an issue where clicking into the details page of a Swarm stack would redirect users to the service section instead of the top of the page https://github.com/portainer/portainer/issues/10151

Kubernetes

• Resolved an issue around Operator role users not being able to perform rolling restart, redeploy and rollback to previous version for Deployment, DaemonSet and StatefulSet resources. https://github.com/portainer/portainer/issues/10105
• Adjusted Kubernetes Cluster setup screen's ingress settings to be clearer and to give info on ingress defaults. https://github.com/portainer/portainer/issues/10101
• Resolved an issue with Kubernetes ECR image pull where the secret token was not updating on manifest deployment. https://github.com/portainer/portainer/issues/10119
• Updated the link to Portainer documentation (following docs reorganisation) for Kubernetes Add Environment via kubeconfig Import. https://github.com/portainer/portainer/issues/9999
• Resolved an issue where Node stats for a Google Kubernetes Engine (GKE) cluster gave an error 'unable to retrieve node metrics'. https://github.com/portainer/portainer/issues/10114
• Migrated the Kubernetes Add/Edit Application screen's Services section from Angular to React. https://github.com/portainer/portainer/issues/9235
• Reintroduced the ability to specify and use (via Add/Edit Application) ingress defaults (hostname and annotations). https://github.com/portainer/portainer/issues/10030
• Reintroduced the ability to publish via ingress from the Add/Edit Application screen. https://github.com/portainer/portainer/issues/10103
• Introduced correct redirecting of the user, following deployment of a Kubernetes manifest. Previously the user was always returned to the Applications List but will now arrive back at the screen from which they accessed the Advanced Deployment function. https://github.com/portainer/portainer/issues/10115
• Migrated the Kubernetes Application Details screen's Summary and Details sections from Angular to React. https://github.com/portainer/portainer/issues/10102
• Introduced a loading spinner to the Add/Edit ingress screen's ingress class dropdown, to indicate that available options are still being retrieved. https://github.com/portainer/portainer/issues/10000
• Resolved an issue that was occurring on the exposing of Portainer over a subpath, where Kubernetes Cluster Setup and other screens failed to load and reported an error. https://github.com/portainer/portainer/issues/10112
• Resolved a Node details issue where nodes showed incorrect role of 'Worker' due to deprecated 'node-role.kubernetes.io/master' K8s label (now 'control-plane'). Also where MicroK8s cluster nodes were incorrectly identified (though not due to labels). https://github.com/portainer/portainer/issues/10104
• Split the Kubernetes ConfigMaps & Secrets functionality in order to provide better performance and a clearer user experience. We now have separate tabs in the list screen and separate add/edit functions. https://github.com/portainer/portainer/issues/9222
• Resolved an issue with Kubernetes pages where a warning showed in the browser console ('findDOMNode is deprecated in StrictMode') when resource assignment was first toggled on for the namespace. https://github.com/portainer/portainer/issues/10111
• Updated Kubernetes ConfigMaps & Secrets terminology that was previously shown as Configurations, so as to align more clearly with Kubernetes. https://github.com/portainer/portainer/issues/10025
• In the Dashboard screen of Kubernetes environments, Ingresses and Services panels have now been introduced, providing a count of these resources and an easy means to click through and access their list screens. https://github.com/portainer/portainer/issues/9223
• Migrated Kubernetes Application console page from Angular to React. https://github.com/portainer/portainer/issues/9177
• Introduced a feature that lets you upgrade your Portainer Community Edition to the Business Edition right within Portainer on Kubernetes platform. https://github.com/portainer/portainer/issues/10177
• Resolved an issue where the Helm repository URL in (Kubernetes) Settings could not be updated.

Portainer

• Fixed an issue where a bad gateway response occurred when updating an environment with an empty URL. https://github.com/portainer/portainer/issues/10123
• Resolved an issue where users were unable to deploy a stack when utilising an image from a private GitLab registry. https://github.com/portainer/portainer/issues/10124
• To identify Portainer submenus more clearly, their sub-options are now indented. https://github.com/portainer/portainer/issues/9216
• Renamed "Automatic updates" in Git deployment section to "GitOps Updates" to clarify the feature at first glance for users. Please note this is a name change only and no functionality has been altered. https://github.com/portainer/portainer/issues/10175
• Resolved an issue with the App Templates screen, where a Kubernetes icon was incorrectly showing for Docker Swarm stacks. Also updated the Swagger API documentation to detail the existence of a 'Compose edge stack' App Template (numbered 4) type. https://github.com/portainer/portainer/issues/10028
• Resolved a minor UI issue where warning icons were smaller in size in multi-line warning messages. https://github.com/portainer/portainer/issues/10118
• Fixed an issue where standard users were unable to create Azure Container Instances (ACI) resources. https://github.com/portainer/portainer/issues/10152
• Fixed an issue where line break HTML tags were showing in some pop-up dialogs instead of actual line breaks. https://github.com/portainer/portainer/issues/9226
• Improved App Templates page with enhanced cursor icon and tile highlighting https://github.com/portainer/portainer/issues/10136
• Improved rolling back to CE from a CE to BE migration, by providing better logging and performing a check that the db file exists. https://github.com/portainer/portainer/issues/9225
• Fixed an issue where the primary environment remained permanently down after restoring from backup. https://github.com/portainer/portainer/issues/10137
• Introduced validation to prevent the use of invalid names when creating or editing Kubernetes or Docker Custom Templates. https://github.com/portainer/portainer/issues/10113
• Fixed an issue where the 'Skip TLS Verification' option was not functioning properly for custom templates. https://github.com/portainer/portainer/issues/10138
• Resolved a minor UI issue where multi-line text-tip and form-error icons were incorrectly vertically center-aligned rather than top-aligned. https://github.com/portainer/portainer/issues/10118
• Fixed an issue where the hover interaction for the environment tile on the homepage was missing https://github.com/portainer/portainer/issues/10136
• Fixed a security issue where usernames and passwords were displayed in responses. https://github.com/portainer/portainer/issues/10140
• Improved error logging in libhttp to provide more useful context. https://github.com/portainer/portainer/issues/10142
• Addressed an issue where TLS handshake error messages were being logged, which should only occur when using the DEBUG log level. https://github.com/portainer/portainer/issues/10144
• Fixed an issue where using spaces in an Organizational Unit (OU) or Common Name (CN) name caused incorrect data to be displayed in the Active Directory configuration. https://github.com/portainer/portainer/issues/10145
• Resolved an issue where unnecessary snapshots were being loaded on the home page, leading to improved loading times and a smoother user experience https://github.com/portainer/portainer/issues/10147
• Resolved an issue where users were not being notified about the proper referencing of their uploaded .env files, requiring them to now utilize "stack.env" for appropriate referencing https://github.com/portainer/portainer/issues/10148
• Introduced a 'copy to clipboard' button to web editors within the Portainer UI. https://github.com/portainer/portainer/issues/10116
• Introduced the ability to manage time in seconds or milliseconds for container logs, expanding your time management options beyond seconds for more insightful troubleshooting. https://github.com/portainer/portainer/issues/10176
• Resolved a logging issue with database migrations, where, if an error occurred causing a rollback to the pre-upgrade version of the database, that error was no longer output to the console. https://github.com/portainer/portainer/issues/10110
• Resolved an issue that prevented users from stopping stacks with invalid project names during their upgrade from versions 2.6 or 2.7 to 2.13, 2.14, 2.15, 2.16, and subsequent versions. https://github.com/portainer/portainer/issues/10163
• Resolved an issue that prevented users from deleting stacks with invalid project names during their upgrade from versions 2.6 or 2.7 to 2.13, 2.14, 2.15, 2.16, and subsequent versions. https://github.com/portainer/portainer/issues/10164
• Resolved an issue where users were encountering difficulties when attempting to push images using a service principal account on Azure Registry. https://github.com/portainer/portainer/issues/10155
• Fixed an issue where delete confirmation modals were absent for edge stacks, Docker images, environment groups, and tags. https://github.com/portainer/portainer/issues/10156
• Fixed an issue where the creation of manifest file paths slice was incorrect. https://github.com/portainer/portainer/issues/10170
• Community contribution - The enhancement ensures that the response rewrite operation is properly wrapped with a valid status check, contributing to a more robust and reliable system behavior. https://github.com/portainer/portainer/issues/2705
• Fixed an issue where enabling GPU support on existing containers resulted in errors. https://github.com/portainer/portainer/issues/10174
• Addressed an issue where users were unable to update the TLS certificate for the Docker API environment. https://github.com/portainer/portainer/issues/10166
• Resolved an issue where incorrect AWS ECR icon was used when creating registry https://github.com/portainer/portainer/issues/10162
• Fixed a user interface issue where only up to 100 groups were being displayed. https://github.com/portainer/portainer/issues/10160
• Addressed an issue where using incorrect Azure registry credentials resulted in errors, even after updating with correct credentials, the issue persisted. https://github.com/portainer/portainer/issues/10159
• Resolved an issue where custom templates created from Git were not being pulled again at deploy time. This improvement has also been extended to Kubernetes custom templates. https://github.com/portainer/portainer/issues/10157
• Improved dark mode teaser color enhanced for reduced visual strain https://github.com/portainer/portainer/issues/10127
• Fixed an issue where 'PublicAccess' middleware was missing from some API routes, ensuring consistent access control. https://github.com/portainer/portainer/issues/10146

Development

• Resolved an issue with new React version list screens where filter icons were not positioned next to the correct column heading but were abutting the next heading along. https://github.com/portainer/portainer/issues/10098
• Applied changes to the helper-reset-password utility to prevent it being accidentally used with the Docker Desktop Extension version of Portainer (where it could break access to the Portainer instance). https://github.com/portainer/portainer/issues/10109
• Replaced archived gorilla/securecookie library with just the function that we need extracted out. https://github.com/portainer/portainer/issues/10008
• Transitioned Edge stack environments table to React, delivering a more dynamic user experience with modernized interface, improved performance, and interactive management. https://github.com/portainer/portainer/issues/10210

Rest API Changes

• Documented 'excludeSnapshots' in Swagger API docs https://github.com/portainer/portainer/issues/10130
• Documented webhook types in Swagger API docs https://github.com/portainer/portainer/issues/9121
• Resolved a 2.0 validation error in our Swagger API documentation https://github.com/portainer/portainer/issues/10135
• Corrected 'EdgeCheckinInterval' to 'CheckinInterval' in Swagger API docs https://github.com/portainer/portainer/issues/10139
• Corrected missing type and 'file' to 'File' in Swagger API documentation for custom templates https://github.com/portainer/portainer/issues/10141
• Added descriptions to the Swagger API documentation for Kubernetes API endpoints that were previously missing from the docs. https://github.com/portainer/portainer/issues/10106
• Fixed an API issue where requests to create edge stacks with invalid deployment types were erroneously accepted https://github.com/portainer/portainer/issues/10168
• Addressed an issue in the 'edgeStackCreate' API where sending an incorrect request resulted in a 500 error response instead of the expected 400 error. https://github.com/portainer/portainer/issues/10169
• Fixed an issue in Swagger API documentation where 'endpointId' was incorrectly marked as optional. It is now correctly set as a required field https://github.com/portainer/portainer/issues/10173
• Corrected Swagger API documentation for starting or stopping stacks https://github.com/portainer/portainer/issues/8001
• Corrected 'ResourceId' and 'endpointId' as required instead of optional in Swagger API documentation for webhooks https://github.com/portainer/portainer/issues/9121
• Fixed the Swagger API documentation to require 'endpointId' when updating a stack https://github.com/portainer/portainer/issues/10161
• Corrected 'Endpoints' to be listed in alphabetical order in Swagger API docs https://github.com/portainer/portainer/issues/10158