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

     1  % podman-tag 1
     2  
     3  ## NAME
     4  podman\-tag - Add an additional name to a local image
     5  
     6  ## SYNOPSIS
     7  **podman tag** *image*[:*tag*] [*target-name*[:*tag*]...] [*options*]
     8  
     9  **podman image tag** *image*[:*tag*] [*target-name*[:*tag*]...] [*options*]
    10  
    11  ## DESCRIPTION
    12  Assigns a new image name to an existing image.  A full name refers to the entire
    13  image name, including the optional *tag* after the `:`.  If there is no *tag*
    14  provided, then Podman defaults to `latest` for both the *image* and the
    15  *target-name*.
    16  
    17  ## OPTIONS
    18  
    19  #### **--help**, **-h**
    20  
    21  Print usage statement
    22  
    23  ## EXAMPLES
    24  
    25  Tag specified image with an image name defaulting to :latest.
    26  ```
    27  $ podman tag 0e3bbc2 fedora:latest
    28  ```
    29  
    30  Tag specified image with fully specified image name.
    31  ```
    32  $ podman tag httpd myregistryhost:5000/fedora/httpd:v2
    33  ```
    34  
    35  Tag specified image with multiple tags.
    36  ```
    37  $ podman tag mymariadb mycontainerregistry.io/namespace/mariadb:10 mycontainerregistry.io/namespace/mariadb:10.11 mycontainerregistry.io/namespace/mariadb:10.11.12
    38  ```
    39  
    40  
    41  ## SEE ALSO
    42  **[podman(1)](podman.1.md)**
    43  
    44  ## HISTORY
    45  December 2019, Update description to refer to 'name' instead of 'alias' by Sascha Grunert <sgrunert@suse.com>
    46  July 2017, Originally compiled by Ryan Cole <rycole@redhat.com>