# Install kompose with Homebrew, apk, MacPorts, Nix, pacman, zypper, scoop, winget

Tool to move from docker-compose to Kubernetes. Version 1.38.0 via Homebrew; verified 2026-07-27. Also installable with nix: nix profile install nixpkgs#kompose.

## Install

```sh
sudo av install brew:kompose
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install kompose
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install kompose
```

  Evidence: MacPorts ports tree: devel/kompose/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add kompose
```

  Evidence: Alpine Linux edge package indexes: kompose from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#kompose
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ko/kompose/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S kompose
```

  Evidence: Arch Linux sync databases: kompose from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install kompose
```

  Evidence: openSUSE Tumbleweed package metadata: kompose from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

### Windows

- Scoop (92%):

```sh
scoop install main/kompose
```

  Evidence: Scoop official bucket manifest trees: bucket/kompose.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id Kubernetes.kompose -e
```

  Evidence: Windows Package Manager source index: Kubernetes.kompose from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:kompose
- **Package manager:** Homebrew
- **Version:** 1.38.0
- **Source summary:** Tool to move from docker-compose to Kubernetes
- **Homepage:** <https://kompose.io/>
- **Repository:** <https://github.com/kubernetes/kompose>
- **Last updated:** 2026-07-27T21:58:40+02:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- kompose (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.38.0
## Project history and usage

Kompose, short for Kubernetes plus Compose, is a migration utility that translates Compose Specification files into Kubernetes resources. It sits at the boundary between the Docker Compose developer workflow and Kubernetes manifests, helping users get a first Kubernetes deployment without manually rewriting every service, volume, and network concept.

### Project history

The repository was created on 2016-06-27, during the period when Kubernetes adoption was expanding beyond early cluster operators. The first alpha release, v0.0.1-alpha, was published on 2016-07-01. The v1.0.0 release on 2017-07-20 announced graduation from Kubernetes Incubator and a move to the `kubernetes/kompose` repository.

Kompose's README defines the core contract: take a Compose file and translate it into Kubernetes resources. The project documentation is hosted at kompose.io and in the repository's docs tree, with user-guide material for conversion, labels, commands, and operational workflows.

### Adoption history

Kompose became a standard package-manager-visible bridge for teams moving from local Compose applications toward Kubernetes. Its Homebrew formula and binary releases made it easy to add to developer laptops, while Kubernetes ownership gave it a clear place inside the broader container tooling ecosystem.

### How it is used

The common workflow is `kompose convert -f compose.yaml`, which emits Kubernetes YAML such as Deployments and Services. The project warns that conversion from Compose to Kubernetes may not be exact, framing Kompose as a convenience and migration aid rather than a perfect semantic compiler.

### Why package nerds care

For package nerds, Kompose is interesting because it packages a cross-orchestrator translation problem into one CLI. It also records the history of container tooling convergence: Compose was the local-development lingua franca, while Kubernetes became the deployment API that package managers needed to put on workstations.

### Timeline

- 2016-06-27: GitHub repository created.
- 2016-07-01: v0.0.1-alpha published.
- 2017-07-20: v1.0.0 published and Kubernetes Incubator graduation announced.

### Related projects

- Kompose is directly related to Docker Compose, the Compose Specification, Kubernetes, kubectl, and the historical Kubernetes Incubator organization.

### Sources

- <https://api.github.com/repos/kubernetes/kompose>
- <https://github.com/kubernetes/kompose>
- <https://github.com/kubernetes/kompose/releases/tag/v0.0.1-alpha>
- <https://github.com/kubernetes/kompose/releases/tag/v1.0.0>
- <https://kompose.io/user-guide/>
- <https://raw.githubusercontent.com/kubernetes/kompose/main/README.md>


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal

## Other Package-Manager Records

- Nix - kompose: normalized package name match | nixpkgs package indexes: pkgs/by-name/ko/kompose/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - kompose - 1.31.2-r21: normalized package name match | Alpine Linux edge package indexes: kompose from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Tool to move from docker-compose to Kubernetes | https://kompose.io/
- apk - kompose-bash-completion - 1.31.2-r21: normalized package name match | Alpine Linux edge package indexes: kompose-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Bash completions for kompose | https://kompose.io/
- apk - kompose-fish-completion - 1.31.2-r21: normalized package name match | Alpine Linux edge package indexes: kompose-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Fish completions for kompose | https://kompose.io/
- apk - kompose-zsh-completion - 1.31.2-r21: normalized package name match | Alpine Linux edge package indexes: kompose-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Zsh completions for kompose | https://kompose.io/
- pacman - kompose - 1.38.0-1: normalized package name match | Arch Linux sync databases: kompose from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Docker compose to Kubernetes transformation tool | https://github.com/kubernetes/kompose
- zypper - kompose - 1.38.0-1.7: normalized package name match | openSUSE Tumbleweed package metadata: kompose from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Go from Docker Compose to Kubernetes | https://kompose.io
- zypper - kompose-bash-completion - 1.38.0-1.7: normalized package name match | openSUSE Tumbleweed package metadata: kompose-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Bash Completion for kompose | https://kompose.io
- zypper - kompose-fish-completion - 1.38.0-1.7: normalized package name match | openSUSE Tumbleweed package metadata: kompose-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Fish Completion for kompose | https://kompose.io
- zypper - kompose-zsh-completion - 1.38.0-1.7: normalized package name match | openSUSE Tumbleweed package metadata: kompose-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Zsh Completion for kompose | https://kompose.io
- MacPorts - kompose: normalized package name match | MacPorts ports tree: devel/kompose/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - main/kompose: normalized package name match | Scoop official bucket manifest trees: bucket/kompose.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - Kubernetes.kompose: normalized package name match | Windows Package Manager source index: Kubernetes.kompose from https://cdn.winget.microsoft.com/cache/source.msix


## Combined YAML source

View the package source record on GitHub. [combined/kompose.yml](https://github.com/mxcl/pkgdb/blob/main/combined/kompose.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
