Kubespray Air-Gap Deployment with kubespray-offline

Overview

Air-gapped environments have no internet access. The kubespray-offline tool automates staging all binaries and container images required for a fully offline Kubernetes deployment.

Core principle: kubespray-offline downloads everything on an internet-connected machine, produces a self-contained outputs/ directory, then deploys entirely offline on the target network. No internet is needed after the transfer.

When to Use

• Deploying Kubernetes to networks with no internet access
• Using the kubespray-offline tool for offline deployment
• Setting up private container registries for Kubernetes
• Configuring containerd to use internal registry mirrors
• Troubleshooting image pull issues in air-gapped environments

Not for: Online deployments (use kubespray-deployment), general troubleshooting (use kubespray-troubleshooting).

kubespray-offline Tool Workflow