Air-Gapped Network EnvironmentsEnterpriseSelf-Hosted
Okteto Enterprise can be installed in air-gapped environments—isolated networks without internet access. This guide explains how to install, configure and use a self-hosted Okteto instance entirely offline. For personalized assistance, feel free to talk to us to guide you during the installation.
Step 1: Disabling Okteto Telemetry
By default, Okteto sends telemetry data to help us understand usage patterns and prioritize improvements. In an air-gapped environment, disable telemetry by adding the following to your Okteto Helm configuration:
telemetry:
enabled: false
With telemetry disabled, the Okteto CLI doesn't send any usage analytics.
Step 2: Setting Up a Private Registry for Required Images
By default, the images that deploy the Okteto Platform, and the images that the Okteto CLI uses, are hosted in GitHub Container Registry (ghcr.io).
In an air-gapped environment, you host these images in your private registry.
Pushing Images to your Private Registry
For simplicity, we recommend keeping the same repository names and tags in your private registry.
Okteto doesn't support imagePullSecrets, so configure your Kubernetes cluster to access your private registry beforehand.
Required Images for Okteto Platform Installation
Push the following images to your private registry for the Okteto Chart installation:
- ghcr.io/okteto/backend:1.47.0
- ghcr.io/okteto/frontend:1.47.0
- ghcr.io/okteto/buildkit:1.47.0 or ghcr.io/okteto/buildkit:1.47.0-rootless
- ghcr.io/okteto/registry:1.47.0
- ghcr.io/okteto/pipeline-runner:1.47.0 or ghcr.io/okteto/pipeline-runner:1.47.0-rootless
- ghcr.io/okteto/daemon:1.47.0
- ghcr.io/okteto/agent:1.47.0
- ghcr.io/okteto/ingress-nginx-chroot:1.47.0
- ghcr.io/okteto/reloader:1.47.0
- ghcr.io/okteto/redis:1.47.0
For each Okteto CLI version, push the following images to your private registry:
- ghcr.io/okteto/okteto:3.22.0
For Okteto Chart 1.47.0, we recommend requiring Okteto CLI 3.22.0 on your developers' machines to reduce maintenance overhead.
Step 3: Updating the Helm Configuration
Once your images are in your private registry, update your Okteto Helm configuration so Okteto pulls the required images from it during deployment.
Replace <<your-registry-url>> with the hostname or IP address of your private registry, for example my-registry.example.com:5000. It must be accessible within your air-gapped environment and use the correct protocol (https) and port.
globals:
registry: <<your-registry-url>>
cli:
image:
registry: <<your-registry-url>>
ingress-nginx:
controller:
image:
registry: <<your-registry-url>>
okteto-nginx:
controller:
image:
registry: <<your-registry-url>>
reloader:
global:
imageRegistry: <<your-registry-url>>
Step 4: Installing or Upgrading Okteto
Run the following command to install Okteto for the first time, or to upgrade an existing instance:
helm upgrade --install okteto okteto/okteto -f config.yaml --namespace=okteto --create-namespace --version=1.47.0
Step 5: Installing the Okteto CLI
Install the Okteto CLI on your machine and on the machine of every developer on your team who uses Okteto.
Downloading the Okteto CLI
Download the binary of the Okteto CLI for your operating system from the Okteto CLI 3.22.0 release, the version that matches your Okteto instance.
- On Linux and macOS, the binary is named
okteto - On Windows, the binary is named
okteto.exe
Setting Up the Okteto Configuration Directory
Create a .okteto folder in your $HOME directory. The CLI stores its runtime configuration and dependencies there.
mkdir -p $HOME/.okteto
Downloading and Configuring Syncthing
Okteto uses Syncthing to synchronize files between your local machine and your remote Development Environments. Download the Syncthing binary from its official releases page:
https://github.com/syncthing/syncthing/releases/tag/v2.1.1
- Uncompress the downloaded file
- Move the
syncthingbinary (syncthing.exeon Windows) to your$HOME/.oktetofolder
Setting Executable Permissions (Linux and macOS only)
On Linux and macOS, give executable permissions to both okteto and syncthing:
chmod +x okteto
chmod +x $HOME/.okteto/syncthing
Installation Support
Contact us if you need help with your installation.
Browser Compatibility
The Okteto Dashboard is supported on:
- Google Chrome: Last 8 versions
- Mozilla Firefox: Last 8 versions
- Microsoft Edge: Last 8 versions
- Safari: Last 2 major versions (macOS only)
Make sure every user in your air-gapped environment has access to one of these browsers to avoid compatibility issues.