# Okteto Documentation


## docs

- [Search the documentation](/docs/search.md)
- [Tutorials](/docs/tutorials.md)
- [AWS Lambda functions with Okteto](/docs/tutorials/aws-lambda.md): Deploy an AWS Lambda function in your development environment
- [Docker Compose on Kubernetes](/docs/tutorials/compose-getting-started.md): Develop an application with Okteto using Docker Compose files
- [Use Volume Snapshots to Create Development Environments with Real Data](/docs/tutorials/create-and-use-volume-snapshots.md): Learn how to generate volume snapshots of an application’s database, and how to use it when creating a new Development Environment.
- [Getting started with Okteto Divert](/docs/tutorials/divert.md): Simplify your Development Environments with Divert
- [Getting started with Okteto External Resources](/docs/tutorials/external-resources.md): Include external resources in your development environments
- [Getting started with Okteto](/docs/tutorials/getting-started-with-okteto.md): A step by step guide to configure an Okteto Manifest
- [Optimize your Okteto Development Environment](/docs/tutorials/optimize-your-development-environment.md): Our recommendations on how to optimize your Okteto Environments
- [Using LaunchDarkly and Okteto To Automate Feature Flag Management](/docs/tutorials/using-launchdarkly-and-okteto-to-automate-modern-feature-flag-management.md): Leverage feature flags during development with LaunchDarkly and Okteto
- [Configure Webpack to work inside a container](/docs/tutorials/webpack.md): Optimize your configurations to work inside a Docker container
- [Okteto Administration](/docs/admin.md): Administering your Okteto instance
- [Billing](/docs/admin/billing.md): Okteto bills per seat on an annual contract. Run as many environments and agents as your infrastructure supports. For Enterprise, your license covers all your Okteto clusters and we count unique seats across the fleet.
- [Build Service Management](/docs/admin/build-service.md): Monitor and manage BuildKit performance and resource utilization
- [Catalog ScaleEnterpriseSelf-Hosted](/docs/admin/catalog.md): Administrators can create a Catalog of pre-defined development environments for developers to use.
- [Garbage Collector](/docs/admin/cleanup.md): The Garbage Collector helps keep your infra costs under control by sleeping or deleting inactive environments.
- [Cloud Credentials](/docs/admin/cloud-credentials.md): Manage and configure cloud credentials for your Okteto instance
- [Configure access to your AWS account using IAM Roles](/docs/admin/cloud-credentials/aws-cloud-credentials.md): Configure AWS IAM credentials for your Okteto instance using OIDC federation to grant development environments access to AWS resources.
- [Configure access to your GCP account using Workload ID](/docs/admin/cloud-credentials/gcp-cloud-credentials.md): Configure Google Cloud credentials for your Okteto instance using Workload Identity Federation to grant development environments access to GCP resources.
- [Custom Installer Image](/docs/admin/custom-installer-image.md): Use a custom installer image to deploy your Development Environments
- [Admin Dashboard ScaleEnterpriseSelf-Hosted](/docs/admin/dashboard.md): The Admin Dashboard provides a centralized interface to manage users, Namespaces, integrations, and settings for your Okteto instance.
- [Okta User Deprovisioning](/docs/admin/integrations/okta-user-deprovisioning.md): Automatically deprovision okteto users when they are removed from Okta
- [Okteto API Documentation](/docs/admin/okteto-api.md): Programmatic access to resources managed by Okteto
- [Okteto Insights](/docs/admin/okteto-insights.md): Configure Okteto Insights for detailed analytics on resource usage, build, and deployment metrics
- [Managing Preview Environments ScaleEnterpriseSelf-Hosted](/docs/admin/previews.md): Manage Preview Environments from the Admin Dashboard
- [GitHub](/docs/admin/private-repositories/github-app.md): Use our GitHub Integration so your users can access private repositories in their development environments
- [Authenticating with an SSH Key ScaleEnterpriseSelf-Hosted](/docs/admin/private-repositories/ssh-key.md): Use an SSH key so your users can access private repositories in their development environments
- [Registry Credentials](/docs/admin/registry-credentials.md): Manage and configure your registry credentials
- [Amazon ECR](/docs/admin/registry-credentials/amazon-ecr.md): Get Private Registry credentials from Amazon ECR
- [Azure Container Registry](/docs/admin/registry-credentials/azure-acr.md): Get Private Registry credentials from Azure Container Registry
- [DockerHub](/docs/admin/registry-credentials/dockerhub.md): Get Private Registry credentials from DockerHub
- [Google Artifact Registry](/docs/admin/registry-credentials/google-artifact-registry.md): Get Private Registry credentials from Google Artifact Registry
- [Resource Manager](/docs/admin/resource-manager.md): Automated resource management that adapts to changes in real utilization over time
- [SSH Known Hosts](/docs/admin/ssh-known-hosts.md): Centrally manage trusted known hosts for SSH connections in Okteto
- [Agentic Workflows](/docs/agentic.md): Install the Okteto plugin for Claude Code to give AI agents the knowledge to deploy, test, and debug code in Okteto environments
- [Autonomous Workflows](/docs/agentic/autonomous-workflows.md): How AI agents handle the full development lifecycle from ticket to pull request using Okteto
- [Best Practices and Troubleshooting](/docs/agentic/best-practices.md): Common pitfalls when using AI agents with Okteto and how to avoid them
- [Collaborative Workflows](/docs/agentic/collaborative-workflows.md): How developers and AI agents work together using okteto up and okteto exec
- [AI Agent Environments](/docs/ai-agent-environments.md): Give AI agents isolated, production-like environments to build, test, and verify their changes against real services and data. Launch managed agents from the Okteto Dashboard with Okteto AI, or connect your own agent tooling with Agentic Workflows.
- [Archived Release Notes](/docs/archived-release-notes.md): Release notes from archived Okteto versions that are no longer actively maintained, covering features and changes from older releases.
- [The Okteto Platform](/docs/byoc-vs-self-hosted.md): The difference between Okteto's Bring Your Own Cloud (BYOC) and Self-Hosted product offerings
- [Okteto Bring Your Own Cloud (BYOC)](/docs/byoc.md): Introduction to Okteto Bring Your Own Cloud (BYOC)
- [Okteto BYOC on AWS](/docs/byoc/aws.md): How to get started with Okteto BYOC on AWS
- [Okteto BYOC on GCP](/docs/byoc/gcp.md): How to get started with Okteto BYOC on GCP
- [Core Concepts](/docs/core.md): Okteto organizes development around Namespaces, credentials, networking, builds, and a central manifest.
- [Okteto Build Service](/docs/core/build-service.md): The Okteto Build Service allows you to build your container images remotely
- [Okteto Registry](/docs/core/container-registry.md): The Okteto Registry allows every Okteto Namespace to have its own space to store its container images
- [Environment Variables](/docs/core/credentials/environment-variables.md): Specify your credentials using environment variables
- [Download your Kubernetes credentials](/docs/core/credentials/kubernetes-credentials.md): Download your Kubernetes credentials and start developing your applications in Okteto
- [Personal Access Tokens](/docs/core/credentials/personal-access-tokens.md): Use Personal Access Tokens to Interact with the Okteto API
- [Divert](/docs/core/divert.md): Intelligent traffic routing for efficient microservice development
- [Automatic SSL endpoints](/docs/core/endpoints/automatic-ssl.md): Automatically create an SSL endpoint for your deployments
- [Private endpoints](/docs/core/endpoints/private-endpoints.md): Restrict access to your application's endpoints
- [Okteto Namespaces](/docs/core/namespaces.md): Organize your Development Environments with Okteto Namespaces for you and your team
- [Okteto Insights Dashboards](/docs/core/okteto-insights-dashboards.md): Use Okteto Insights for detailed analytics on resource usage, build, and deployment metrics
- [Okteto Manifest Overview](/docs/core/okteto-manifest.md): An overview of the Okteto Manifest and its core features.
- [Okteto Variables](/docs/core/okteto-variables.md): Okteto Variables allows you to save application configuration in Okteto and automatically inject them during deployment time
- [Remote Execution](/docs/core/remote-execution.md): How Okteto runs your commands in the cluster
- [Volume Snapshots in Development Environments](/docs/core/use-volume-snapshots.md): Okteto Volume Snapshots let you initialize persistent volumes from previous snapshots to populate Development Environments with production or staging data.
- [User Roles and Permissions in Okteto](/docs/core/user-roles-and-permissions.md): Understand User Roles and Permissions in the Okteto Platform
- [Development Environments on Kubernetes](/docs/development.md): Okteto Development Environments let you code locally while your application runs on Kubernetes, with real-time file sync and hot reload.
- [Development Containers](/docs/development/containers.md): In this section, we'll see how you can use Development Containers on Okteto
- [File Sync Mode](/docs/development/containers/file-sync.md): In this section, we'll see how you can use File Sync mode to develop on Okteto
- [Getting Started with Okteto and ASP.NET](/docs/development/containers/file-sync/aspnetcore.md): This tutorial will show you how to develop and debug an ASP.NET application using Okteto
- [Getting Started with Okteto and Go](/docs/development/containers/file-sync/golang.md): This tutorial will show you how to develop and debug a Go application using Okteto
- [Getting Started with Okteto and Java](/docs/development/containers/file-sync/java.md): This tutorial will show you how to develop and debug a Java application using Okteto
- [Getting Started with Okteto and Node.js](/docs/development/containers/file-sync/node.md): This tutorial will show you how to develop and debug a Node.js application using Okteto
- [Getting Started with Okteto and PHP](/docs/development/containers/file-sync/php.md): This tutorial will show you how to develop and debug a PHP application using Okteto
- [Getting Started with Okteto and Python](/docs/development/containers/file-sync/python.md): This tutorial will show you how to develop and debug a Python application using Okteto
- [Getting Started with Okteto and Ruby](/docs/development/containers/file-sync/ruby.md): This tutorial will show you how to develop and debug a Ruby application using Okteto
- [Hybrid Development Mode](/docs/development/containers/hybrid.md): In this section, you'll see how you can use using hybrid mode to develop on Okteto
- [Getting Started with Hybrid Mode for Frontend Development](/docs/development/containers/hybrid/hybrid-frontend.md): This tutorial will show you how to develop a frontend service using hybrid mode
- [Getting Started with Hybrid Mode for Java Development](/docs/development/containers/hybrid/hybrid-java.md): This tutorial will show you how to develop a java service using hybrid mode
- [Deploy your Development Environments](/docs/development/deploy.md): In this section, we'll learn different ways to deploy your Development Environment
- [Deploy Development Environments from your Catalog ScaleEnterpriseSelf-Hosted](/docs/development/deploy/deploy-from-catalog.md): Deploy development environments directly from your Catalog
- [Deploy your Development Environments from your Git Repositories](/docs/development/deploy/deploy-from-git.md): Deploy your development environments directly from your Git repositories
- [Develop On Okteto Button](/docs/development/deploy/develop-on-okteto-button.md): Deploy your development environments from your Git repositories
- [From private repositories](/docs/development/deploy/from-private-repositories.md): Deploy your development environments from your private Git repositories
- [Development images](/docs/development/images.md): Configure development images for your Development Containers
- [Using Divert](/docs/development/using-divert.md): Practical guide for implementing Divert in your development workflow
- [Using the Okteto CLI](/docs/development/using-okteto-cli.md): Introduction to Okteto CLI
- [Advanced Commands & Concepts for Developers](/docs/get-started/advanced-commands-and-concepts.md): Introduction to development concepts within Okteto
- [Deploy Your Application to Okteto](/docs/get-started/deploy-your-app.md): In this section, we'll see how you can onboard your apps to Okteto
- [Build your container images with Okteto](/docs/get-started/deploy-your-app/build.md): In this section, you'll see how you can build your container images with Okteto
- [Add a database as a dependency](/docs/get-started/deploy-your-app/dependencies.md): In this section, we'll see how you can deploy dependencies on other repositories
- [Deploy your application](/docs/get-started/deploy-your-app/deploy.md): In this section, we'll show you how to configure Okteto to deploy your app
- [Expose your application on a public endpoint](/docs/get-started/deploy-your-app/endpoints.md): In this section, we'll see how to expose your app on public endpoints
- [Using Okteto as a Developer](/docs/get-started/dev-quickstart.md): This guide will help you to get started with Okteto as a developer
- [Install the Okteto CLI](/docs/get-started/install-okteto-cli.md): This guide will help you get started by installing the Okteto CLI
- [Installation Overview](/docs/get-started/install.md): How to install Okteto in your Kubernetes cluster
- [Amazon Elastic Kubernetes Service (EKS)](/docs/get-started/install/amazon-eks.md): How to install Okteto onto Amazon Elastic Kubernetes Service (EKS)
- [Civo](/docs/get-started/install/civo.md): How to install Okteto onto Civo
- [DigitalOcean Kubernetes (DOKS)](/docs/get-started/install/digitalocean-doks.md): How to install Okteto onto DigitalOcean Kubernetes
- [Google Kubernetes Engine (GKE)](/docs/get-started/install/google-gke.md): How to install Okteto onto Google Kubernetes Engine (GKE)
- [Azure Kubernetes Service (AKS)](/docs/get-started/install/microsoft-aks.md): How to install Okteto onto Azure Kubernetes Service (AKS)
- [Red Hat OpenShiftEnterpriseSelf-Hosted](/docs/get-started/install/openshift.md): How to install Okteto onto Red Hat OpenShift
- [Using the Okteto CLI and Dashboard](/docs/get-started/using-okteto-cli-and-dashboard.md): Introduction to the Okteto CLI and Dashboard
- [Okteto AI](/docs/okteto-ai.md): Launch and manage AI agents from the Okteto Dashboard to develop, test, and debug code in sandboxed environments
- [Okteto AI - Getting Started](/docs/okteto-ai/ai-getting-started.md): Launch your first AI agent from the Okteto Dashboard and learn how to get the best results
- [Okteto AI - Admin Configuration Guide](/docs/okteto-ai/okteto-ai-admin-config.md): In this section, we will show you how to configure Okteto AI for your team
- [Preview Environments](/docs/previews.md): Create a preview environment for your application using Okteto
- [Preview environments using GitHub Actions](/docs/previews/using-github-actions.md): Create a preview environment for your application using Okteto and GitHub Actions
- [Preview environments using GitLab CI/CD](/docs/previews/using-gitlab-cicd.md): Configure GitLab CI/CD to automatically create Preview Environments for your application using Okteto.
- [References](/docs/reference.md): Explore Okteto reference documentation including CLI commands, the Okteto Manifest schema, environment variables, and configuration options.
- [Docker Compose Reference](/docs/reference/docker-compose.md): Okteto allows you to develop applications using docker-compose files
- [Frequently Asked Questions (FAQs)](/docs/reference/faqs.md): Frequently asked questions about Okteto
- [Feature Flags](/docs/reference/feature-flags.md): Okteto's feature flags on the CLI
- [File Synchronization](/docs/reference/file-synchronization.md): Okteto keeps your local files synchronized with your development environment
- [Known Issues](/docs/reference/known-issues.md): Known issues and workarounds for Okteto development environments, including hot-reload limitations and Windows terminal compatibility.
- [Migrating to Okteto CLI 2.0](/docs/reference/manifest-migration.md): Migrate from Okteto Manifest v1 to the v2 format introduced in Okteto CLI 2.0, which consolidates build, deploy, and development into a single command.
- [Okteto CLI](/docs/reference/okteto-cli.md): The Okteto Command Line Interface is a unified tool to manage your development environments
- [Okteto Manifest Reference](/docs/reference/okteto-manifest.md): Okteto's Manifest for describing development environments
- [SSH Server](/docs/reference/ssh-server.md): Okteto runs an SSH server in your development container
- [Supported GitHub Actions](/docs/reference/supported-github-actions.md): Automate your development workflows using GitHub Actions and Okteto
- [Release notes](/docs/release-notes.md): Latest features, bug fixes, breaking changes, and improvements in each Okteto release, with Kubernetes compatibility details.
- [Okteto Self-Hosted](/docs/self-hosted.md): Introduction to Okteto Self-Hosted
- [Getting started after deploying Okteto on DigitalOcean](/docs/self-hosted/digitalocean/marketplace.md): Configure your Okteto instance after deploying from the DigitalOcean Marketplace. Set up DNS, authentication, and connect your Kubernetes cluster.
- [Helm Configuration](/docs/self-hosted/helm-configuration.md): List of configuration settings for Okteto
- [Authentication](/docs/self-hosted/install/auth.md): Configure your authentication provider
- [Use Azure AD as your Authentication Provider](/docs/self-hosted/install/auth/azure-ad.md): Use Azure AD as the authentication provider of your Okteto Self-hosted instance
- [Use Bitbucket as your Authentication Provider](/docs/self-hosted/install/auth/bitbucket.md): Use Bitbucket as the authentication provider of your Okteto Self-hosted instance
- [Use GitHub as your Authentication Provider](/docs/self-hosted/install/auth/github.md): Use GitHub as the authentication provider of your Okteto Self-hosted instance
- [Use Gitlab as your Authentication Provider](/docs/self-hosted/install/auth/gitlab.md): Use Gitlab as the authentication provider of your Okteto Self-hosted instance
- [Use Google as your Authentication Provider](/docs/self-hosted/install/auth/google.md): Use Google as the authentication provider of your Okteto Self-hosted instance
- [Use Okta as your Authentication Provider](/docs/self-hosted/install/auth/okta.md): Use Okta as the authentication provider of your Okteto Self-hosted instance
- [Use OpenID Connect (OIDC) as your Authentication Provider](/docs/self-hosted/install/auth/openid-connect.md): Use OpenID Connect (OIDC) as the authentication provider of your Okteto Self-hosted instance
- [Use Tokens as your Authentication Provider](/docs/self-hosted/install/auth/token.md): Use Tokens as the authentication provider of your Okteto Self-hosted instance
- [Configure the Okteto Wildcard Certificate](/docs/self-hosted/install/certificates.md): Configure your certificates with Okteto
- [Setting up certificates with AWS ACM](/docs/self-hosted/install/certificates/aws-acm.md): Setting up certificates with AWS ACM
- [Bring your own Wildcard Certificate](/docs/self-hosted/install/certificates/bring-your-own-certificate.md): Bring your own wildcard certificate
- [Setting up certificates with cert-manager and Let’s Encrypt](/docs/self-hosted/install/certificates/cert-manager.md): Configure TLS certificates for Okteto Self-Hosted using cert-manager and Let’s Encrypt.
- [Configure Divert](/docs/self-hosted/install/divert.md): Admin guide for configuring Divert drivers in self-hosted Okteto
- [Istio Installation for Divert](/docs/self-hosted/install/divert/istio-installation.md): Install Istio to use the Istio driver for Divert routing in Okteto
- [Linkerd Installation for Divert](/docs/self-hosted/install/divert/linkerd-installation.md): Install Linkerd to enhance Divert routing capabilities with the nginx driver
- [GitHub integration](/docs/self-hosted/install/github-integration.md): Use our GitHub Integration so your users can access private repositories in their development environments
- [Configure the Okteto Registry with external storage](/docs/self-hosted/install/okteto-registry-storage.md): Configure the Okteto Registry with external storage
- [Okteto Registry with Amazon S3 Bucket](/docs/self-hosted/install/okteto-registry-storage/aws-s3-bucket.md): Configure the Okteto Registry with Amazon S3 Bucket
- [Okteto Registry with Azure Storage Container](/docs/self-hosted/install/okteto-registry-storage/azure-storage-container.md): Configure the Okteto Registry with Azure Storage Container
- [Okteto Registry with DigitalOcean Spaces](/docs/self-hosted/install/okteto-registry-storage/digitalocean-spaces.md): Configure the Okteto Registry with DigitalOcean Spaces
- [Okteto Registry with Filesystem storage](/docs/self-hosted/install/okteto-registry-storage/filesystem.md): Configure the Okteto Registry with Filesystem storage
- [Okteto Registry with Google Cloud Storage](/docs/self-hosted/install/okteto-registry-storage/google-cloud-storage.md): Configure the Okteto Registry with Google Cloud Storage
- [Volume Snapshots for Self-Hosted Okteto](/docs/self-hosted/install/volume-snapshots.md): Install and configure a CSI driver and VolumeSnapshotClass to enable the Volume Snapshots feature on your Self-Hosted Okteto instance.
- [Air-Gapped Network EnvironmentsEnterpriseSelf-Hosted](/docs/self-hosted/manage/air-gapped.md): Installing Okteto in Air-Gapped Network Environments
- [Configure Argo CD](/docs/self-hosted/manage/argocd.md): How to Install Okteto in Argo CD
- [ARM Support](/docs/self-hosted/manage/arm-support.md): How to install and configure Okteto on ARM-based Kubernetes clusters
- [Backup and Restore](/docs/self-hosted/manage/backup.md): Backup and Restore your Okteto instance
- [Configuring BuildKit for High Performance](/docs/self-hosted/manage/buildkit-high-performance.md): Configuring BuildKit for High Performance
- [Custom Resource Definitions](/docs/self-hosted/manage/custom-resource-definitions.md): Custom resource definitions (CRDs) installed by Okteto
- [Diagnostics](/docs/self-hosted/manage/diagnostics.md): Okteto Diagnostics
- [Okteto License](/docs/self-hosted/manage/okteto-license.md): How to obtain and install your Okteto license key. For how billing works and how seats are counted, see the Billing page.
- [Troubleshoot your Okteto instance](/docs/self-hosted/manage/troubleshooting.md): Questions and answers to common issues when installing or upgrading your Okteto instance
- [Uninstalling Okteto](/docs/self-hosted/manage/uninstall-okteto.md): How to uninstall Okteto from your Kubernetes cluster
- [Upgrade your Okteto instance](/docs/self-hosted/manage/upgrade.md): How to upgrade your Okteto instance
- [Welcome to Okteto Test](/docs/testing.md): In this section, we'll see how you can use Test Containers on Okteto
- [Getting started with Okteto Test](/docs/testing/getting-started-test.md): In this section, we'll see how you configure Test Containers for your application
- [Okteto: the environment platform for agentic development](/docs/index.md): Okteto gives every AI agent task and developer an isolated, production-like environment on your own infrastructure to build, test, and verify against real services and data.