.nh
.TH podman-volume-rename 1
.SH NAME
podman-volume-rename \- Rename a volume

.SH SYNOPSIS
\fBpodman volume rename\fP \fIvolume\fP \fInew_name\fP

.SH DESCRIPTION
Renames an existing volume. The following restrictions apply:
.IP \(bu 2
The volume must not be in use by any containers (running or stopped).
.IP \(bu 2
The volume must not be currently mounted (via \fBpodman volume mount\fP).
.IP \(bu 2
Only volumes using the \fBlocal\fP driver can be renamed; volumes backed by
a volume plugin or the \fBimage\fP driver cannot be renamed.

.PP
Renaming an anonymous volume converts it to a named volume.

.SH OPTIONS
None.

.SH EXAMPLES
Rename volume \fBmydata\fR to \fBdata_backup\fR:

.EX
$ podman volume rename mydata data_backup
.EE

.SH SEE ALSO
\fBpodman(1)\fP, \fBpodman-volume(1)\fP, \fBpodman-volume-inspect(1)\fP

.SH HISTORY
June 2026, Originally compiled by Podman Developers