github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/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 will be freed, and will be 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  ```
    23  # Rename a container by name
    24  $ podman rename oldContainer aNewName
    25  ```
    26  
    27  ```
    28  # Rename a container by ID
    29  $ podman rename 717716c00a6b testcontainer
    30  ```
    31  
    32  ```
    33  # Use the container rename alias
    34  $ podman container rename 6e7514b47180 databaseCtr
    35  ```
    36  
    37  ## SEE ALSO
    38  **[podman(1)](podman.1.md)**