Enterprise Installation

OSO Kafka Backup Enterprise is distributed as a separate binary that is a drop-in replacement for the open-source version. It contains all OSS functionality plus enterprise features gated by a license file. Without a license, it operates identically to the OSS version.

14-day free trial

The enterprise binary includes a 14-day evaluation of shipped Enterprise features, activated explicitly or by the first operational command. No signup or card is required; help, version and licence inspection do not start it. After the trial, purchase a license to continue using enterprise features, or keep using it as your OSS binary.

Choose Your Edition

	Open Source	Enterprise
Homebrew	brew install osodevops/tap/kafka-backup	brew install osodevops/tap/kafka-backup-enterprise
Docker	osodevops/kafka-backup	osodevops/kafka-backup-enterprise
Homebrew command	kafka-backup	kafka-backup-enterprise
License required	No	Yes (trial included)
Source	GitHub (public)	GitHub (private)

Release archives and the Docker entrypoint use kafka-backup. Homebrew installs the Enterprise command as kafka-backup-enterprise, alongside the OSS command.

---

Homebrew (macOS / Linux)

The enterprise formula is published to the same Homebrew tap as the OSS version:

# Install enterprise edition
brew install osodevops/tap/kafka-backup-enterprise

# Verify
kafka-backup-enterprise --version
kafka-backup-enterprise license info

Command names

Homebrew uses kafka-backup-enterprise. If you run the unpacked binary directly, use ./kafka-backup. The examples below install it as kafka-backup-enterprise.

Docker

The Enterprise container image is published to Docker Hub for Linux amd64. On ARM hosts, use --platform linux/amd64 for emulation, or install the native ARM Linux/macOS binary instead:

# Pull the authorization recovery release
docker pull osodevops/kafka-backup-enterprise:v0.8.0

# Verify
docker run --rm osodevops/kafka-backup-enterprise:v0.8.0 --version
docker run --rm osodevops/kafka-backup-enterprise:v0.8.0 license info

Available Tags

Tag	Description
latest	Most recent stable release
v0.8.0	Authorization recovery release
v0.8	Latest patch within this minor version

With a License File

Mount your license file into the container:

docker run --rm \
  -v /path/to/license.key:/etc/kafka-backup/license.key:ro \
  -v $(pwd)/backup.yaml:/config/backup.yaml:ro \
  osodevops/kafka-backup-enterprise:v0.8.0 \
  backup --config /config/backup.yaml

Or pass the license as an environment variable:

docker run --rm \
  -e ENTERPRISE_LICENSE_KEY=$(base64 < license.key) \
  -v $(pwd)/backup.yaml:/config/backup.yaml:ro \
  osodevops/kafka-backup-enterprise:v0.8.0 \
  backup --config /config/backup.yaml

Docker Compose

docker-compose.yml

services:
  kafka-backup:
    image: osodevops/kafka-backup-enterprise:v0.8.0
    volumes:
      - ./config:/config:ro
      - ./backups:/data/backups
      - ./license.key:/etc/kafka-backup/license.key:ro
    command: ["backup", "--config", "/config/backup.yaml"]

Binary Download

Linux standalone archives require glibc 2.39+, for example Ubuntu 24.04. Use the Docker image on hosts with an older glibc.

Download pre-built binaries from GitHub Releases.

Linux (x86_64)

# Download Enterprise 0.8.0
curl -fL -o kafka-backup-x86_64-linux.tar.gz \
  https://github.com/osodevops/kafka-backup-enterprise-releases/releases/download/v0.8.0/kafka-backup-x86_64-linux.tar.gz

# Verify checksum
curl -fL -o kafka-backup-x86_64-linux.tar.gz.sha256 \
  https://github.com/osodevops/kafka-backup-enterprise-releases/releases/download/v0.8.0/kafka-backup-x86_64-linux.tar.gz.sha256
sha256sum -c kafka-backup-x86_64-linux.tar.gz.sha256

# Extract and install
tar xzf kafka-backup-x86_64-linux.tar.gz
sudo mv kafka-backup /usr/local/bin/kafka-backup-enterprise

# Verify
kafka-backup-enterprise --version
kafka-backup-enterprise license info

Linux (ARM64)

curl -L -o kafka-backup.tar.gz \
  https://github.com/osodevops/kafka-backup-enterprise-releases/releases/download/v0.8.0/kafka-backup-aarch64-linux.tar.gz

tar xzf kafka-backup.tar.gz
sudo mv kafka-backup /usr/local/bin/kafka-backup-enterprise

macOS (Intel)

curl -L -o kafka-backup.tar.gz \
  https://github.com/osodevops/kafka-backup-enterprise-releases/releases/download/v0.8.0/kafka-backup-x86_64-macos.tar.gz

tar xzf kafka-backup.tar.gz
sudo mv kafka-backup /usr/local/bin/kafka-backup-enterprise

macOS (Apple Silicon)

curl -L -o kafka-backup.tar.gz \
  https://github.com/osodevops/kafka-backup-enterprise-releases/releases/download/v0.8.0/kafka-backup-aarch64-macos.tar.gz

tar xzf kafka-backup.tar.gz
sudo mv kafka-backup /usr/local/bin/kafka-backup-enterprise

Windows (x86_64)

Download kafka-backup-x86_64-windows.zip from the releases page and extract kafka-backup.exe to a directory in your PATH.

Kubernetes (Helm Chart)

The recommended way to deploy on Kubernetes is the official Helm chart, which creates a CronJob for scheduled backups with built-in license injection, credential management, and Prometheus metrics.

helm repo add oso-devops https://osodevops.github.io/helm-charts/
helm repo update
helm install kafka-backup oso-devops/kafka-backup-enterprise \
  --version 0.8.0 \
  --namespace kafka-backup --create-namespace \
  --values values.yaml

Chart 0.8.0 installs application 0.8.0. Use the public Helm repository above; OCI package access may require authentication. For evaluations, enable trialPersistence.enabled and retain the same claim across restarts.

See the Helm Chart guide for complete installation instructions, configuration examples, cloud IAM setup, and troubleshooting.

Manual Kubernetes (without Helm)

If you prefer raw manifests, swap the image reference and mount the license as a Secret:

license-secret.yaml

apiVersion: v1
kind: Secret
metadata:
  name: kafka-backup-license
  namespace: kafka-backup
type: Opaque
stringData:
  license.key: |
    -----BEGIN KAFKA-BACKUP LICENSE-----
    eyJsaWNlbnNlX2lkIjoiYWJjZGVm...
    -----END KAFKA-BACKUP LICENSE-----

spec:
  containers:
    - name: kafka-backup
      image: osodevops/kafka-backup-enterprise:v0.8.0
      volumeMounts:
        - name: license
          mountPath: /etc/kafka-backup
          readOnly: true
  volumes:
    - name: license
      secret:
        secretName: kafka-backup-license

For full Kubernetes deployment examples, see the Kubernetes Deployment guide.

Verifying Your Installation

After installing the enterprise binary, verify it is working:

# Check version
kafka-backup-enterprise --version

# Check license status
kafka-backup-enterprise license info

On first run without a license, the output will show the auto-trial:

  License:  14-day trial (auto-activated)
  Expires:  2026-04-24 (14 days remaining)
  Features: schema_registry, rbac, encryption, masking, audit, wasm
  Status:   Valid

Upgrading from OSS

The enterprise binary is a drop-in replacement. To upgrade:

1. Replace the binary — install the enterprise edition using any method above
2. Your existing config works as-is — all OSS configuration is fully compatible
3. Add enterprise features — optionally add an enterprise: section to your config YAML
4. Apply a license — when you're ready, obtain and apply a license

No data migration is needed. Your existing backups remain fully compatible.

Get a License

After your 14-day trial, purchase a license to continue using enterprise features:

• Buy online: enterprise.kafkabackup.com
• Contact sales: sales@oso.sh

See Licensing for details on license tiers, activation, and management.

Next Steps

1. Apply a license (or use the 14-day trial)
2. Configure Schema Registry backup
3. Configure Confluent RBAC backup
4. Review the full enterprise feature set