How do I convert a docker run command to docker-compose?

Paste the full docker run command above and run the tool. It parses ports, volumes, environment variables, networks, and restart policies into an equivalent docker-compose YAML service you can drop into your compose file.

Which docker run flags are supported?

The converter handles --name, -d, -it, -p/--publish, -v/--volume, -e/--env, --env-file, --restart, --network, --hostname, --workdir, --user, --entrypoint, --label, --expose, --privileged, --read-only, and --init. Unsupported flags are listed in the Notes output.

What happens to --rm in docker compose?

--rm has no compose equivalent because compose services are ephemeral by default — the flag is skipped and noted. If you need one-off commands in compose, use "docker compose run --rm".

Does the generated YAML work with docker compose v2?

Yes. The output uses the modern "services:" top-level format without a version key, which works with docker compose v2 (the "docker compose" CLI plugin).

Is my docker command uploaded anywhere?

No. Parsing and YAML generation happen entirely in your browser. Your command never leaves your device — safe even for commands containing internal image names.

Docker Run to Docker Compose Converter — Generate Compose YAML Online

What is Docker run to compose?

Docker Run to Compose Converter — Free docker run to docker compose converter — paste a docker run command and get an equivalent docker-compose YAML service. Handles ports, volumes, env vars. No signup.

The command is tokenized with a quote-aware splitter written for this tool, then parsed flag by flag into a service model (image, ports, volumes, environment, networks, restart policy, and more). A hand-written YAML emitter renders the compose service — no YAML library is used, so output formatting is fully controlled. Everything runs locally in your browser. Limitation: exotic flags (device mappings, sysctls, ulimits) are reported as warnings rather than converted; always review the YAML before deploying.

Why use this docker run to compose?

🎯

Built for docker run to compose

Free docker run to docker compose converter — paste a docker run command and get an equivalent docker-compose YAML service. Handles ports, volumes, env vars. No signup.

📋

Transparent & honest

Only common flags are converted; exotic flags are skipped with a warning in the Notes output.

🔒

Private by design

Everything runs in your browser. Your inputs never leave your device.

📱

Works everywhere

Fully responsive — perfect on desktop, tablet, and mobile. No app needed.

🔄

Regularly updated

Regularly maintained and reviewed to ensure accuracy.

💡

Free forever

No accounts, no limits, no watermarks. Use Docker Run to Compose Converter as much as you need.

How to use Docker Run to Compose Converter

1Paste your full docker run command into the box above.
2Run the tool to parse its flags (-p, -v, -e, --name, --restart, and more).
3Copy the generated docker-compose YAML service definition.
4Paste it under "services:" in your docker-compose.yml file.
5Read the Notes output — it tells you about any flags that have no compose equivalent.

What can you do with Docker Run to Compose Converter?

Docker run to docker compose converter — Free docker run to docker compose converter — paste a docker run command and get an equivalent docker-compose YAML service.
Docker compose generator — Free docker run to docker compose converter — paste a docker run command and get an equivalent docker-compose YAML service.
Convert docker run command — Free docker run to docker compose converter — paste a docker run command and get an equivalent docker-compose YAML service.
Compose yaml generator — Free docker run to docker compose converter — paste a docker run command and get an equivalent docker-compose YAML service.

Good to know

Only common flags are converted; exotic flags are skipped with a warning in the Notes output.
The service name comes from --name or the image name; rename it if it clashes with existing services.
Always review generated YAML before deploying to production — automated conversion is a starting point, not a guarantee.

How it works

The command is tokenized with a quote-aware splitter written for this tool, then parsed flag by flag into a service model (image, ports, volumes, environment, networks, restart policy, and more). A hand-written YAML emitter renders the compose service — no YAML library is used, so output formatting is fully controlled. Everything runs locally in your browser. Limitation: exotic flags (device mappings, sysctls, ulimits) are reported as warnings rather than converted; always review the YAML before deploying.

Examples

Web server with port mapping

Status: ok — generates a "web" service with image nginx and ports "8080:80".

App with volumes and env vars

Status: ok — volumes, environment, and restart policy all converted.

Not a docker command

Status: error — the input must be a docker run command.

People also search for these — this tool handles them all:

docker run to composedocker run to docker compose converterdocker compose generatorconvert docker run commandcompose yaml generator