43 lines
959 B
Groff
43 lines
959 B
Groff
.nh
|
|
.TH podman-rename 1
|
|
.SH NAME
|
|
podman-rename \- Rename an existing container
|
|
|
|
.SH SYNOPSIS
|
|
\fBpodman rename\fP \fIcontainer\fP \fInewname\fP
|
|
|
|
.PP
|
|
\fBpodman container rename\fP \fIcontainer\fP \fInewname\fP
|
|
|
|
.SH 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.
|
|
At present, only containers are supported; pods and volumes cannot be renamed.
|
|
|
|
.SH OPTIONS
|
|
.SH EXAMPLES
|
|
Rename container with a given name.
|
|
|
|
.EX
|
|
$ podman rename oldContainer aNewName
|
|
.EE
|
|
|
|
.PP
|
|
Rename container with a given ID.
|
|
|
|
.EX
|
|
$ podman rename 717716c00a6b testcontainer
|
|
.EE
|
|
|
|
.PP
|
|
Create an alias for container with a given ID.
|
|
|
|
.EX
|
|
$ podman container rename 6e7514b47180 databaseCtr
|
|
.EE
|
|
|
|
.SH SEE ALSO
|
|
\fBpodman(1)\fP
|