Portainer
Run custom Docker containers on your Umbrel
Portainer
⚠️ Make sure to only use named Docker volumes for your stacks and containers. Data in bind-mounted volumes will be lost when the Portainer app is restarted or updated.
⚠️ Watch out for port conflicts between your custom Docker containers and your umbrelOS apps.
Portainer is the ultimate Docker management solution that simplifies running Docker containers and Docker Compose setups on your Umbrel, putting comprehensive control at your fingertips.
Portainer provides seamless container management, allowing you to efficiently monitor, start, stop, and modify containers, networks, volumes, and images. You can also deploy multi-container applications using Docker Compose with ease.
🛠️ Portainer on Umbrel is for power users, follow these best practices to avoid issues:
-
Data persistence: Make sure to only used named Docker volumes for your stacks and containers. Data in bind-mounted volumes will be lost when the Portainer app is restarted or updated.
-
Port management: Watch out for potential port conflicts between your custom containers and umbrelOS' service containers, apps you have installed from the Umbrel App Store or Community App Stores, and any apps you go to install in the future.
-
Container restart policy: Set your containers to "unless-stopped" or "always" restart policies. This will allow your containers to restart automatically when the Portainer app is restarted or updated.
-
Web access to containers: Access your custom containers in your browser at umbrel.local:PORT_NUMBER. For example, for a container with a web UI running on port 4545, navigate to umbrel.local:4545 to access it.
This update includes several improvements and fixes:
- Fixed an issue with manual stack force deployment
- Fixed an issue that caused the calendar widget to render incorrectly
- Resolved multiple security vulnerabilities
Full release notes are found at https://github.com/portainer/portainer/releases.
This update includes several improvements and fixes:
- Improved stability by attempting to compact using a read-only database
- Fixed an issue where adding a team access to a namespace threw an error
- Fixed an issue where a memory leak occurred during stack auto redeployment
- Resolved security vulnerability
Full release notes are found at https://github.com/portainer/portainer/releases.
This update adds support for GPU passthrough in umbrelOS 1.5.
The release notes of the previous version included the following changes:
- Fixed issues with environment status updates and access control
- Improved security with increased Content-Security-Policy restrictions
- Enhanced GitOps functionality and Helm repository validation
- Resolved problems with custom templates and stack deployments
- Added support for shared credentials for Git operations
⚠️ The --sslcert and --sslkey CLI options are now deprecated in favor of --tlscert and --tlskey options
Full release notes are found at https://github.com/portainer/portainer/releases.
This update includes several improvements and fixes:
- Fixed issues with environment status updates and access control
- Improved security with increased Content-Security-Policy restrictions
- Enhanced GitOps functionality and Helm repository validation
- Resolved problems with custom templates and stack deployments
- Added support for shared credentials for Git operations
⚠️ The --sslcert and --sslkey CLI options are now deprecated in favor of --tlscert and --tlskey options
Full release notes are found at https://github.com/portainer/portainer/releases.
This update includes several improvements and fixes:
- Fixed environment status update delays for Standard Edge Agent
- Resolved issues with CLI options for TLS certificates
- Improved Edge Stacks updates when using GitOps
- Fixed container engine selection when adding first Kubernetes environment
- Addressed multiple security vulnerabilities
⚠️ Support for the Docker manifest list format has been removed. All container images now use the OCI image index format exclusively.
Full release notes are found at https://github.com/portainer/portainer/releases.
This update includes several improvements and fixes:
- Improved dropdown behavior for large item lists
- Enhanced YAML web editor
- Added bearer token authentication support for Bitbucket Repositories
- Moved kubectl shell feature to a pop-up window
- Improved performance for Edge Group endpoint relations
- Added Permissions-Policy header for improved security
- Fixed issues with log viewer, kubeconfig generation, and custom logos
- Resolved problems with Helm preview and installations
- Improved handling of edge stacks and Helm applications
- Updated Docker binary version to v28.1.0
⚠️ Support for the Docker manifest list format has been removed. All container images now use the OCI image index format exclusively.
Full release notes are found at https://github.com/portainer/portainer/releases.
This update includes improvements and fixes:
- Added a new CLI option and environment variable to specify trusted domains for accessing Portainer behind a reverse proxy
- Fixed issues related to Kubernetes client cache and namespace access for API users
Full release notes are found at https://github.com/portainer/portainer/releases.
This update includes security fixes and improvements:
- Fixed an issue where the Kubernetes client cache was not cleared and created correctly per user
- Fixed an issue where Kubernetes namespace access changes were not reflected for API users after sign-in
- Resolved several security vulnerabilities
Full release notes are found at https://github.com/portainer/portainer/releases.
This update includes several improvements and security fixes:
- Made improvements to the Helm feature including the ability to upgrade, rollback, and uninstall charts
- Added support for passing environment variables from edge agents to edge stacks
- Fixed an issue where users were unable to perform rolling restarts for deployments
- Resolved several security vulnerabilities
Full release notes are found at https://github.com/portainer/portainer/releases.
This update includes no changes compared to the previous release and is being shipped in order to retain parity with the Business Edition release cadence.
Full release notes are found at https://github.com/portainer/portainer/releases.
This update includes several improvements and fixes:
- Fixed an issue where the PORTAINER_EDGE_ID variable was not being set properly
Full release notes are found at https://github.com/portainer/portainer/releases.
This update fixes several security vulnerabilities.
Full release notes are found at https://github.com/portainer/portainer/releases.
This update brings several improvements and fixes:
- Fixed missing CPU reservation metrics in Kubernetes clusters
- Fixed data loss issue when redeploying stacks with relative path volumes
Full release notes are found at https://github.com/portainer/portainer/releases.
This update brings several improvements and fixes:
- Fixed an issue on Kubernetes environments where invalid deployments could fail silently
- Fixed an issue on Kubernetes environments where namespaces that the user did not have access to could be shown
- Fixed an issue where the select all checkbox didn't reflect the selected state
- Resolved a security vulnerability (CVE-2025-22869)
Full release notes are found at https://github.com/portainer/portainer/releases.
This new LTS release of Portainer brings a number of new features and improvements:
- Addition of Podman support
- Significant edge environment performance optimizations
- Improved Kubernetes management experience
- Integration with Sidero Omni
- Multiple security fixes and CVE resolutions
- Various bug fixes and enhancements
Full release notes are found at https://github.com/portainer/portainer/releases.
This update includes improvements to stability and performance:
- Fixed container port mapping when editing or duplicating containers
- Improved Git repository space usage optimization
- Enhanced backup process reliability
- Fixed image building and pulling issues
Full release notes are found at https://github.com/portainer/portainer/releases.
This update includes improvements to stability and performance:
- Improved Edge environment status monitoring and error reporting
- Enhanced service management for Docker Swarm environments
- Added compatibility improvements for future Docker versions
Full release notes are found at https://github.com/portainer/portainer/releases.
This update includes improvements to stability and performance, as well as some bug fixes:
- Improved home page search performance, addressing slow response times in certain environments
- Fixed an issue where the CRL (Certificate Revocation List) request timeout may be too short, causing potential connection issues
Full release notes are found at https://github.com/portainer/portainer/releases.
This update includes improvements to stability and performance, as well as some bug fixes:
- Fixed an issue with stack deployment on Docker when using a .env file from a Git Repository
- Updated Linode branding to align with the new "Akamai Connected Cloud"
Full release notes are found at https://github.com/portainer/portainer/releases.
This update includes improvements to stability and performance, as well as some bug fixes:
- Fixed an issue where Portainer would crash when cloning a large Git repository
- Introduced a mechanism to revoke authentication tokens after logout
- Resolved a problem when re-creating a container on Docker 24
Full release notes are found at https://github.com/portainer/portainer/releases.
This is the first Long-Term Support (LTS) release of Portainer, which includes all changes up to the 2.20.3 release, as well as improvements to stability and scalability.
Key highlights:
- Improved overall stability
- Enhanced performance and reliability for larger environments
- Security updates to address critical and high vulnerabilities in dependencies
Full release notes are found at https://github.com/portainer/portainer/releases.
This update resolves a security vulnerability in Portainer, by creating uniform response time for login attempts. More details can be found at https://github.com/advisories/GHSA-87x6-8m9v-g8c2
Full release notes are found at https://github.com/portainer/portainer/releases.
This update of Portainer from 2.19.0 to 2.19.1 includes various bug fixes, improvements, and new features, including the following highlights.
👉 Breaking changes:
- Changes to API format and checking of some requests - See rest API changes below for more details.
👉 Portainer:
- Fixed an issue where backup files were missing the Chisel private key. This could have disrupted communication between the Portainer server and agent after a restoration from backup.
- Improved the upgrade process for the Portainer server, upgrade process now halts on database migration errors, preventing database version mismatches for a more stable environment.
- Fixed an issue where toggles could be activated outside of their intended component area, potentially leading to inadvertent toggling.
👉 RestAPI:
- Fixed an issue introduced in 2.19.0 when Kubernetes environment metrics API features were enabled, where these features would return an ‘Unable to reach metrics API’ error.
- Introduced new format around the change of a user’s password via API.
- Updated the checking around change of a user via API.
- Fixed API endpoints that were broken in the 2.19.0 release, ensuring that they retain their previous functionality.
View full release notes here: https://github.com/portainer/portainer/releases/tag/2.19.1
