Skip to content

Latest commit

 

History

History
125 lines (84 loc) · 3.59 KB

installation.md

File metadata and controls

125 lines (84 loc) · 3.59 KB
layout permalink title redirect_from
default
/installation/
Installation
/docs/installation.md/
/docs/installation/

Installation

  • TOC {:toc}

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

Windows:

Download from GitHub and add the binary to your PATH.

Go

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

go install github.com/kubernetes/kompose@latest

CentOS

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

Fedora

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

sudo dnf -y install kompose

Ubuntu/Debian

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

macOS

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

# Homebrew
brew install kompose

# MacPorts
port install kompose

Windows

Kompose can be installed via Chocolatey

choco install kubernetes-kompose

openSUSE/SLE

Kompose is available in the official repositories of openSUSE Tumbleweed and in openSUSE Leap starting with 15.2. On SUSE Linux Enterprise Server 15 SP2 - and following - you can install kompose from PackageHub. Please refer to the SUSE documentation on how to activate PackageHub on your SUSE Linux Enterprise distribution.

sudo zypper install kompose

NixOS

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"

Docker

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"