You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Mudit Verma 7f4be2a34d network int test fix (#1197) 6 days ago
build 1.19.0 Release (#1174) 1 month ago
cmd Merge pull request #1147 from hangyan/push-image-flag 1 month ago
docs Add support for file based secret (#1159) 1 week ago
examples Revert "Add node references (#1123)" 5 months ago
pkg fix tests related to secrets (#1198) 6 days ago
script network int test fix (#1197) 6 days ago
vendor Add support for file based secret (#1159) 1 week ago
.gitignore Add kompose.image-pull-secret and kompose.image-pull-policy (#1091) 10 months ago
.gitmodules submodule with a 'go get'-friendly url 6 months ago
.mention-bot Change bot message 2 years ago
.travis.yml Bump Go versions (#1073) 1 year ago 1.19.0 Release (#1174) 1 month ago Go down to one ACK 2 years ago
Dockerfile Add Dockerfile (#1101) 4 months ago
Jenkinsfile changing the organisation from kubernetes-incubator to kubernetes 2 years ago
LICENSE Set template k8s project 3 years ago
Makefile Statically build binaries via make cross (#1193) 1 week ago
OWNERS Update OWNERS (#1177) 1 month ago 1.19.0 Release (#1174) 1 month ago update release process doc 2 years ago
SECURITY_CONTACTS Update embargo doc link in SECURITY_OWNERS and changes PST to PSC (#1115) 9 months ago Update 1 year ago
glide.lock Update dep for compose 3.5+ (#1120) 8 months ago
glide.yaml Add support for file based secret (#1159) 1 week ago
main.go kubernetes-incubator -> kubernetes 2 years ago

Kompose (Kubernetes + Compose)

Build Status Widget Coverage Status Widget GoDoc Widget GoReportCard Widget

kompose is a tool to help users who are familiar with docker-compose move to Kubernetes. kompose takes a Docker Compose file and translates it into Kubernetes resources.

kompose is a convenience tool to go from local Docker development to managing your application with Kubernetes. Transformation of the Docker Compose format to Kubernetes resources manifest may not be exact, but it helps tremendously when first deploying an application on Kubernetes.

Use Case

Convert docker-compose.yaml into Kubernetes deployments and services with one simple command:

$ kompose convert -f docker-compose.yaml
INFO Kubernetes file "frontend-service.yaml" created         
INFO Kubernetes file "redis-master-service.yaml" created     
INFO Kubernetes file "redis-slave-service.yaml" created      
INFO Kubernetes file "frontend-deployment.yaml" created      
INFO Kubernetes file "redis-master-deployment.yaml" created  
INFO Kubernetes file "redis-slave-deployment.yaml" created 

Other examples are provided in the examples directory.


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

Our entire list of installation methods are located in our document.

Installation methods:

Binary installation

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 -o kompose

# macOS
curl -L -o kompose

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


Download from GitHub and add the binary to your PATH.

Shell autocompletion

We support both Bash and Zsh autocompletion.

# Bash (add to .bashrc for persistence)
source <(kompose completion bash)

# Zsh (add to .zshrc for persistence)
source <(kompose completion zsh)

Development and building of Kompose

Building with go


  1. make
  2. Golang v1.6 or later
  3. Set GOPATH correctly or click SettingGOPATH for details


  1. Clone repository console $ git clone $GOPATH/src/ 2. Build with make console $ make bin
  2. Or build with go console $ go build -o kompose main.go 4. Test your changes console $ make test


Documentation can be found at our website or our docs folder.

Here is a list of all available docs:

Community, Discussion, Contribution, and Support

Issues: If you find any issues, please file it.

Kubernetes Community: As part of the Kubernetes ecosystem, we follow the Kubernetes community principles. More information can be found on the community page.

Chat (Slack): We’re fairly active on Slack and you can find us in the #kompose channel.

Code of Conduct

Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.