How to Override ENTRYPOINT Using docker run

Docker containers make it easy to run applications in isolated environments. The ENTRYPOINT instruction in a Dockerfile defines how a container should behave when it starts. However, sometimes, you might need to change this default behavior. For example, if you want to debug the container or run a different command, you can use the –entrypoint option with the docker run command. This lets you temporarily set a new entry point for that specific run of the container, without changing the original Dockerfile.

In this article, we’ll show you how to override the ENTRYPOINT using the docker run command.

What is ENTRYPOINT in Docker?

ENTRYPOINT is a command in a Dockerfile that sets the main program to run when a Docker container starts. Unlike CMD, which provides default arguments, ENTRYPOINT makes the container act like a standalone program. For instance, in the following example, the /bin/bash will always run by default when the container starts:

FROM ubuntu
ENTRYPOINT ["/bin/bash"]

Before proceeding with overriding the ENTRYPOINT, make sure to install Docker on your Ubuntu system or any other operating system you are using.

Overriding the ENTRYPOINT Using docker run

You can override the ENTRYPOINT set in a Dockerfile by using the –entrypoint option with the docker run command. This lets you temporarily set a different command to run when the container starts. The basic syntax to override an ENTRYPOINT looks like this:

docker run --entrypoint <new-entrypoint> [OPTIONS] IMAGE [ARGUMENTS]

Here, <new-entrypoint> is the command you want to run instead of the default ENTRYPOINT. You can also include other options, the image name, and arguments for the new command.

Let’s explore the following steps to learn how to override an ENTRYPOINT using the docker run command:

Step 1: Create a Dockerfile

Let’s create a Dockerfile to define a custom ENTRYPOINT and CMD by adding the following content to it:

FROM ubuntu
LABEL maintainer="anees"
RUN apt update
ENTRYPOINT ["echo"]
CMD ["Greetings from Anees Asghar!"]

Step 2: Build the Docker Image

Now build the image using the docker build command and name it ultahost-image:

sudo docker build -t ultahost-image .

Step 3: Verify Default ENTRYPOINT

Let’s use the following command to run the container to verify the default ENTRYPOINT:

sudo docker run ultahost-image

The output confirms that the image uses the default ENTRYPOINT (echo) with the CMD (Greetings from Anees Asghar!).

Step 4: Docker Run Override ENTRYPOINT 

To override the default ENTRYPOINT in the image, use the –entrypoint flag with a new command, as shown below:

sudo docker run --entrypoint /bin/bash ultahost-image -c "echo 'Overridden entrypoint'"

Here, “–entrypoint /bin/bash” Overrides the default ENTRYPOINT with /bin/bash and -c “echo ‘Overridden entrypoint'” passes a command to the new ENTRYPOINT:

Step 5: Verify the Behavior

For a profound understanding, first, run the image without –entrypoint to confirm the default behavior:

sudo docker run ultahost-image

After this, run the image with –entrypoint to observe the overridden behavior:

sudo docker run --entrypoint /bin/bash ultahost-image -c "echo 'Overridden entrypoint'"

Best Practices for Docker Override ENTRYPOINT

You can follow the below-listed practices to ensure efficient and maintainable overriding of Docker ENTRYPOINT:

1. Use –entrypoint only when necessary, and update your Dockerfile if frequent overrides are needed.
2. Combine ENTRYPOINT and CMD effectively to make your container more flexible.
3. Keep ENTRYPOINT scripts simple to avoid unnecessary complexity.
4. Document any overrides clearly in your project’s README or documentation for better understanding.

Conclusion

Overriding the ENTRYPOINT in Docker containers can be useful when you need to change the default behavior temporarily without altering the Dockerfile itself. To do this, you can use the docker run command with the –entrypoint option. This practice allows you to easily run a different command or debug your container. However, it’s important to use this method carefully and write down any changes to keep things clear and efficient. In this article, we explained how you can override ENTRYPOINT using the “docker run entrypoint” command.

FAQ