Use docker run command to pass arguments to CMD in Dockerfile

I’m new to Docker and I’m having a hard time to setup the docker container as I want. I have a nodejs app can take two parameters when start. For example, I can use

node server.js 0 dev

  • Problems in Jenkins Guided tour on Mac
  • Dockerfile : not able to use add to map local file to container
  • Using netcat to pipe unix socket to tcp socket
  • Unable to Connect Jenkins Windows 10 Slave to Master running
  • making sure a given docker container is running
  • Access application of one container from another with link/port forward
  • or

    node server.js 1 prod

    to switch between production mode and dev mode and determine if it should turn the cluster on. Now I want to create docker image with arguments to do the similar thing, the only thing I can do so far is to adjust the Dockerfile to have a line

    CMD [ "node", "server.js", "0", "dev"]


    docker build -t me/app . to build the docker.

    Then docker run -p 9000:9000 -d me/app to run the docker.

    But If I want to switch to prod mode, I need to change the Dockerfile CMD to be

    CMD [ "node", "server.js", "1", "prod"] ,

    and I need to kill the old one listening on port 9000 and rebuild the image.
    I wish I can have something like

    docker run -p 9000:9000 environment=dev cluster=0 -d me/app

    to create an image and run the nodejs command with “environment” and “cluster” arguments, so I don’t need to change the Dockerfile and rebuild the docker any more. How can I accomplish this?

  • Get the names of containers in Docker
  • How to bundle docker toolbox, dockerfile, docker-compose file inside a executable file?
  • Using Docker API to push to private registry
  • Docker volume binding: Base image vs derivative image
  • Docker service failed to start application container engine on CentOS7
  • Amazon EFS & Docker - Error when creating an image
  • 3 Solutions collect form web for “Use docker run command to pass arguments to CMD in Dockerfile”

    Make sure your Dockerfile declares an environment variable with ENV:

    ENV environment default_env_value
    ENV cluster default_cluster_value

    The ENV <key> <value> form can be replaced inline.

    Then you can pass an environment variable with docker run

    docker run -p 9000:9000 -e environment=dev -e cluster=0 -d me/app

    Or you can set them through your compose file:

        - environment=dev
        - cluster=0

    Your Dockerfile CMD can use that environment variable, but, as mentioned in issue 5509, you need to do so in a sh -c form:

    CMD ["sh", "-c", "node server.js ${cluster} ${environment}"]

    The explanation is that the shell is responsible for expanding environment variables, not Docker. When you use the JSON syntax, you’re explicitly requesting that your command bypass the shell and be executed directly.

    Same idea with Builder RUN (applies to CMD as well):

    Unlike the shell form, the exec form does not invoke a command shell.
    This means that normal shell processing does not happen.

    For example, RUN [ "echo", "$HOME" ] will not do variable substitution on $HOME. If you want shell processing then either use the shell form or execute a shell directly, for example: RUN [ "sh", "-c", "echo $HOME" ].

    When using the exec form and executing a shell directly, as in the case for the shell form, it is the shell that is doing the environment variable expansion, not docker.

    Another option is to use ENTRYPOINT to specify that node is the executable to run and CMD to provide the arguments. The docs have an example in Exec form ENTRYPOINT example.

    Using this approach, your Dockerfile will look something like

    FROM ...
    ENTRYPOINT [ "node",  "server.js" ]
    CMD [ "0", "dev" ]

    Running it in dev would use the same command

    docker run -p 9000:9000 -d me/app

    and running it in prod you would pass the parameters to the run command

    docker run -p 9000:9000 -d me/app 1 prod

    You may want to omit CMD entirely and always pass in 0 dev or 1 prod as arguments to the run command. That way you don’t accidentally start a prod container in dev or a dev container in prod.

    The typical way to do this in Docker containers is to pass in environment variables:

    docker run -p 9000:9000 -e NODE_ENV=dev -e CLUSTER=0 -d me/app
    Docker will be the best open platform for developers and sysadmins to build, ship, and run distributed applications.