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: #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: #4646
Display the ImagePull policy in the details of an application: #4778
Added the ability to cordon/uncordon/drain nodes: #4006
Added the ability to expand the YAML tab of a Kubernetes application to full size: #4007
Environment variable are sorted alphabetically to improve the readability: #3520
Default to the kube-system namespace in the advanced deployment view on ARM: #4625
Form validation has been added for Configuration keys: #4728
Prevent a Configuration key that currently is in use by an application from being edited: #4549
Fixed issue where renaming the endpoint of a kubernetes agent breaks the endpoint: #4770
Fixed issue where updating the Kubernetes endpoint URL did not get persisted: #4478
Fixed issue with the owner label in the Kubernetes service model: #4842
Fixed issue where an application with persisted data can't update, after the storage option is disabled in the cluster settings: #4843
Fixed issue where adding an ingress route is not prevented when editing an application with existing ingress route and ingress is disabled: #4722
Fixed issue where environment variables with empty values are not showing when editing a kubernetes application: #4848
Docker:
Show how many Docker pulls are remaining for DockerHub to avoid exceeding the quota: #4573
Allow creating stacks with the same name across different endpoints: #1347
sysctl options are available when creating a container: #2756
Settings related to Docker features and security have been moved to the endpoints under the Host/Swarm menu: #4614
Display the container IP address(es) in the list of containers: #3887
Show the number of Swarm nodes for the endpoint on the Home page: #4482
For Docker Standalone, prevent a stack from being created if the Compose has a container_name that already exists: #4630
Creating a container from a DockerHub image will show a search button in the UI: #4374
Improved layout of the toggles on the create container setting tab: #4825
Fixed issue where pulling a large image is failing when using an Agent due to a timeout: #3910
Fixed issue where listing the services with Auto-refresh on collapses all services after refresh: #3068
Fixed issue where the label showing the default location of secrets was incorrect for Windows: #4447
Fixed issue where dash characters got removed from the stack name on Docker Standalone: #4835
Fixed issue where access control management via labels was not fault tolerant: #3547
Fixed typo in the error message "Unable to start stack": #4839
Volumes:
Fixed issue where volume ownership was lost when uploading new files which prevented users from browsing it: #4851
Fixed issue where editing the properties of volumes on a service did not enable the apply button: #4616
Fixed issue where adding a service should be prevented when no volume has been selected for a volume mapping: #4651
Fixed issue with the MountType and nfsvers when creating NFS4 volumes: #4729
Edge:
Show the status of the edge agent check-in on the home page dashboard: #3842
Show all endpoint tags that have been created when creating an endpoint group: #4462
Hide the webhook UI in the service creation view of an edge endpoint, since it's not applicable: #4457
Fixed issue where accessing a down Kubernetes Edge endpoint should redirect the user to the home view: #4550
Fixed issue with the command displayed for Edge agent deployment on Docker standalone when adding an endpoint: #4732
Agent:
The agent has been upgraded to use Go module for dependency management: portainer/agent#110
ACI:
Added User Access Control for ACI endpoints: #5060
Registries:
Fixed issue where pushing to a quay.io registry failed due to not including the username in the quay registry URL: #4371
Portainer:
Added the ability to backup and restore Portainer: #5061
Usernames are stored in lower case to ignore case sensitivity: #3580
When pointing Portainer CE to a volume containing Portainer EE data, it requires a data migration in order to start up: #4551
Improved descriptions for Portainer initialization errors: #4846
Prevent web editor related views from being accidentally closed: #3864
Search filters are retained within the browser session: #3973
Added the option to specify the local socket location when adding a docker endpoint: #4772
Fixed issue where a custom snapshot interval cannot be changed: #4327
Fixed issue with incorrect Windows agent deployment command in the agent endpoint creation tab: #4749
Fixed issue where the File select windows gets shown when pressing enter in text fields: #4748
Templates:
All custom templates are listed but only applicable ones can be deployed, based on the active endpoint type: #4743
Fixed issue where creating a custom template from uploading a compose file failed: #4384
Fixed issue where switching custom template in the template tab of stack create view doesn't update editor: #4751
Fixed issue with an invalid template documentation URL in the Settings: #4832
Development:
Introduce buildx to support Windows 1903+ Base Images: #4771
Added the ability to debug through VSCode: #4755
Fixed issue where webpack complains about chardet source maps: #4759
Fixed issue where babel complains about missing core-js dependency: #4761
Removed grunt-karma ang grunt-html2js dependencies: #4764