Kompose - Installation


We have multiple ways to install Kompose. Our preferred method is downloading the binary from the latest GitHub release.

GitHub release

Kompose is released via GitHub on a three-week cycle, you can see all current releases on the GitHub release page.

Linux and macOS:

# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.26.1/kompose-linux-amd64 -o kompose

# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.26.1/kompose-darwin-amd64 -o kompose

chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose


Download from GitHub and add the binary to your PATH.


Installing using go get pulls from the master branch with the latest development changes.

go get -u github.com/kubernetes/kompose


Kompose is in EPEL CentOS repository. If you don’t have EPEL repository already installed and enabled you can do it by running sudo yum install epel-release

If you have EPEL enabled in your system, you can install Kompose like any other package.

sudo yum -y install kompose


Kompose is in Fedora 24, 25 and 26 repositories. You can install it just like any other package.

sudo dnf -y install kompose


A deb package is released for compose. Download latest package in the assets in github releases.

wget https://github.com/kubernetes/kompose/releases/download/v1.26.1/kompose_1.26.1_amd64.deb # Replace 1.26.1 with latest tag
sudo apt install ./kompose_1.26.1_amd64.deb


On macOS you can install latest release via Homebrew or MacPorts.

# Homebrew
brew install kompose

# MacPorts
port install kompose


Kompose can be installed via Chocolatey

choco install kubernetes-kompose


Kompose is available in the official Virtualization:containers repository for openSUSE Tumbleweed, Leap 15, Leap 42.3 and SUSE Linux Enterprise 15.

Head over to software.opensuse.org for One-Click Installation or add the repository manually:

#openSUSE Tumbleweed
sudo zypper addrepo https://download.opensuse.org/repositories/Virtualization:containers/openSUSE_Tumbleweed/Virtualization:containers.repo

#openSUSE Leap 42.3
sudo zypper addrepo https://download.opensuse.org/repositories/Virtualization:containers/openSUSE_Leap_42.3/Virtualization:containers.repo

#openSUSE Leap 15
sudo zypper addrepo https://download.opensuse.org/repositories/Virtualization:/containers/openSUSE_Leap_15.2/Virtualization:containers.repo

#SUSE Linux Enterprise 15
sudo zypper addrepo https://download.opensuse.org/repositories/Virtualization:/containers/SLE_15_SP1/Virtualization:containers.repo

and install the package:

sudo zypper refresh
sudo zypper install kompose


To install from Nixpkgs, use nix-env.

nix-env --install -A nixpkgs.kompose

To run kompose without installing it, use nix-shell.

nix-shell -p kompose --run "kompose convert"


You can build an image from the offical repo for Docker or Podman:

docker build -t kompose https://github.com/kubernetes/kompose.git

To run the built image against the current directory, run the following command:

docker run --rm -it -v $PWD:/opt kompose sh -c "cd /opt && kompose convert"