Skip to content

Generic templated configuration management for Kubernetes, Terraform and other things


Notifications You must be signed in to change notification settings


Repository files navigation

Kapitan: advanced configuration management tool

Test, Build and Publish docker image Python Version Downloads Docker Pulls Releases Docker Image Size

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

Join the community #kapitan

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.


Kapitan needs Python 3.7.

Install Python 3.7

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

Install Kapitan

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

pip3 install --user --upgrade kapitan

System-wide (not recommended):

sudo pip3 install --upgrade kapitan

Build Kapitan


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.

Related projects

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