Skip to content

Getting Started with Capsailer

This guide will help you get started with Capsailer for air-gapped Kubernetes deployments.

Prerequisites

  • Kubernetes cluster (for deployment)
  • Admin access to the cluster

Installation

Download Prse-built Binary

You can download pre-built binaries for your platform:

Linux (amd64)

curl -Lo capsailer.tar.gz https://github.com/capsailer/capsailer-cli/releases/latest/download/capsailer-linux-amd64.tar.gz
tar -xzf capsailer.tar.gz
chmod +x capsailer

macOS (Intel)

curl -Lo capsailer.tar.gz https://github.com/capsailer/capsailer-cli/releases/latest/download/capsailer-darwin-amd64.tar.gz
tar -xzf capsailer.tar.gz
chmod +x capsailer

macOS (Apple Silicon)

curl -Lo capsailer.tar.gz https://github.com/capsailer/capsailer-cli/releases/latest/download/capsailer-darwin-arm64.tar.gz
tar -xzf capsailer.tar.gz
chmod +x capsailer

Windows

Download from https://github.com/capsailer/capsailer-cli/releases/latest

Move to PATH

sudo mv capsailer /usr/local/bin/

You can find all available releases at: https://github.com/capsailer/capsailer-cli/releases

Quick Start

1. Create a Manifest

Create a manifest file that describes the images and charts you want to include:

images:
  - nginx:1.25
  - redis:7.0

charts:
  - name: redis
    repo: https://charts.bitnami.com/bitnami
    version: 17.11.7

2. Build a Bundle

capsailer init --manifest manifest.yaml
capsailer build --manifest manifest.yaml --output capsailer-bundle.tar.gz

3. Deploy in an Air-Gapped Environment

# Deploy a registry
capsailer registry --namespace my-registry

# Push all images from the bundle to the registry
capsailer push --bundle capsailer-bundle.tar.gz --namespace my-registry

Next Steps