Kapitan: advanced configuration management tool

<img src="docs/images/kapitan_logo.png" width="25">

Kapitan aims to be your one-stop tool to help you manage the ever growing complexity of your configurations.

Join the community #kapitan

Official site https://kapitan.dev

Quick Start

Install Kapitan

Docker (recommended)

docker run -t --rm -v $(pwd):/src:delegated kapicorp/kapitan -h

On Linux you can add -u $(id -u) to docker run to preserve file permissions.

Pip

Kapitan needs Python 3.10 or newer.

Install Python 3

• Linux: sudo apt-get update && sudo apt-get install -y python3-dev python3-pip python3-yaml git
• Mac: brew install python3 libyaml git

Install Kapitan

User ($HOME/.local/lib/python3.x/bin on Linux or $HOME/Library/Python/3.x/bin on macOS):

pip3 install --user --upgrade kapitan

System-wide (not recommended):

sudo pip3 install --upgrade kapitan

Build Kapitan

Docker

To build a docker image for the architecture of your machine, run docker build . -t you-kapitan-image, and to build for a specific platform, add --platform linux/arm64.

To build a multi-platform image (as the CI does), follow the docker multi-platform documentation.

To build a docker image using a specific python version, run docker build --build-arg PYTHON_BUILDER_VERSION=<python-version> . -t you-kapitan-image. By default the Dockerfile is pinned using python 3.11 as the python builder version.

Related projects

• Tesoro - Kubernetes Admission Controller for Kapitan Secrets
• Kapitan Reference - our reference repository to get started with Kapitan