kompose/docs/installation.md
2017-10-10 15:24:44 -04:00

88 lines
2.3 KiB
Markdown

# Installation
We have multiple ways to install Kompose. Our prefered 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](https://github.com/kubernetes/kompose/releases).
__Linux and macOS:__
```sh
# Linux
curl -L https://github.com/kubernetes/kompose/releases/download/v1.3.0/kompose-linux-amd64 -o kompose
# macOS
curl -L https://github.com/kubernetes/kompose/releases/download/v1.3.0/kompose-darwin-amd64 -o kompose
chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose
```
__Windows:__
Download from [GitHub](https://github.com/kubernetes/kompose/releases/download/v1.3.0/kompose-windows-amd64.exe) and add the binary to your PATH.
#### Nightly / master release
"Nightly" binaries are generated on a per-merge basis and uploaded to [Bintray](https://bintray.com/kompose)
__Linux and macOS:__
```sh
# Linux
curl -L https://dl.bintray.com/kompose/kompose/latest/kompose-linux-amd64 -o kompose
# macOS
curl -L https://dl.bintray.com/kompose/kompose/latest/kompose-darwin-amd64 -o kompose
chmod +x kompose
sudo mv ./kompose /usr/local/bin/kompose
```
__Windows:__
Download from [Bintray](https://dl.bintray.com/kompose/kompose/latest/kompose-windows-amd64.exe) and add the binary to your PATH.
#### Go
Installing using `go get` pulls from the master branch with the latest development changes.
```sh
go get -u github.com/kubernetes/kompose
```
#### CentOS
Kompose is in [EPEL](https://fedoraproject.org/wiki/EPEL) CentOS repository.
If you don't have [EPEL](https://fedoraproject.org/wiki/EPEL) repository already installed and enabled you can do it by running `sudo yum install epel-release`
If you have [EPEL](https://fedoraproject.org/wiki/EPEL) enabled in your system, you can install Kompose like any other package.
```bash
sudo yum -y install kompose
```
#### Fedora
Kompose is in Fedora 24, 25 and 26 repositories. You can install it just like any other package.
```bash
sudo dnf -y install kompose
```
#### macOS
On macOS you can install latest release via [Homebrew](https://brew.sh):
```bash
brew install kompose
```
#### Windows
Kompose can be installed via [Chocolatey](https://chocolatey.org/packages/kubernetes-kompose)
```console
choco install kubernetes-kompose
```