Release notes
1.42.0
12 March 2026
This version is compatible with Kubernetes versions 1.32 to 1.34
Okteto Chart release 1.42 is designed to work with Okteto CLI 3.17.x
Deprecation Notice
- ⚠️ Important: Support for Kubernetes 1.32 will be removed in the next release (1.43). Support for Kubernetes 1.35 will be added. Please plan your cluster upgrades accordingly.
New Features
- Build Queue Enabled by Default: The build queue system introduced as opt-in in 1.41 is now enabled by default. Build requests are automatically routed to the optimal Okteto Build pod based on real-time metrics, and when all build pods are busy, builds enter a queue to ensure consistent performance. Customers on significantly older CLI versions will continue using the legacy build path automatically. If you need to opt out, set the admin variable
OKTETO_BUILD_QUEUE_ENABLEDtofalsevia Admin Variables
Improvements
- Persistent Namespace and Preview Indicators: The "Keep Awake" option has been renamed to "Persistent" across the Dashboard and CLI for consistency. Namespaces and Preview Environments marked as persistent now display a visual indicator in both the Okteto Dashboard and the CLI (
okteto namespace listandokteto preview list), making it easier to identify which environments are exempt from automatic sleep and garbage collection - Updated the Deploy dialog UI with a new drawer design for improved consistency across the Dashboard
Bug Fixes
- Fixed a panic in the API that occurred in rare situations where a Kubernetes resource was restarting and the error message was not provided by Kubernetes, which caused the API container to restart
1.41.1
17 February 2026
This version is compatible with Kubernetes versions 1.32 to 1.34
Okteto Chart release 1.41 is designed to work with Okteto CLI 3.16.x
Security
Fixed a critical vulnerability in the OAuth2 authentication flow that could allow an attacker to steal user credentials. We are not aware of any exploitation of this vulnerability in the wild.
We recommend all self-hosted customers upgrade to 1.41.1 as soon as possible. Full details will be published at a later date.
1.41.0
6 February 2026
This version is compatible with Kubernetes versions 1.32 to 1.34
Okteto Chart release 1.41 is designed to work with Okteto CLI 3.16.x
Breaking Changes
- Node Selector Fix for Installer Jobs: Fixed an issue where
globals.nodeSelectorswere not being correctly applied to installer jobs. This fix ensures node selectors are now properly enforced, but may cause pods to fail scheduling if they cannot reach the Okteto Control Plane due to infrastructure network firewalls or node placement constraints. Review your node selector configuration before upgrading.
New Features
- Build Queue System: Okteto now implements a build queue system that ensures consistent build performance and fair resource distribution. Build requests are automatically routed to the optimal Okteto Build pod based on real-time metrics (CPU pressure, memory usage, and IOPS). When all build pods are busy, builds enter a queue and wait until resources become available, preventing overload and ensuring predictable build times. This behavior is disabled by default but can be enabled by setting the
OKTETO_BUILD_QUEUE_ENABLEDfeature flag totruevia Admin Variables. Learn more about the Build Queue System
Improvements
- Configurable Build Service Thresholds: Administrators can now configure resource thresholds (CPU pressure, memory usage, and IOPS) directly from the Build Service admin dashboard to fine-tune when build pods are considered busy
- Restart Build Pods: Administrators can now restart individual Okteto Build pods directly from the Okteto Admin panel. This makes it easier to recover from Okteto Build issues without requiring Kubernetes admin access or contacting Okteto support.
- Okteto CLI 3.16.0 All container logs are now included with
okteto doctor
Bug Fixes
- Activity Metrics Accuracy Fix: Fixed an issue affecting instances with personal namespace garbage collection enabled, where system-initiated garbage collection operations were incorrectly counted as user activity, inflating usage metrics. The root cause was a loop where personal namespaces cycled between sleeping and active states, generating repeated system operations. Both issues are now resolved, ensuring reliable activity data and accurate namespace state reporting. Read the post-mortem
- Pod Affinity Fix for Shared Volumes: Fixed an issue where pods sharing persistent volume claims (PVCs) were not always scheduled on the same node. This ensures that services using shared storage in okteto up are correctly co-located.
- Okteto CLI 3.16.0 Fixed a race condition when running parallel builds locally where the
.okteto/.secretfolder could be deleted while other concurrent build processes were still using it, causing "no such file or directory" errors - Okteto CLI 3.16.0 Improved handling of transient network errors during builds, reducing false failures caused by temporary connectivity issues
1.40.1
17 February 2026
This version is compatible with Kubernetes versions 1.32 to 1.34
Okteto Chart release 1.40 is designed to work with Okteto CLI 3.15.x
Security
Fixed a critical vulnerability in the OAuth2 authentication flow that could allow an attacker to steal user credentials. We are not aware of any exploitation of this vulnerability in the wild.
We recommend all self-hosted customers upgrade to 1.40.1 as soon as possible. Full details will be published at a later date.
1.40.0
9 January 2026
This version is compatible with Kubernetes versions 1.32 to 1.34
Okteto Chart release 1.40 is designed to work with Okteto CLI 3.15.x
Breaking Changes
- Default Registry Change: Okteto now pulls images from GitHub Container Registry (ghcr.io) by default instead of Docker Hub. Images are still published to both registries. If you need to keep pulling from Docker Hub, see our guide on configuring your registry
New Features
- Builds Dashboard: Track and analyze your build performance with the new Builds dashboard in Okteto Insights. Monitor build metrics, success rates, and performance trends across your organization to optimize your CI/CD pipeline
- BuildKit Metrics and cgroups 1 Support: Added support for BuildKit metrics collection and cgroups v1 compatibility to improve monitoring and resource management capabilities
- Added
OKTETO_MANAGED_PODenvironment variable to all pods managed by Okteto for easier identification and filtering
Improvements
- Improved registry probe configuration for better reliability and performance
- Upgraded BuildKit to v0.26.3 for enhanced performance, stability, and security
- Updated the Catalog UI with new drawer design for improved user experience, all functionality remains the same
- Increased default timeout for destroying dependencies during namespace and preview environment deletion from 5 minutes to 30 minutes to better handle complex cleanup scenarios
Bug Fixes
- Okteto CLI 3.15.0: Fixed an issue where destroy operations would fail when the metrics server or custom metrics server was not available
Removal Notice
- Support for Kubernetes 1.31 has been removed in this release.
1.39.1
17 February 2026
This version is compatible with Kubernetes versions 1.31 to 1.33
Okteto Chart release 1.39 is designed to work with Okteto CLI 3.14.x
Security
Fixed a critical vulnerability in the OAuth2 authentication flow that could allow an attacker to steal user credentials. We are not aware of any exploitation of this vulnerability in the wild.
We recommend all self-hosted customers upgrade to 1.39.1 as soon as possible. Full details will be published at a later date.
1.39.0
5 December 2025
This version is compatible with Kubernetes versions 1.31 to 1.33
Okteto Chart release 1.39 is designed to work with Okteto CLI 3.14.x
New Features
- Build Service Admin Dashboard: Administrators can now monitor BuildKit performance and resource utilization through a new Build Service dashboard. Track real-time metrics including CPU pressure, memory usage, I/O pressure, and active builds for each BuildKit pod to ensure optimal build performance across your Okteto instance
Improvements
- Upgraded BuildKit to v0.26.2 for better performance, stability, and compatibility
- Added support for configuring the reloader image registry via
reloader.imageRegistry - Consolidated table columns and filter controls in the Admin view for Previews and Namespaces for a cleaner, more consistent UI
- Improved display of tooltips on disabled buttons in the UI
- Updated UI notifications with improved grouping and display behavior
- Okteto CLI 3.14.0: Improved Smart Builds performance by checking if images are already built in parallel
Bug Fixes
- Fixed tooltip overflow issues in the Catalog
- AI Agent: Improved SSH forwarder connection handling to prevent dropped or stuck sessions
- Updated Claude Code and npm libraries to address CVE-2025-64755
- Okteto CLI 3.14.0: Fixed
okteto doctorto track dev container logs to help troubleshootokteto upissues - Okteto CLI 3.14.0: Fixed the
--resetflag behavior inokteto up - Okteto CLI 3.14.0: Fixed SSH forwarder connection handling when connecting with the SSH agent
- Okteto CLI 3.14.0: Fixed
okteto upsupport for deployments withshareProcessNamespace: trueenabled
1.38.1
21 November 2025
This version is compatible with Kubernetes versions 1.31 to 1.33
Okteto Chart release 1.37 is designed to work with Okteto CLI 3.13.x
Bug Fixes
- Okteto CLI 3.13.3: Fixed a timeout issue when contacting the SSH agent during remote deploys where commands in the Okteto Manifest performed SSH operations
1.38.0
7 November 2025
This version is compatible with Kubernetes versions 1.31 to 1.33
Okteto Chart release 1.38 is designed to work with Okteto CLI 3.13.x
Important Notes
- Upgrade Considerations for Self-Hosted Customers: Internal certificates have been unified into a single configuration. During the upgrade, you may experience temporary communication issues lasting a few seconds as the new certificate configuration takes effect
- ArgoCD Users: If you manage your Okteto installation with ArgoCD, review our Argo CD guide. The certificate unification may require special attention during the ArgoCD sync process to avoid deployment interruptions.
New Features
- Enhanced Preview Environments Performance: Significantly improved loading performance, reducing load times by up to 15x for customers with large numbers of Preview Environments
- Advanced Preview Environments Filtering: Added comprehensive filtering options including search, repository, status, owner, and time-based filters to help teams quickly find specific preview environments
- Added read-only mode for Known Hosts configuration, allowing admins to lock down SSH host key management and prevent accidental modifications
Improvements
- Upgraded to BuildKit v0.25.2 for improved build performance and stability
- Updated Okteto AI Agent base image to Debian Trixie with Go 1.24.6 and Node.js 24
- Okteto AI: Added support for Claude Sonnet 4.5, the latest AI model optimized for software development tasks
- Improved Okteto Build cache isolation: Cache IDs now incorporate both the target path and repository name to prevent different repositories from accidentally sharing the same cache
- Okteto CLI 3.13.0: Enhanced namespace destruction logic and error handling during resource cleanup
Bug Fixes
- Fixed a problem when Known Hosts feature was enabled where the ssh-keyscan command kept being executed when it shouldn't
- Okteto CLI 3.13.0: Fixed nil pointer exception in build command when the specified Dockerfile doesn't exist
- Okteto CLI 3.13.0: Improved error handling in log streaming during resource destruction as logs were not being fully displayed
- Okteto CLI 3.13.0: Fixed cache isolation in
okteto testwhere different test containers sharing the same cached directory could reuse each other's cache. Caches are now properly isolated and only reused across executions of the same test container
1.37.3
21 November 2025
This version is compatible with Kubernetes versions 1.31 to 1.33
Okteto Chart release 1.37 is designed to work with Okteto CLI 3.12.x
Bug Fixes
- Okteto CLI 3.12.3: Fixed a timeout error contacting with the SSH agent on remote deploys when some of the commands defined in the Okteto Manifest were performing SSH operations
1.37.2
15 October 2025
This version is compatible with Kubernetes versions 1.31 to 1.33
Okteto Chart release 1.37 is designed to work with Okteto CLI 3.12.x
Bug Fixes
- Fixed repository cloning failures with SSH host verification - Resolved conflicts between automatic SSH scanning and admin-configured known hosts that could cause deployment failures.
1.37.1
7 October 2025
This version is compatible with Kubernetes versions 1.31 to 1.33
Okteto Chart release 1.37 is designed to work with Okteto CLI 3.12.x