docker run to Compose Converter

Handles quoted values, backslash line continuations and --flag=value form. Named volumes and networks referenced by the command are declared at the top level.

Service name (defaults to --name, then the image)

docker run commanddocker run -d --name postgres \
  --restart unless-stopped \
  -p 5432:5432 \
  -e POSTGRES_USER=checkout \
  -e POSTGRES_PASSWORD="s3cr3t pass" \
  -e POSTGRES_DB=checkout \
  -v pgdata:/var/lib/postgresql/data \
  -v ./initdb:/docker-entrypoint-initdb.d:ro \
  --network backend \
  --health-cmd "pg_isready -U checkout" \
  --health-interval 10s \
  --memory 1g \
  postgres:16-alpine -c max_connections=200

docker-compose.ymlservices:
  postgres:
    image: postgres:16-alpine
    container_name: postgres
    restart: unless-stopped
    ports:
      - '5432:5432'
    environment:
      POSTGRES_USER: checkout
      POSTGRES_PASSWORD: s3cr3t pass
      POSTGRES_DB: checkout
    volumes:
      - pgdata:/var/lib/postgresql/data
      - ./initdb:/docker-entrypoint-initdb.d:ro
    networks:
      - backend
    mem_limit: 1g
    command:
      - '-c'
      - max_connections=200
    healthcheck:
      test:
        - CMD-SHELL
        - pg_isready -U checkout
      interval: 10s
volumes:
  pgdata: null
networks:
  backend:
    external: true

docker run to Compose Converter — Free Online Tool

Converts a docker run command line into a docker-compose.yml service definition, mapping -p, -v, -e, --name, --network, --restart, --link, -w, -u, --entrypoint, --cap-add and --health flags onto their Compose keys, handling repeated flags, combined short flags and quoted values, and keeping the trailing image and command arguments.

How to use the docker run to Compose Converter

Open the tool above — it runs entirely in your browser, so your input never leaves this page.
Paste or type your input into the field, then press the relevant button (e.g. Encode / Decode, Generate, or Convert).
Copy the result from the output area with the copy button orCtrl/Cmd + C.
No signup, no upload, and no tracking — repeat as often as you need.

Frequently asked questions

Which docker run flags are supported?

The ones with a Compose equivalent: -p, -v, -e, --name, --network, --restart, -w, -u, --entrypoint, --cap-add/drop, --label, --health-*, --memory, --cpus, --device, --add-host and more. Runtime-only flags such as -d, -it and --rm have no Compose key and are dropped.

Why are volumes and networks also declared at the bottom?

Compose requires a top-level declaration for any named volume or network a service references. A bind mount (a path starting with . or /) needs no declaration, so only genuine named volumes are listed.

Is the generated file ready to run?

Usually yes with docker compose up. Check two things: networks are declared external: true on the assumption they already exist, and mem_limit and cpus apply under Compose v2 but are ignored by Swarm, which wants a deploy.resources block instead.

Free & private — why use this docker run to Compose Converter

The docker run to Compose Converter runs 100% client-side in your browser. Your data is never uploaded to a server, no account is required, and the tool is completely free. It works offline once the page has loaded and is part of a growing collection of privacy-first developer utilities.

More devops & date/time tools

Timestamp Converter Timezone Converter Duration Calculator Age Calculator Cron Expression Builder Cron Expression Parser View all 16 DevOps & Date/Time Tools →