summaryrefslogtreecommitdiff
path: root/docs/source/markdown/podman-rename.1.md
blob: a91ac26665376c62a70856fad2dc88466d7199da (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
% 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 will be freed, and will be 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.

## 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
```

## SEE ALSO
**[podman(1)](podman.1.md)**