====== Docker - Containers - Name a container ======

By adding **<nowiki>--name=meaningful_name</nowiki>** to the **docker run** command, the name becomes more recognizable in interactive sessions as well as in the output of commands like **docker ps**.

There are limitations, however since container names must be unique, you cannot use deliberate naming and scale a service beyond one container.

On the Command Line or in a Dockerfile:

<code bash>
docker run --name=meaningful_name
</code>

----

For example, if we ran a container based on the nginx base image and started it like this:

<code bash>
docker run --name nginx -d nginx
</code>

The name would appear in the list of running containers:

<code bash>
docker ps
</code>

returns:

<code bash>
CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                NAMES
08f333ef7216        nginx               "nginx -g 'daemon off"   15 seconds ago      Up 14 seconds       80/tcp, 443/tcp      nginx
</code>

<WRAP info>
**NOTE:**  While the name appears in the output of **docker ps** and can be used to manage the container, it will not appear in the command prompt of the container if you attach to it or in log files.

In order to accomplish that, you'll also need to assign a hostname.

See [[Docker:Containers:Assign a hostname to the container|Assign a hostname to the container]].
</WRAP>