2.5.0

Known issues

Unable to deploy stack templates (Standalone / Swarm endpoints)

We've identified an issue where users cannot deploy stack templates, either on Docker standalone and Swarm endpoints, and we've referenced it here: https://github.com/portainer/portainer/issues/5103 If you're relying on the stack template deployment feature, we recommend you to not upgrade to this version of Portainer yet.

We'll release a CE 2.5.1 patch version including a fix for this issue shortly.

Quay.io registries

When using a quay.io registry and pulling an image, the autocompletion will incorrectly add the username to the image name. As a workaround, simply delete the username from what the autocompletion gives you to be able to pull the image.

Breaking change

This new version introduce breaking changes to the Docker UAC system that are not backward compatible with previous versions of Portainer. Rolling back from this version to a previous will cause access control policies set on Docker resources to be reset to Administrators only. Consider this change before upgrading, and if needed, take a copy of the /data folder of Portainer before upgrading in case you want to rollback to a previous version.

Note that you will now be able to backup Portainer using this process for future upgrades: https://documentation.portainer.io/v2.0/backup/backup/

Kubernetes:

• Added the ability to redeploy an externally deployed application: https://github.com/portainer/portainer/issues/4646
• Display the ImagePull policy in the details of an application: https://github.com/portainer/portainer/issues/4778
• Added the ability to cordon/uncordon/drain nodes: https://github.com/portainer/portainer/issues/4006
• Added the ability to expand the YAML tab of a Kubernetes application to full size: https://github.com/portainer/portainer/issues/4007
• Environment variable are sorted alphabetically to improve the readability: https://github.com/portainer/portainer/issues/3520
• Default to the kube-system namespace in the advanced deployment view on ARM: https://github.com/portainer/portainer/issues/4625
• Form validation has been added for Configuration keys: https://github.com/portainer/portainer/issues/4728
• Prevent a Configuration key that currently is in use by an application from being edited: https://github.com/portainer/portainer/issues/4549
• Fixed issue where renaming the endpoint of a kubernetes agent breaks the endpoint: https://github.com/portainer/portainer/issues/4770
• Fixed issue where updating the Kubernetes endpoint URL did not get persisted: https://github.com/portainer/portainer/issues/4478
• Fixed issue with the owner label in the Kubernetes service model: https://github.com/portainer/portainer/issues/4842
• Fixed issue where an application with persisted data can't update, after the storage option is disabled in the cluster settings: https://github.com/portainer/portainer/issues/4843
• Fixed issue where adding an ingress route is not prevented when editing an application with existing ingress route and ingress is disabled: https://github.com/portainer/portainer/issues/4722
• Fixed issue where environment variables with empty values are not showing when editing a kubernetes application: https://github.com/portainer/portainer/issues/4848

Docker:

• Show how many Docker pulls are remaining for DockerHub to avoid exceeding the quota: https://github.com/portainer/portainer/issues/4573
• Allow creating stacks with the same name across different endpoints: https://github.com/portainer/portainer/issues/1347
• sysctl options are available when creating a container: https://github.com/portainer/portainer/issues/2756
• Settings related to Docker features and security have been moved to the endpoints under the Host/Swarm menu: https://github.com/portainer/portainer/issues/4614
• Display the container IP address(es) in the list of containers: https://github.com/portainer/portainer/issues/3887
• Show the number of Swarm nodes for the endpoint on the Home page: https://github.com/portainer/portainer/issues/4482
• For Docker Standalone, prevent a stack from being created if the Compose has a container_name that already exists: https://github.com/portainer/portainer/issues/4630
• Creating a container from a DockerHub image will show a search button in the UI: https://github.com/portainer/portainer/issues/4374
• Improved layout of the toggles on the create container setting tab: https://github.com/portainer/portainer/issues/4825
• Fixed issue where pulling a large image is failing when using an Agent due to a timeout: https://github.com/portainer/portainer/issues/3910
• Fixed issue where listing the services with Auto-refresh on collapses all services after refresh: https://github.com/portainer/portainer/issues/3068
• Fixed issue where the label showing the default location of secrets was incorrect for Windows: https://github.com/portainer/portainer/issues/4447
• Fixed issue where dash characters got removed from the stack name on Docker Standalone: https://github.com/portainer/portainer/issues/4835
• Fixed issue where access control management via labels was not fault tolerant: https://github.com/portainer/portainer/issues/3547
• Fixed typo in the error message "Unable to start stack": https://github.com/portainer/portainer/issues/4839

Volumes:

• Fixed issue where volume ownership was lost when uploading new files which prevented users from browsing it: https://github.com/portainer/portainer/issues/4851
• Fixed issue where editing the properties of volumes on a service did not enable the apply button: https://github.com/portainer/portainer/issues/4616
• Fixed issue where adding a service should be prevented when no volume has been selected for a volume mapping: https://github.com/portainer/portainer/issues/4651
• Fixed issue with the MountType and nfsvers when creating NFS4 volumes: https://github.com/portainer/portainer/issues/4729

Edge:

• Show the status of the edge agent check-in on the home page dashboard: https://github.com/portainer/portainer/issues/3842
• Show all endpoint tags that have been created when creating an endpoint group: https://github.com/portainer/portainer/issues/4462
• Hide the webhook UI in the service creation view of an edge endpoint, since it's not applicable: https://github.com/portainer/portainer/issues/4457
• Fixed issue where accessing a down Kubernetes Edge endpoint should redirect the user to the home view: https://github.com/portainer/portainer/issues/4550
• Fixed issue with the command displayed for Edge agent deployment on Docker standalone when adding an endpoint: https://github.com/portainer/portainer/issues/4732

Agent:

• The agent has been upgraded to use Go module for dependency management: https://github.com/portainer/agent/issues/110

ACI:

• Added User Access Control for ACI endpoints: https://github.com/portainer/portainer/issues/5060

Registries:

• Fixed issue where pushing to a quay.io registry failed due to not including the username in the quay registry URL: https://github.com/portainer/portainer/issues/4371

Portainer:

• Added the ability to backup and restore Portainer: https://github.com/portainer/portainer/issues/5061
• Usernames are stored in lower case to ignore case sensitivity: https://github.com/portainer/portainer/issues/3580
• When pointing Portainer CE to a volume containing Portainer EE data, it requires a data migration in order to start up: https://github.com/portainer/portainer/issues/4551
• Improved descriptions for Portainer initialization errors: https://github.com/portainer/portainer/issues/4846
• Prevent web editor related views from being accidentally closed: https://github.com/portainer/portainer/issues/3864
• Search filters are retained within the browser session: https://github.com/portainer/portainer/issues/3973
• Added the option to specify the local socket location when adding a docker endpoint: https://github.com/portainer/portainer/issues/4772
• Fixed issue where a custom snapshot interval cannot be changed: https://github.com/portainer/portainer/issues/4327
• Fixed issue with incorrect Windows agent deployment command in the agent endpoint creation tab: https://github.com/portainer/portainer/issues/4749
• Fixed issue where the File select windows gets shown when pressing enter in text fields: https://github.com/portainer/portainer/issues/4748

Templates:

• All custom templates are listed but only applicable ones can be deployed, based on the active endpoint type: https://github.com/portainer/portainer/issues/4743
• Fixed issue where creating a custom template from uploading a compose file failed: https://github.com/portainer/portainer/issues/4384
• Fixed issue where switching custom template in the template tab of stack create view doesn't update editor: https://github.com/portainer/portainer/issues/4751
• Fixed issue with an invalid template documentation URL in the Settings: https://github.com/portainer/portainer/issues/4832

Development:

• Introduce buildx to support Windows 1903+ Base Images: https://github.com/portainer/portainer/issues/4771
• Added the ability to debug through VSCode: https://github.com/portainer/portainer/issues/4755
• Fixed issue where webpack complains about chardet source maps: https://github.com/portainer/portainer/issues/4759
• Fixed issue where babel complains about missing core-js dependency: https://github.com/portainer/portainer/issues/4761
• Removed grunt-karma ang grunt-html2js dependencies: https://github.com/portainer/portainer/issues/4764