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 k2s.dekube.io/get -o k2s

$ chmod +x k2s && ./k2s

$ docker compose up -d

Python 3.10+ and Docker required. That's all.

What happened? The script looked at your project, figured out what it is, downloaded what it needed, and produced a working compose.yml. Everything it installed lives in .kubernetes2simple/ — your system stays clean.

Questions

Can I run it again?

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

What about TLS?

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

What doesn't convert?

CronJobs, resource limits, probes, HPA — anything without a compose equivalent is skipped with a warning. The goal is a working local environment, not a cluster replica.

My project uses Helmfile environments

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

It didn't work

Open an issue. Describe what you pointed it at, paste the output.

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.

How does it work?

The script downloads the conversion engine and the extensions your project needs, runs helmfile template (or reads your manifests), and converts everything to a compose.yml + reverse proxy config. The conversion is static — no agent, no daemon, no controller. Run it again any time to regenerate.

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.