Kompose

Kompose is a translation tool for your software.

  • Infrastructure
  • Tools & Utilities
Kompose is a translation tool for your software. It takes applications designed for simple home servers (Docker Compose) and automatically adapts them to run on more powerful, enterprise-grade systems like Kubernetes. It saves time by reorganising your existing setups to work in complex new environments.

Platform availability

Available on 0 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

66/100 Good

Maintained
75last commit 52 days ago
Popular
8110,650 GitHub stars
Easy to install
250 install platforms, install notes, Docker image
Light to run
No data
Security check
71no serious findings, 3 minor, CI, tests, OpenSSF Scorecard 5.4/10

Based on 4 of 5 factors.

GitHub stars
10,650
Open issues
19
Last commit
2026-09-30
Latest release
v1.38.0
License
Apache-2.0
Activity
stale

Checked 2 days ago - source: GitHub (kubernetes/kompose)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install Kompose first On Windows, run winget install Kubernetes.kompose in PowerShell. On Linux or macOS with Go installed, run go install github.com/kubernetes/kompose@latest. Without this step, your terminal has no kompose command, so converting a Docker Compose file will fail. source
  • Put the Go-installed Kompose on your PATH If you installed with Go and the terminal still says kompose is not found, add the folder Go uses for installed programs to your PATH. PATH is the list of folders your computer checks to find commands. source
  • Download a sample Compose file If you don't have a Docker Compose file yet, download one with wget https://raw.githubusercontent.com/kubernetes/kompose/main/examples/compose.yaml. Kompose needs a compose file as the thing it converts, so without one it has nothing to process. source

Fetched 53 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Why might kompose convert fail on a Compose file that works locally?

Environment variable interpolation in the Compose file can cause the first conversion attempt to fail.

I installed Kompose with Go, but my terminal says the command is not found. What should I do?

Add the folder where Go installs programs to your PATH. If that is not set, the terminal cannot find the kompose command.

How can I add Kubernetes-specific changes when using Kompose?

Use Kompose-specific labels in the compose.yaml file. The full list of conversion options is shown by kompose convert --help.

Can I run Kompose from Docker or Podman?

You can build an image from the official repository for Docker or Podman and run the built image against your current directory.

Which shell autocompletion does Kompose support?

Kompose supports Bash, Zsh, and Fish autocompletion.

Answers sourced from github.com, github.com, kompose.io, kompose.io, www.reddit.com

Community

Collected 48 days ago - public community threads