docker-volume-rename(1)

docker-volume-rename1

Rename a volume

Part of podman-volume-rename(1).

Usage

podman volume rename volume new_name

Overview

Renames an existing volume. The following restrictions apply:

•

The volume must not be in use by any containers (running or stopped).

•

The volume must not be currently mounted (via podman volume mount).

•

Only volumes using the local driver can be renamed; volumes backed by a volume plugin or the image driver cannot be renamed.

Renaming an anonymous volume converts it to a named volume.

Options

None.

Examples

Rename volume mydata to data_backup:

$ podman volume rename mydata data_backup

History

June 2026, Originally compiled by Podman Developers

From podman-docker 6.1.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.