spiegel_podman/docs/source/markdown/options/name.container.md
Jan Kaluza 9de737bf29 Change the syntax to not depend on jinja2.
Signed-off-by: Jan Kaluza <jkaluza@redhat.com>
2025-09-02 16:04:34 +02:00

1 KiB

####> This option file is used in: ####> podman podman-container.unit.5.md.in, create, run ####> If file is edited, make sure the changes ####> are applicable to all of those. << if is_quadlet >>

ContainerName=name

<< else >>

--name=name

<< endif >>

Assign a name to the container.

The operator can identify a container in three ways:

  • UUID long identifier (“f78375b1c487e03c9438c729345e54db9d20cfa2ac1fc3494b6eb60872e74778”);
  • UUID short identifier (“f78375b1c487”);
  • Name (“jonah”).

Podman generates a UUID for each container, and if no name is assigned to the container using << 'ContainerName=' if is_quadlet else '--name' >>, Podman generates a random string name. The name can be useful as a more human-friendly way to identify containers. This works for both background and foreground containers. The container's name is also added to the /etc/hosts file using the container's primary IP address (also see the << 'AddHost=' if is_quadlet else '--add-host' >> option).