github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/podman-rename.1.md (about)

     1  % podman-rename 1
     2  
     3  ## NAME
     4  podman\-rename - Rename an existing container
     5  
     6  ## SYNOPSIS
     7  **podman rename** *container* *newname*
     8  
     9  **podman container rename** *container* *newname*
    10  
    11  ## DESCRIPTION
    12  Rename changes the name of an existing container.
    13  The old name is freed, and is available for use.
    14  This command can be run on containers in any state.
    15  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.
    16  At present, only containers are supported; pods and volumes cannot be renamed.
    17  
    18  ## OPTIONS
    19  
    20  ## EXAMPLES
    21  
    22  Rename container with a given name.
    23  ```
    24  $ podman rename oldContainer aNewName
    25  ```
    26  
    27  Rename container with a given ID.
    28  ```
    29  $ podman rename 717716c00a6b testcontainer
    30  ```
    31  
    32  Create an alias for container with a given ID.
    33  ```
    34  $ podman container rename 6e7514b47180 databaseCtr
    35  ```
    36  
    37  ## SEE ALSO
    38  **[podman(1)](podman.1.md)**