spiegel_podman/docs/source/markdown/podman-rename.1.md at d01b7ae53484e85ed420e97ab1de9452c7b3d213

mirror of https://github.com/podman-container-tools/podman.git synced 2026-08-05 00:15:44 +00:00

MayorFaj d01b7ae534 libpod: add volume rename support

Add a podman volume rename command, REST API endpoint, and bindings for renaming volumes.

The rename updates both the VolumeConfig and VolumeState tables in a single transaction and moves the volume directory on disk, rolling back if the transaction fails. Renaming an anonymous volume converts it to a named volume. Volumes that are in use, mounted, or backed by a volume plugin or the image driver cannot be renamed.

Fixes: #28189
Signed-off-by: MayorFaj <mayorfaj@gmail.com>

2026-06-11 21:56:15 +01:00

933 B

Raw Blame History

% podman-rename 1

NAME

podman-rename - Rename an existing container

SYNOPSIS

podman rename container newname

podman container rename container newname

DESCRIPTION

Rename changes the name of an existing container. The old name is freed, and is available for use. This command can be run on containers in any state. However, running containers may not fully receive the effects until they are restarted - for example, a running container may still use the old name in its logs. Use podman volume rename to rename volumes. At present, pods cannot be renamed.

OPTIONS

EXAMPLES

Rename container with a given name.

$ podman rename oldContainer aNewName

Rename container with a given ID.

$ podman rename 717716c00a6b testcontainer

Create an alias for container with a given ID.

$ podman container rename 6e7514b47180 databaseCtr

933 B Raw Blame History