Portainer Documentation
Official WebsiteKnowledge BasePricingGet 3 Nodes of BE Free
2.27 LTS
2.27 LTS
  • Welcome
  • What's new in version 2.27
  • Release Notes
  • Getting Started
    • Introduction
    • Portainer architecture
    • Lifecycle policy
    • Requirements and prerequisites
    • Install Portainer BE
      • Set up a new Portainer BE Server installation
        • Docker Standalone
          • Install Portainer BE with Docker on Linux
          • Install Portainer BE with Docker on WSL / Docker Desktop
          • Install Portainer BE with Docker on Windows Container Service
        • Docker Swarm
          • Install Portainer BE with Docker Swarm on Linux
          • Install Portainer BE with Docker Swarm on WSL / Docker Desktop
          • Install Portainer BE with Docker Swarm on Windows Container Service
        • Podman
          • Install Portainer BE with Podman on Linux
        • Kubernetes
          • Install Portainer BE on your Kubernetes environment
          • Install Portainer BE with Kubernetes on WSL / Docker Desktop
        • Initial setup
    • Install Portainer CE
      • Set up a new Portainer CE Server installation
        • Docker Standalone
          • Install Portainer CE with Docker on Linux
          • Install Portainer CE with Docker on WSL / Docker Desktop
          • Install Portainer CE with Docker on Windows Container Service
        • Docker Swarm
          • Install Portainer CE with Docker Swarm on Linux
          • Install Portainer CE with Docker Swarm on WSL / Docker Desktop
          • Install Portainer CE with Docker Swarm on Windows Container Service
        • Podman
          • Install Portainer CE with Podman on Linux
        • Kubernetes
          • Install Portainer CE on your Kubernetes environment
          • Install Portainer CE with Kubernetes on WSL / Docker Desktop
        • Initial setup
    • Add an environment to an existing installation
    • Updating Portainer
      • Updating on Docker Standalone
      • Updating on Docker Swarm
      • Updating on Podman
      • Updating on Kubernetes
      • Updating on Nomad
      • Updating the Edge Agent
      • Updating from Portainer 1.x
      • Switching to Portainer Business Edition
        • Upgrade to Business Edition from within Portainer Community Edition
        • Docker Standalone
        • Docker Swarm
        • Podman
        • Kubernetes
        • Upgrading Agent-only deployments
  • Using Portainer
    • Home
      • Snapshot browsing
      • OpenAMT
    • Docker/Swarm/Podman
      • Dashboard
      • Templates
        • Application
        • Custom templates
        • Deploy a stack
        • Deploy a container
      • Stacks
        • Add a new stack
        • Inspect or edit a stack
        • Create a template from a deployed stack
        • Webhooks
        • Migrate or duplicate a stack
        • Remove a stack
      • Services
        • Add a new service
        • Configure service options
        • Scale a service
        • View the status of a service task
        • View service logs
        • Roll back a service
        • Webhooks
      • Containers
        • Add a new container
        • View a container's details
        • Inspect a container
        • Edit or duplicate a container
        • Advanced container settings
        • Webhooks
        • Attach a volume to a container
        • View container logs
        • View container statistics
        • Access a container's console
        • Change container ownership
        • Remove a container
      • Images
        • Pull an image
        • Build a new image
        • Import an image
        • Export an image
      • Networks
        • Add a new network
        • Remove a network
      • Volumes
        • Add a new volume
        • Browse a volume
        • Remove a volume
      • Configs
        • Add a new config
        • Remove a config
      • Secrets
        • Add a new secret
        • Remove a secret
      • Events
      • Host
        • Details
        • Setup
        • Registries
      • Swarm
        • Details
        • Cluster visualizer
        • Setup
        • Registries
    • Kubernetes
      • Dashboard
      • kubectl shell
      • Kubeconfig
      • Custom Templates
        • Add a new custom template
        • Edit a custom template
        • Remove a custom template
      • Namespaces
        • Add a new namespace
        • Manage a namespace
        • Manage access to a namespace
        • Remove a namespace
      • Helm
      • Applications
        • Add a new application using a form
        • Add a new application using code
        • Inspect an application
        • Inspect a Helm application
        • Edit an application
        • Webhooks
        • Detach a volume from an application
        • Remove an application
      • Networking
        • Services
        • Ingresses
          • Add an Ingress manually
          • Add an Ingress using a manifest
          • Remove an Ingress
      • ConfigMaps & Secrets
        • Add a ConfigMap
        • Add a Secret
      • Volumes
        • Inspect a volume
        • Remove a volume
      • More Resources
        • Cron Jobs & Jobs
        • Service Accounts
        • Cluster Roles
        • Roles
      • Cluster
        • Details
        • Inspect a node
        • Setup
        • Security constraints
        • Registries
    • Azure ACI
      • Dashboard
      • Container instances
        • Add a new container
        • View container details
        • Remove a container
    • Nomad
    • Edge Compute
      • Edge Groups
      • Edge Stacks
        • Add a new Edge Stack
      • Edge Jobs
      • Edge Configurations
      • Waiting Room
      • Edge Templates
        • Application
        • Custom
    • Account settings
  • Administering Portainer
    • User-related
      • Users
      • Add a new user
      • Turn a user into an administrator
      • Reset a user's password
      • Teams
        • Add a new team
        • Add a user to a team
      • Roles
    • Environment-related
      • Environments
      • Add a new environment
        • Add a local environment
        • Add a Docker Standalone environment
          • Install Portainer Agent on Docker Standalone
          • Connect to the Docker API
          • Connect to the Docker Socket
          • Install Edge Agent Standard on Docker Standalone
          • Install Edge Agent Async on Docker Standalone
        • Add a Docker Swarm environment
          • Install Portainer Agent on Docker Swarm
          • Connect to the Docker API
          • Connect to the Docker Socket
          • Install Edge Agent Standard on Docker Swarm
          • Install Edge Agent Async on Docker Swarm
        • Add a Podman environment
          • Install Portainer Agent on Podman
          • Connect to the Podman Socket
          • Install Edge Agent Standard on Podman
          • Install Edge Agent Async on Podman
        • Add a Kubernetes environment
          • Install Portainer Agent on your Kubernetes environment
          • Install Edge Agent Standard on Kubernetes
          • Install Edge Agent Async on Kubernetes
          • Import an existing Kubernetes environment
        • Add an ACI environment
        • Add a Nomad environment
        • Provision KaaS Cluster
          • Civo
          • Akamai Connected Cloud
          • DigitalOcean
          • Google Cloud
          • AWS
          • Azure
        • Create a Kubernetes cluster
          • Talos Kubernetes
          • MicroK8s
            • Offline installation
        • Add an environment via the Portainer API
      • Auto onboarding
      • Groups
      • Tags
      • Manage access to environments
      • Manage access to environment groups
      • Update & Rollback
    • Registries
      • Add a new registry
        • Add a DockerHub account
        • Add an AWS ECR registry
        • Add a Quay.io registry
        • Add a ProGet registry
        • Add an Azure registry
        • Add a Gitlab registry
        • Add a GitHub registry
        • Add a custom registry
      • Browse a registry
      • Manage a registry
    • Licenses
    • Logs
      • Authentication
      • Activity
    • Notifications
    • Settings
      • General
      • Authentication
        • Authenticate via LDAP
        • Authenticate via Active Directory
        • Authenticate via OAuth
      • Shared credentials
        • Add Sidero Omni credentials
        • Add Civo credentials
        • Add Akamai Connected Cloud credentials
        • Add DigitalOcean credentials
        • Add Google Cloud credentials
        • Add AWS credentials
        • Add Azure credentials
        • Add SSH credentials
      • Edge Compute
  • Frequently Asked Questions
    • Portainer Concepts
    • Installing
    • Upgrading
    • Troubleshooting
    • Contributing
  • Advanced Topics
    • CLI configuration options
    • App templates
      • Build and host your own app templates
      • App template JSON format
    • The Portainer Edge Agent
    • Access control
    • Reset the admin user's password
    • Security and compliance
    • Encrypting the Portainer database
    • Using your own SSL certificate with Portainer
    • Using mTLS with Portainer
    • Stream auth and activity logs to an external provider
    • Using Portainer with reverse proxies
      • Deploying Portainer behind Traefik Proxy
      • Deploying Portainer behind nginx reverse proxy
    • How Relative Path Support works in Portainer
    • Helm chart configuration options
    • Docker roles and permissions
    • Kubernetes roles and bindings
    • Deprecated and removed features
  • API
    • Accessing the Portainer API
    • API documentation
    • API usage examples
  • Get More Help
    • Knowledge Base
    • Portainer Academy
    • YouTube
    • GitHub
    • Slack
    • Discord
    • Open a support request
  • Contribute to Portainer
    • Contribute
    • Build instructions
      • Set up a macOS build environment
      • Set up a Linux build environment
Powered by GitBook
On this page
  • Long Term Support (LTS)
  • New features
  • Podman support
  • Omni Integration
  • Manage Kubernetes Jobs and Cron Jobs
  • New Kubernetes security options
  • Ask the AI link
  • Portainer support bundle
  • Enhancements and fixes
  • Expanded ACI support
  • Performance optimizations
  • Smaller Git clones
  • Added conditions to Kubernetes nodes
  • Edge Stacks: Staggered deployment improvements
  • Improved logging
  • Additional option for session timeout
  • Updated third-party binaries and libraries
  • Removal of included Docker Compose binary

Was this helpful?

Edit on GitHub

What's new in version 2.27

PreviousWelcomeNextRelease Notes

Last updated 2 months ago

Was this helpful?

Portainer version 2.27 includes a number of new fixes and updates. For a full list of changes, please refer to our .

Long Term Support (LTS)

2.27 is a Long Term Support, or "LTS", release of Portainer. LTS releases are intended to to be solid, tested, production-ready versions of Portainer, suitable for running in both testing and production environments. LTS releases generally do not have any additional features as compared to the previous STS release, but rather are a consolidation of all the new features and changes that have gone into the previous STS releases but with additional polishing and testing.

As many users will be coming to this LTS release directly from the previous LTS release (2.21), the features listed below include those from previous STS releases.

New features

At present, support is limited to rootful Podman 5 installations on CentOS 9. While other versions of Podman on other Linux distributions may work, we have not fully tested outside of the above options as of yet, and we hope to expand this in the future.

As our first release of this feature, there may be bugs or limitations with the implementation. We encourage you to provide constructive feedback so we can improve in future releases.

There are some new Kubernetes security options available in this release, too. Administrators can now disable the Kubeconfig and Kube shell options on environments in Portainer, for situations where you might need to lock down access to that functionality.

Getting help within Portainer is now even easier. We've included a link on the top right of every page to our popular AI-powered chatbot, letting you get quick answers to your Portainer questions.

The chatbot has been trained on the Portainer documentation, knowledge base, blog posts and the Portainer Academy as well as our GitHub issues and discussions, so is an excellent source of Portainer knowledge.

If you do find yourself in a situation where the chatbot can't help and you need to reach out for help from our team, our new support bundle lets you submit your Portainer configuration data to the Portainer team for assistance. This feature strips out secure information like passwords before bundling so your information is kept safe.

Enhancements and fixes

This release also sees a significant amount of improvement to our support for ACI environments. When creating a container in an ACI environment you can now select a private virtual network, add tags, volumes, and GPUs. We've also expanded the management capabilities for your ACI workloads by adding stopping and restarting of ACIs as well as viewing of events related to those ACIs.

With every release we try to make using Portainer more responsive and performant, and 2.27 continues that trend. You'll notice much faster loading of pages within the app, more responsive searching, more reliable webhooks, more standardized interfaces, and all around a better experience.

We've also focused specifically on improving the performance of our Kubernetes management in this release, and the hard work has paid off. We're seeing significant improvements to load times for our Kubernetes pages within the app, much better responsiveness and an all around greater experience when managing Kubernetes in Portainer.

Along with the general performance improvements, we've focused specifically on improving how we clone Git repositories when deploying stacks or applications from Git. We now perform much smaller Git clones, significantly reducing the amount of bandwidth and storage used to deploy from Git and as a result, making deployments faster.

To give you a better idea of the status of your Kubernetes nodes, we've added the Conditions column to the Kubernetes node view in this release.

This column displays whether any of your nodes are affected by conditions, for example DiskPressure, MemoryPressure, PIDPressure or NetworkUnavailable.

This release sees improvements to the staggered deployment functionality for Edge Stacks. Timeout values now apply to the batch when performing parallel deployments, helping avoid issues where a failed environment in a batch could halt the entire deployment unexpectedly.

We've also made significant changes in how we log within Portainer, in particular for OAuth authentication and for Edge devices. OAuth logs now have increased verbosity which should help with diagnosing issues with authentication timeouts. Edge API calls now give more information when they error, including the environment ID and name, which helps when dealing with lots of Edge environments.

As we do with every release, we’ve updated the versions of the third party binaries and libraries that we use within Portainer to newer versions. This resolves a number of reported CVEs as well as providing improved performance and functionality.

In our ongoing efforts to rely less on third-party systems, we've removed the Docker Compose binary that we used to embed with the Portainer image, and instead we're now using our own integrated system for stack and compose functionality. This lets us avoid any potential CVEs within the Docker Compose binary, resulting to a more secure image, and has also improved performance when dealing with stacks.

You can read more about our release principles in our .

Podman support

This release brings official Podman support to Portainer. You can now as well as , just like Docker and Kubernetes environments through the environment wizard, and are managed in just the same way. You can deploy containers and stacks, pull images, inspect logs, and everything else you'd expect on your Podman environment.

Omni Integration

We're excited to introduce our integration with Sidero's Omni platform in this release. With Omni, you can provision, configure and manage Talos Linux servers running Kubernetes environments right from the Portainer UI with .

The Portainer and Sidero teams will be running a live demo and workshop of this integration at KubeCon Europe in London on the 1st of April! Spaces are strictly limited, so if you're interested you can !

Manage Kubernetes Jobs and Cron Jobs

Adding to our management of Kubernetes object types, you can now view and manage within Portainer.

You will find this functionality under on Kubernetes environments.

New Kubernetes security options

Ask the AI link

Portainer support bundle

Expanded ACI support

Performance optimizations

Smaller Git clones

Added conditions to Kubernetes nodes

Edge Stacks: Staggered deployment improvements

Improved logging

Additional option for session timeout

In 2.27 we've expanded the for authentication to include a 30 minute option. This helps to meet with security requirements around session timeout as well as giving you more options to suit your particular needs.

Updated third-party binaries and libraries

Removal of included Docker Compose binary

lifecycle policy
install Portainer Server on Podman environments
add Podman environments to an existing Portainer installation
just a few clicks
sign up here
Cron Jobs and Kubernetes Jobs
More resources
session timeout options
release notes