Introduction

The Problem with "docker run"

If you've ever deployed a database or self-hosted application, you've almost certainly encountered a command that looks like this:

docker run -d \
  --name my-postgres \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_USER=admin \
  -v pgdata:/var/lib/postgresql/data \
  -p 5432:5432 \
  --restart always \
  postgres:15-alpine

While this works, it is imperative and unmaintainable.

• What happens when you need to update a single environment variable 3 months from now? You have to remember the exact command.
• How do you commit this to version control? You paste it into a shell script, which is prone to formatting errors.

The Solution: docker-compose.yml

Docker Compose allows you to define your container's configuration in a simple, declarative YAML file.

Using our Docker Run to Compose Converter, the massive command above instantly becomes this beautiful docker-compose.yml file:

version: '3.8'
services:
  my-postgres:
    image: postgres:15-alpine
    container_name: my-postgres
    restart: always
    environment:
      - POSTGRES_PASSWORD=mysecretpassword
      - POSTGRES_USER=admin
    ports:
      - 5432:5432
    volumes:
      - pgdata:/var/lib/postgresql/data

How It Works

Our parser takes the raw string input of your docker run command and tokenizes it using advanced regular expressions to extract key-value pairs based on Docker CLI flags.

Supported Flags:

• -d / --detach: Ignored in compose (run docker-compose up -d).
• --name: Maps to container_name.
• -p / --publish: Maps to the ports array.
• -v / --volume: Maps to the volumes array.
• -e / --env: Maps to the environment array.
• --restart: Maps to restart policy.
• --network: Maps to networks.
• Positional Argument: The final unflagged string is always parsed as the image.

How to use Docker Compose

1. Paste your docker run command into the converter.
2. Copy the generated YAML.
3. Create a new file named docker-compose.yml in your project directory.
4. Paste the YAML into the file.
5. Open your terminal in that directory and type:

   docker-compose up -d
   

   Note: If you have a modern version of Docker, you can simply type docker compose up -d (without the hyphen).