Docker Run to Docker Compose Converter

Convert docker run commands to docker-compose.yml format with proper YAML structure and service configuration.

Docker Run Command

Supports multiple commands separated by newlines or &&. Line continuations with \ are handled.

docker-compose.yml

version: '3'
services:
  my-nginx:
    container_name: my-nginx
    ports:
      - '8080:80'
      - '443:443'
    volumes:
      - /data/html:/usr/share/nginx/html
      - /data/conf:/etc/nginx/conf.d
    environment:
      - NGINX_HOST=example.com
      - NGINX_PORT=80
    restart: unless-stopped
    networks:
      - my-network
    image: nginx:latest
networks:
  my-network:
    external: true

Supported Flags

--namecontainer_name

-p / --publishports

-v / --volumevolumes

-e / --envenvironment

--networknetworks

--restartrestart

-d / --detach(implicit in compose)

--hostnamehostname

-w / --workdirworking_dir

--entrypointentrypoint

-u / --useruser

-l / --labellabels

--cpusdeploy.resources.limits.cpus

-m / --memorydeploy.resources.limits.memory

1. Paste your complete docker run command (including all flags like -p, -v, -e, --network) into the input area. 2. The tool automatically parses the command and maps each flag to its docker-compose.yml equivalent. 3. Review the generated YAML output to verify the service name, ports, volumes, and environment variables are correct. 4. For multi-container setups, paste additional docker run commands on separate lines to generate a multi-service Compose file. 5. Click "Copy YAML" to copy the complete docker-compose.yml content to your clipboard. 6. Save the output as a docker-compose.yml file in your project directory and run it with docker compose up.

About This Tool

The Docker Run to Docker Compose Converter transforms long, complex docker run commands into clean, readable docker-compose.yml files. Paste a docker run command with all its flags (ports, volumes, environment variables, networks, restart policies) and get a properly structured Compose file ready to use.

Managing containers with docker run commands quickly becomes unwieldy as configurations grow. Docker Compose files provide a declarative, version-controlled alternative that is easier to read, share, and maintain. This converter handles the translation automatically, mapping command-line flags to their Compose equivalents.

The tool supports common docker run options including -p (port mapping), -v (volume mounts), -e (environment variables), --network, --restart, --name, --hostname, -d (detach), --cpus, --memory, --user, and many more. It produces valid Compose file syntax compatible with Docker Compose v3.

Frequently Asked Questions

The converter supports most common flags including -p (ports), -v (volumes), -e (environment variables), --name, --network, --restart, -d (detach), --hostname, --cpus, --memory, --user, --workdir, --entrypoint, and --label.

The tool generates Compose files compatible with the v3 format specification, which is the most widely used version. The output works with both the docker-compose command and the newer docker compose CLI plugin.

Yes, paste multiple docker run commands (one per line or separated by &&) and the tool will generate a multi-service Compose file with each command as a separate service. Service names are derived from the --name flag or the image name.

The tool focuses on converting runtime configuration from docker run flags. Build configuration (Dockerfile, build context) is typically added separately in the Compose file since docker run works with pre-built images.

Related Tools

YAML Formatter and Viewer

Format, validate, and visualize YAML documents with tree view and customizable indentation.

Developer Tools

JSON to YAML Converter

Convert JSON documents to YAML format with syntax validation, clean formatting, and instant preview.

Developer Tools

Crontab Generator

Visually build cron expressions with dropdowns, see human-readable descriptions, and preview the next 5 run times.

DevOps Tools

Git Cheatsheet

Searchable interactive Git command reference organized by workflow - branching, merging, rebasing, and more.

DevOps Tools

Regex Cheatsheet

Interactive regex syntax reference with descriptions, examples, and a try-it-live tester for each pattern.

DevOps Tools