What is ENTRYPOINT in Dockerfile: Definition and Usage

The ENTRYPOINT instruction in a Dockerfile sets the main command that runs when a container starts. It defines the executable and its default parameters, making the container behave like a standalone application.

How It Works

The ENTRYPOINT in a Dockerfile works like the main program your container runs when it starts. Think of it as setting the "default action" your container will perform, similar to how a coffee machine automatically brews coffee when you press start.

When you run a container, Docker uses the ENTRYPOINT command as the base command. You can add extra options or arguments when starting the container, which get passed to this command. This makes your container behave like a specific tool or app that always runs the same program but can take different inputs.

Unlike CMD, which provides default arguments, ENTRYPOINT defines the fixed command that always runs. This helps create containers that act like dedicated executables.

Example

This example Dockerfile uses ENTRYPOINT to run the echo command by default. When you run the container, it prints the message you provide.

dockerfile

FROM alpine:3.18
ENTRYPOINT ["echo"]

Output

Hello from ENTRYPOINT

When to Use

Use ENTRYPOINT when you want your container to behave like a specific program or tool that always runs the same command. This is useful for containers that wrap a single application or script.

For example, if you create a container that runs a database client, you can set ENTRYPOINT to the client executable so users only need to provide arguments like server address or query.

It is also helpful when you want to ensure the container always runs a certain command, even if users add extra parameters.

Key Points

• ENTRYPOINT sets the main command for the container.
• It makes the container act like a specific executable.
• You can pass extra arguments when running the container.
• It differs from CMD which only provides default arguments.
• Use it to create focused, reusable container tools.

Key Takeaways

ENTRYPOINT defines the fixed command that runs when a container starts.

It makes containers behave like dedicated applications or tools.

You can add extra arguments to the ENTRYPOINT command at runtime.

ENTRYPOINT differs from CMD which only sets default parameters.

Use ENTRYPOINT to ensure your container always runs the intended program.