Skip to content

Install kubesplit

Kubesplit is published on pypi.org and as a Docker image. Pick the method that fits your workflow.

uv installs kubesplit as an isolated standalone tool:

uv tool install kubesplit
kubesplit --version

Run it once without installing:

uvx kubesplit --input all-in-one.yml --output out

With pip

pip3 install -U --user kubesplit
kubesplit --input all-in-one.yml --output out

With mise

mise can manage kubesplit (and pin its version) through its pipx backend, which relies on uv when available:

Sample mise.toml
[tools]
"pipx:kubesplit" = "0.5.0"
uv = "0.8.9"

Then:

mise install

With Docker

Use the published image when you don't want to install anything locally. Mount your working directory so kubesplit can read the input and write the output:

# Use latest
docker image pull looztra/kubesplit

# Split a file mounted from the current directory
docker container run -ti --rm \
  -v "$(pwd):/code" -w /code \
  looztra/kubesplit \
  --input all-in-one.yml \
  --output out

Read from STDIN instead of a file:

cat all-in-one.yml | docker container run -i --rm \
  -v "$(pwd):/code" -w /code \
  looztra/kubesplit \
  --output out

Available tags are listed on Docker Hub.

Next steps