Skip to main content
Version: 1.40

Release notes

1.40.0​

[Release date TBD]

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

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 doctor to track dev container logs to help troubleshoot okteto up issues
  • Okteto CLI 3.14.0: Fixed the --reset flag behavior in okteto up
  • Okteto CLI 3.14.0: Fixed SSH forwarder connection handling when connecting with the SSH agent
  • Okteto CLI 3.14.0: Fixed okteto up support for deployments with shareProcessNamespace: true enabled

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 test where 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

Improvements​

1.37.0​

1 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

Breaking Changes​

  • Removed the dependency on the Bitnami Redis Helm chart. Okteto now ships its own Kubernetes templates to deploy Redis
  • We've changed the default value of pullAlways to false for pods deployed in Okteto-managed namespaces. This speeds up pod creation when images are already present on the node, while still allowing pullAlways to be explicitly enabled if needed

New Features​

  • Added a centralized Known Hosts feature to the Admin UI (Admin → Settings → Known Hosts). Admins can now pin trusted SSH host keys and disable automatic ssh-keyscan, ensuring secure, consistent cloning of repositories and submodules without custom runner images

Improvements​

  • Improved error handling in the Okteto AI Agent UI for API errors and "Prompt too long" warnings
  • Temporal rate limit (QPS exceeded) errors now return as "progressing" instead of failing immediately
  • We've renamed AI Agent Fleets to Okteto AI throughout the product
  • Okteto CLI 3.12.0: Updated Syncthing to 2.0.x for improved synchronization performance
  • Okteto CLI 3.12.0: Added support for endpoint_mode in Compose files (see documentation).

Bug Fixes​

  • Fixed issues with endpoint handling in the Okteto AI Agent view, including non-scrollable lists and incorrect display of custom endpoints
  • Fixed an "unable to load agent" error when returning focus to the window
  • Fixed autoscroll behavior when sending a new prompt in the Agent UI
  • Okteto CLI 3.12.0: Improved CLI stability by waiting for SSE when streaming logs for pipeline, preview, deploy, and destroy operations

1.36.2​

12 September 2025

This version is compatible with Kubernetes versions 1.31 to 1.33
Okteto Chart release 1.36 is designed to work with Okteto CLI 3.11.x

Improvements​

  • Improve Okteto UI UX by showing "Pulling" status when encountering transient pull QPS exceeded errors

Bug Fixes​

  • Fixed an issue with Kubernetes credential configuration in the delete agent job
  • Fixed a UI issue where the list of endpoints in the agent view was not scrollable

1.36.1​

9 September 2025

This version is compatible with Kubernetes versions 1.31 to 1.33
Okteto Chart release 1.36 is designed to work with Okteto CLI 3.11.x

Bug Fixes​

  • Fixed an issue with streaming Okteto Agent installation logs that was preventing the agent chat from loading

1.36.0​

5 September 2025

This version is compatible with Kubernetes versions 1.31 to 1.33
Okteto Chart release 1.36 is designed to work with Okteto CLI 3.11.x

Okteto AI Now Available (Beta)​

Okteto AI brings the power of AI directly into your development workflow, powered by Claude Code from Anthropic. Each agent operates independently in its own Kubernetes namespace with full isolation, giving you the safety and control you need for AI-assisted development.

Key Capabilities​

  • Intelligent Repository Onboarding: Agents can quickly understand and work with existing codebases, analyzing project structure, dependencies, and patterns to get up to speed faster than ever
  • Application Scaffolding: Generate new services, APIs, and applications from natural language descriptions, complete with best practices and proper project structure
  • Task Automation: Automate common development tasks like adding endpoints, refactoring code, updating dependencies, or implementing new features
  • Real Containerized Environments: All agents run in production-like Kubernetes environments with access to the same runtime, secrets, and configurations as your actual development setup
  • Parallel Execution: Launch multiple agents simultaneously to work on different features or experiments independently

For Administrators​

Organization administrators have full control over Okteto AI deployment:

  • Enable the feature for your organization through the Admin Dashboard under Admin > Okteto AI
  • Toggle access per user to control who can launch AI agents in your organization
  • Configure LLM keys - Provide your own Anthropic API key (directly from Anthropic or via Amazon Bedrock)

We're continuously improving Okteto AI based on your feedback. Try it today and let us know how it transforms your development workflow!

New Features​

Improvements​

  • Installer now retries transient connection issues
  • Okteto CLI 3.11.0: Added support for overriding the readOnlyRootFilesystem property in the securityContext of dev containers defined in the Okteto Manifest

Bug Fixes​

  • Fixed previews layout issue that could hide logs when breadcrumb is visible
  • Okteto CLI 3.11.0: Fixed a panic when deploying an Okteto manifest with Divert using okteto up or okteto test
  • Okteto CLI 3.11.0: Fixed an issue with the --wait flag in okteto deploy when deploying a subset of services from a Compose file. The command no longer hangs until timeout

1.35.2​

29 August 2025

This version is compatible with Kubernetes versions 1.31 to 1.33
Okteto Chart release 1.35 is designed to work with Okteto CLI 3.10.x

Bug Fixes​

  • Downgrade BuildKit dependency to version 0.22.0 to avoid a bug that was causing a huge consumption in CPU, provoking poor performance and stuck builds.

1.35.1​

12 August 2025

This version is compatible with Kubernetes versions 1.31 to 1.33
Okteto Chart release 1.35 is designed to work with Okteto CLI 3.10.x

Bug Fixes​

  • Fixed an issue in the daemonset which was causing the component to fail when the Okteto instance was not using self-signed certificates nor private CAs.

1.35.0​

1 August 2025

This version is compatible with Kubernetes versions 1.31 to 1.33
Okteto Chart release 1.35 is designed to work with Okteto CLI 3.10.x

New Features​

  • Added support for Kubernetes 1.33 (support for 1.30 has been removed) and Amazon Linux 2023. Please follow our upgrade guide when moving to Amazon Linux 2023
  • CIDR-based traffic filtering is now supported for BYOC (Bring Your Own Cluster) environments. Use this to improve security by restricting access to Okteto services to specific IP ranges.
  • Namespace deletion now properly applies the timeout value to dev environments that use a destroy section in their manifest. Previously, if a dev environment took longer than 5 minutes to destroy gracefully, the overall namespace deletion would fail, even if a longer timeout was specified.
  • Added support for loadBalancerSourceRanges in the BuildKit service configuration to better control external access
  • Okteto CLI 3.10.0: Okteto now supports inheriting Kubernetes nodeSelector and resource settings in Development Environments. When omitted from the okteto.yaml manifest, these values can be pulled from the base Kubernetes resources using the OKTETO_INHERIT_KUBERNETES_RESOURCES and OKTETO_INHERIT_KUBERNETES_NODESELECTOR feature flags.

Improvements​

  • Okteto CLI 3.10.0: Improved the okteto deploy command to avoid rebuilding all images when deploying a compose and only a subset of services are being deployed.
  • Okteto CLI 3.10.0: Updated the okteto preview destroy command to correctly propagate the --timeout flag to the backend, ensuring longer destroy operations don’t fail prematurely. ⚠️ This requires both CLI 3.10.0 and Chart 1.35.
  • Okteto CLI 3.10.0: Enhanced okteto context use to better handle invalid or expired local tokens. The CLI will now prompt for login rather than failing with a non-actionable error.

Bug Fixes​

  • Fixed an issue that prevented some development environments from waking up as expected when there were dependency cycles between dev environments
  • Improved AWS IAM Role regex handling for tighter validation on Private Registry Credentials and Cloud Credentials

Removal Notice​

  • Support for Kubernetes 1.30 has been removed in this release.

1.34​

3 July 2025

This version is compatible with Kubernetes versions 1.30 to 1.32
Okteto Chart release 1.34 is designed to work with Okteto CLI 3.9.x

Improvements​

  • Okteto CLI 3.9.0: Added a feature flag to return services in development to their "running" state (okteto down) when exiting the terminal session
  • Okteto CLI 3.9.0: Included a feature flag to make dev.<name>.services wait for file synchronization to finish before running their commands during okteto up execution

Bug Fixes​

  • Fixed the "Retry Destroy" action so it now performs a graceful deletion instead of triggering a force destroy. Previously, both "Retry Destroy" and "Force Destroy" were triggering a force deletion
  • Fixed breadcrumb layout regressions across several updates
  • Prevented UI overflow of the redeploy button in the resources sidebar
  • Fixed an error when running okteto test with defined artifacts but no output files; the /okteto/artifacts directory is now created by default to prevent execution failures

1.33.1​

19 June 2025

This version is compatible with Kubernetes versions 1.30 to 1.32
Okteto Chart release 1.33 is designed to work with Okteto CLI 3.8.x

Bug Fixes​

  • Fixed a glitch in the breadcrumb within the preview detail view when the monitor used has a big resolution

1.33.0​

13 June 2025

This version is compatible with Kubernetes versions 1.30 to 1.32
Okteto Chart release 1.33 is designed to work with Okteto CLI 3.8.x

New Features​

  • Introduced support for dependency-aware redeploy and destroy operations in multi-service environments
    • Okteto CLI 3.8.0: New --dependencies flag for okteto pipeline deploy, okteto preview deploy, and okteto pipeline destroy commands to include direct dependencies (defaults follow admin-level configuration)
    • New environment variable format OKTETO_DEPENDENCY_${DEPENDENCY_NAME}_BUILD_${BUILD_SVC}_${BUILD_ENVVAR} for accessing dependency-specific build variables
    • ⚠️ Note: The --dependencies flag only applies to direct dependencies and does not recurse further to avoid impacting cyclic relationships
  • New Deployments admin panel allowing configuration of default behavior for:
    • Redeploying all direct dependencies by default
    • Destroying all direct dependencies by default
  • Added a checkbox option in both the redeploy and destroy dialogs to optionally include direct dependencies when present

Improvements​

  • Enforced GitHub App ID type as int64 for configmap rendering consistency to avoid fatal errors in the API components when the field was specified without quotes in the helm values
  • Added breadcrumbs to the Preview Environment details page to make navigation easier
  • Okteto CLI 3.8.0: okteto namespace list now supports an output option to specify json or yaml formats as okteto preview list

Bug Fixes​

  • Fixed text overflow issue in Resource Manager UI for small screens
  • Hid sidebar redeploy button on smaller screens to avoid UI clutter
  • Fixed "back to catalog" link navigation
  • Fixed ellipsis rendering issues in previews

1.32.0​

8 May 2025

This version is compatible with Kubernetes versions 1.30 to 1.32
Okteto Chart release 1.32 is designed to work with Okteto CLI 3.7.x

New Features​

  • Added support for waking up development environments without dependencies in parallel. This behavior is disabled by default and can be enabled via the feature flag OKTETO_PARALLEL_WAKE_UPS_FOR_DEVENVS. When dependencies exist, their defined startup order is still respected

Improvements​

  • Refreshed the Okteto Dashboard UI to improve the visual design and lay the groundwork for features coming later this year. The changes are purely visual; everything is still in the same place
  • Included changes to prevent an empty stage Deploy <<dev environment name>> log entries in the UI when deployments are triggered via okteto deploy from the CLI
  • Upgraded our BuildKit client to 0.21.1 for improved performance and stability
  • Enhanced privacy and security by removing sensitive repository information when Development Environments are deployed using the GitHub App integration
  • All pods deployed within a diverted Namespace now have 2 environment variables automatically injected that can be used at runtime. OKTETO_SHARED_ENVIRONMENT contains the name of the shared Namespace where all the services are deployed, and OKTETO_DIVERTED_ENVIRONMENT contains the routing key used to route the traffic to the proper version of the service (its value is the name of the Namespace where diverted services are deployed)
  • Endpoints in namespaces that include diverted services are now correctly displayed in the UI when using the nginx driver

Bug Fixes​

  • Okteto CLI 3.7.0: Fixed a bug in the Smart Builds hash calculation process that caused indefinite hangs when hundreds of untracked files existed in the local Git repository
  • Unified the HTTP header used in Divert to propagate the routing key for both drivers nginx and istio. istio driver was using baggage header with the key okteto-divert, but nginx driver was using the header baggage.okteto-divert. Now, both drivers use the same standard baggage header as baggage: okteto-divert=<routing-key>. For the nginx driver, the header baggage.okteto-divert is still being injected automatically for backward compatibility, but it will be removed in the future
  • Fixed an issue when using both Divert and endpoints to deploy a Development Environment. Endpoints for the diverted namespaces were not working as expected, as the HTTP header with the routing key was not being injected into the request

1.31.0​

4 April 2025

This version is compatible with Kubernetes versions 1.30 to 1.32
Okteto Chart release 1.31 is designed to work with Okteto CLI 3.6.x

Deprecation Notice​

  • ⚠️ Important: Support for Docker Image Manifest Schema 1 images is removed in this (1.31) due to upstream dependency changes. If you are using older images, they may fail to pull or deploy.
    Learn how to check and update your images →

New Features​

  • Added a new Okteto API endpoint to list users
  • Added support for waking up resources within Development Environments respecting the dependencies defined through depends_on field in Docker Compose. By default this behavior is disabled, but it can be enabled with the feature flag OKTETO_COMPOSE_WAIT_FOR_DEPENDENCIES (requires redeploying the application with Okteto CLI 3.6.0).
  • Added support for Kubernetes 1.32 (previous support for 1.29 was removed)

Improvements​

  • Improved error messages when ssh-keyscan error fails for deploys triggered from the UI, okteto pipeline deploy or okteto preview deploy
  • Patched IngressNightmare CVE-2025-1974 to enhance platform security
  • Upgraded our BuildKit client to 0.20.2

Bug Fixes​

  • The baggage.divert header is now properly propagated to downstream services when using the nginx divert driver, allowing services to detect diverted requests
  • Fixed an issue where logs appeared out of order on initial load
  • Support bundles now include Ingress NGINX logs and Helm values for installations managed via ArgoCD
  • Fixed UI overflow in the deploy dialog when rendering long lists

Removal Notice​

  • Support for Kubernetes 1.29 has been removed in this release.

1.30.1​

26 March 2025

This version is compatible with Kubernetes versions 1.29 to 1.31
Okteto Chart release 1.30 is designed to work with Okteto CLI 3.5.x

Improvements​

  • Updated ingress-nginx dependency as a preventive measure for a critical vulnerability. Note: The affected admission webhook component is not enabled by default in our deployments, but it could be enabled through helm settings

Bug Fixes​

  • baggage.okteto-divert HTTP header is now included on every request going through the ingress-controller when using nginx driver for Divert
  • Okteto CLI 3.5.1: Fixed Smart Builds cache calculation when the git repository has a high number of files in the build context

1.30.0​

7 March 2025

This version is compatible with Kubernetes versions 1.29 to 1.31
Okteto Chart release 1.30 is designed to work with Okteto CLI 3.5.x

Deprecation Notice​

  • ⚠️ Important: Support for Docker Image Manifest Schema 1 images will be removed in next release (1.31) due to upstream dependency changes. If you are using older images, they may fail to pull or deploy.
    Learn how to check and update your images →

New Features​

Improvements​

  • Automatic Cleanup of Orphaned Namespaces: Namespaces with no owner will now be automatically garbage collected to free up resources
  • The ingress-nginx package has been upgraded to 4.12.0
  • Improved the interaction between helm and Horizontal Pod Autoscaler(HPA) to avoid longer upgrade periods and unnecessary BuildKit restarts when the number of replicas specified in helm values differs from the ones HPA enforces
  • If a deployment via UI, okteto pipeline deploy, or okteto preview deploy can’t be scheduled, it will be marked as failed after 5 minutes.
  • Okteto CLI 3.5.0: Files listed in .dockerignore can now be excluded from the smart build context calculation by setting the Admin Variable OKTETO_SMART_BUILDS_IGNORE_FILES_ENABLED to true
  • Okteto CLI 3.5.0: We've optimized remote executions of Deploy and Destroy operations when buildkit execution is not needed

Bug Fixes​

  • Init container logs now appear before container logs in history
  • Okteto CLI 3.5.0: The CLI now waits if Buildkit is not available
  • Okteto CLI 3.5.0: The OKTETO_AUTODEPLOY feature flag now works as intended when set
  • Okteto CLI 3.5.0: Fixed re-deploy logic for compose files with depends_on between services. If a dependency failed in a previous operation, a redeploy sometimes was being considered failed as it was taking into account the previous state

Removal Notice​

  • Support for Kubernetes 1.28 has been removed in this release.

1.29.0​

7 February 2025

This version is compatible with Kubernetes versions 1.28 to 1.31
Okteto Chart release 1.29 is designed to work with Okteto CLI 3.4.x

New Features​

  • Added support for Kubernetes 1.31
  • Personal Namespaces can now be included in your Garbage Collection Policy
    • Personal Namespaces themselves will not be deleted, but their unused resources (e.g., Pods, Services, ConfigMaps) will be removed following the Sleep and Delete Period settings
    • To leave developer workflows untouched, Persistent Volume Claims (PVCs) within Personal Namespaces will not be deleted as part of this process
  • Introducing the Okteto API (Beta)! 🎉 Now you can get programmatic information on namespaces and applications with authenticated API requests. Access the full API documentation via the Okteto Dashboard under Admin → Admin Access Tokens

Improvements​

  • Okteto CLI 3.4.0: Optimized image building in okteto up: Now, only the necessary images required for the process are built, instead of building all images. This reduces build times, speeds up environment startup, and minimizes unnecessary resource usage
  • Okteto CLI 3.4.0: Improve warnings when a CLI user has a different version than within the accepted range set by the Okteto Admin
  • Added a warning for users on older browsers that may have compatibility issues

Bug Fixes​

  • Fixed an issue where Divert would not work with Docker Compose as intended
  • Buildkit in rootless mode when running in Kubernetes 1.30 no longer adds a deprecated annotation
  • Fixed an issue where Okteto failed to inject the ingress-nginx controller’s private IP in Okteto components when the service name was too long

Removal Notice​

  • Support for Kubernetes 1.27 has been removed in this release.

1.28.2​

14 January 2025

This version is compatible with Kubernetes versions 1.27 to 1.30
Okteto Chart release 1.28 is designed to work with Okteto CLI 3.3.x

Bug Fixes​

  • Okteto CLI 3.3.1: Fixed an issue when deploying with divert through a docker compose file

1.28.1​

10 January 2025

This version is compatible with Kubernetes versions 1.27 to 1.30
Okteto Chart release 1.28 is designed to work with Okteto CLI 3.3.x

Bug Fixes​

  • Okteto CLI 3.3.0: Fixed an issue where deployments of Compose files would always time out after 5 minutes
  • Okteto CLI 3.3.0: Resolved a permission issue when deploying Compose files with volumes that were being initialized

1.28.0​

10 January 2025

This version is compatible with Kubernetes versions 1.27 to 1.30
Okteto Chart release 1.28 is designed to work with Okteto CLI 3.3.x

New Features​

Improvements​

Bug Fixes​

  • Addressed inconsistent states in the logs filters within the UI to improve reliability
  • Fixed an issue where the okteto deploy command did not correctly receive variables specified in the commands section of an Okteto Manifest