Docker Run to Compose Converter
Free, private, 100% client-side.
Loading tool...
What is Docker Run to Compose Converter?
Docker Run to Compose Converter is a free online tool that turns docker run commands into Docker Compose service definitions. Paste the command you already use — from shell history, a README, or a CI pipeline — and get a clean YAML block with image, container name, ports, volumes, environment variables, restart policy, healthchecks, logging, and more mapped to their Compose keys.
Key Benefits
- Migrate legacy docker run scripts to compose files in seconds
- Automatic mapping of 40+ flags eliminates manual translation errors
- Notes section flags options that need a manual decision
- Private by design — commands never leave your browser
Common Use Cases
- •Convert a long docker run command from a wiki page into a compose service
- •Move one-off containers into a version-controlled docker-compose.yml
- •Prepare services for docker compose up during local development
- •Standardize how your team defines containers across projects
How to Convert docker run to docker-compose.yml
- Paste the command: Copy the full docker run (or docker create) command, including multi-line backslashes, into the input box.
- Review the YAML: The docker-compose.yml output appears automatically with service name, image, ports, volumes, and environment mapped from your flags.
- Handle the warnings: Read the notes for manual review — each item is a flag the converter could not map confidently, so add or adjust it by hand in the YAML.
- Copy or download: Press Copy or Download to save docker-compose.yml, then run docker compose up -d to verify it behaves like the original command.
Key Features
- Maps 40+ docker run flags to Compose service keys
- Correct shell tokenizing: quotes, escapes, and line continuations
- Combined short flags like -it are expanded automatically
- Healthcheck, logging, cap-add, devices, and tmpfs support
- Copy or download the generated docker-compose.yml in one click
- Runs entirely in your browser — no data is transmitted
Frequently Asked Questions
Which docker run flags are converted?
Common ones — --name, -p/--publish, -v/--volume, -e/--env, --restart, --network, --user, labels, and more — map to the matching Compose keys. Anything unusual is excluded and listed for manual review.
Do multi-line commands work?
Yes — paste a command spanning several lines with trailing backslashes (like the ones in READMEs) and it is parsed as one command. docker create and sudo docker run are accepted too.
Why do I see warnings after converting?
Some docker run options have no clean Compose equivalent, so instead of guessing the tool emits the YAML it is sure about and lists the rest under notes for manual review, so nothing silently breaks.
Can I keep the result in a repository?
Yes — download it as docker-compose.yml or copy it to your clipboard and commit it. Conversion happens locally in your browser, so private flags and env values never leave your machine.