k2s.dekube.io—Kubernetes made too simple by removing Kubernetes

kubernetes2simple

Kubernetes to Docker Compose. One command. Too simple.

# in your project directory
$ curl -fsSL k2s.dekube.io/get | bash
$ docker compose up -d
# download, inspect, then run
$ curl -fsSL -o k2s.sh \
raw.githubusercontent.com/dekubeio/kubernetes2simple/main/kubernetes2simple.sh
$ chmod +x k2s.sh && ./k2s.sh
$ docker compose up -d

Python 3.10+ and Docker required. On Windows, use WSL. That's all.

What happened? The script looked at your project, figured out what it is (helmfile, Helm chart, or raw manifests), downloaded what it needed, and produced a working compose.yml + Caddyfile. Everything it installed lives in .kubernetes2simple/ — your system stays clean. Re-run it any time to regenerate.

Guides

How to convert Kubernetes manifests to Docker Compose How to convert a Helm chart to Docker Compose Local Kubernetes development with Docker Compose

Questions

Can I run it again?

Yes, any time. compose.yml and Caddyfile are regenerated on every run. To customize something, edit dekube.yaml instead — that file is yours.

What about TLS?

If your project uses HTTPS, self-signed certificates are generated locally so things can start. Fine for development — not for production.

What doesn't convert?

Anything without a Compose equivalent is skipped with a warning. The goal is a working local environment, not a perfect replica of what runs in production.

My project uses Helmfile environments

Pass --env <name> to select one. Pick the environment closest to dev or demo.

It didn't work

Check the troubleshooting guide first. Still stuck? Open an issue — describe what you pointed it at and paste the output.

I want more control

helmfile2compose is the distribution for maintainers — choose your extensions, control the pipeline, embed it in your CI. It comes with warnings.

Is this K2s?

No. K2s (uppercase K) is a Kubernetes distribution for Windows by Siemens Healthineers. k2s (lowercase) is this project. Different thing, similar name, no affiliation.

What is dekube?

dekube is the conversion engine behind this script — an extension system, a package manager, and documentation written as forbidden texts for a forbidden act. kubernetes2simple detects your project, picks the right extensions, and runs dekube for you. One command instead of understanding the architecture.