Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
Jan 16, 2023
Dec 6, 2022
May 2, 2018
Dec 3, 2022

Kapitan: advanced configuration management tool

Unit Tests Python Version Downloads Docker Pulls Docker 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

Official site

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.


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
  • Mac: brew install python3 libyaml

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

Related projects

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