Set Docker Container Hostname

The short answer

In Docker, a container hostname is a label assigned to a container to uniquely identify it within a network to facilitate the communication between containers.

To set the hostname of a Docker container during its creation, you can use the docker run command with the --hostname flag as follows:

$ docker run --hostname <hostname> <image>

Where:

• docker run is used to create and run Docker containers.
• hostname is the hostname of the container.
• image is the Docker image the container will be created from.

For example:

$ docker run --hostname my-docker-app ubuntu

This command launches a new container based on the latest version of the ubuntu image and sets its hostname to my-docker-app.

Note that the container's hostname will default to its ID if not specified upon creation.

Easily retrieve this command using Warp’s AI Command Suggestions

If you’re using Warp as your terminal, you can easily retrieve this command using the Warp AI Command Suggestions feature:

Entering docker run new container with hostname in the AI Command Suggestion will prompt a docker command that can then quickly be inserted into your shell by doing CMD+ENTER.

Differences between a container hostname and name

In Docker, container hostnames are used for internal network communication between applications running in different containers. They are, by default, visible to the other containers using the same network unless configured for external access. Container hostnames can be dynamically assigned but must be unique within a specific network.

On the other hand, container names serve as identifiers for users. They need to be unique among all running containers on the Docker host, serving as distinct labels for container management.

Matching the container hostname with the name of the host

To match the hostname of a Docker container with the one of the host machine, you can use the docker run command in following way:

$ docker run --hostname=$(hostname) [options] <image>

Where:

• The hostname command is used to output the name of the current host.
• The $() command substitution syntax is used to execute the specified command and replace it at runtime with its output.

Note that this command substitution mechanism ensures that the container's hostname is synchronized with the hostname of the host system. 

For example:

$ docker run --hostname=$(hostname) -it ubuntu

This command launches a new container based on the latest version of the ubuntu image and dynamically sets its hostname to the current name of the host machine.

Getting a container's hostname using the command-line

To get the hostname of a Docker container, you can use the docker inspect command with the --format flag as follows:

$ docker inspect --format='{{.Config.Hostname}}' <container_id>

Where:

• Docker inspect provides information about Docker containers.
• --format specifies the template to use to format the command's output.
• '{{.Config.Hostname}}' is a format template used to extract the container's hostname.

For example, you can use the docker ps -a command to output the list of running and stopped containers:

$ docker ps -a
CONTAINER ID   IMAGE     COMMAND                  CREATED        STATUS         PORTS                               NAMES
291e978c6b6a   mysql:8   "docker-entrypoint.s…"   6 months ago   Up 2 seconds   0.0.0.0:3306->3306/tcp, 33060/tcp   exciting_davinci

Then use the docker inspect command to get the hostname of a specific container:

$ docker inspect --format='{{.Config.Hostname}}' 291e978c6b6a
mysql-database

You can learn how the hostname within Docker containers, including Postgres containers, influences networking and communication setups from this article.

Getting a container's hostname using a Python script

To get the hostname of a specific Docker container in Python, you can first install the docker package with pip:

$ pip install docker

Then access the Docker API using the docker module:

import docker

def get_container_hostname(container_id):
    client = docker.from_env()
    container = client.containers.get(container_id)
    return container.attrs['Config']['Hostname']

container_id = "container_id" # Replace with the actual container ID
hostname = get_container_hostname(container_id)
print("Container Hostname:", hostname)