github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/docs/source/markdown/podman-image-scp.1.md (about)

     1  % podman-image-scp(1)
     2  
     3  ## NAME
     4  podman-image-scp - Securely copy an image from one host to another
     5  
     6  ## SYNOPSIS
     7  **podman image scp** [*options*] *name*[:*tag*]
     8  
     9  ## DESCRIPTION
    10  **podman image scp** copies container images between hosts on a network. You can load to the remote host or from the remote host as well as in between two remote hosts.
    11  Note: `::` is used to specify the image name depending on if you are saving or loading. Images can also be transferred from rootful to rootless storage on the same machine without using sshd. This feature is not supported on the remote client, including Mac and Windows (excluding WSL2) machines.
    12  
    13  **podman image scp [GLOBAL OPTIONS]**
    14  
    15  **podman image** *scp [OPTIONS] NAME[:TAG] [HOSTNAME::]*
    16  
    17  **podman image** *scp [OPTIONS] [HOSTNAME::]IMAGENAME*
    18  
    19  **podman image** *scp [OPTIONS] [HOSTNAME::]IMAGENAME [HOSTNAME::]*
    20  
    21  ## OPTIONS
    22  
    23  #### **--help**, **-h**
    24  
    25  Print usage statement
    26  
    27  #### **--quiet**, **-q**
    28  
    29  Suppress the output
    30  
    31  ## EXAMPLES
    32  
    33  
    34  ```
    35  $ podman image scp alpine
    36  Loaded image: docker.io/library/alpine:latest
    37  ```
    38  
    39  ```
    40  $ podman image scp alpine Fedora::/home/charliedoern/Documents/alpine
    41  Getting image source signatures
    42  Copying blob 72e830a4dff5 done
    43  Copying config 85f9dc67c7 done
    44  Writing manifest to image destination
    45  Storing signatures
    46  Loaded image: docker.io/library/alpine:latest
    47  ```
    48  
    49  ```
    50  $ podman image scp Fedora::alpine RHEL::
    51  Loaded image: docker.io/library/alpine:latest
    52  ```
    53  
    54  ```
    55  $ podman image scp charliedoern@192.168.68.126:22/run/user/1000/podman/podman.sock::alpine
    56  WARN[0000] Unknown connection name given. Please use system connection add to specify the default remote socket location
    57  Getting image source signatures
    58  Copying blob 9450ef9feb15 [--------------------------------------] 0.0b / 0.0b
    59  Copying config 1f97f0559c done
    60  Writing manifest to image destination
    61  Storing signatures
    62  Loaded image: docker.io/library/alpine:latest
    63  ```
    64  
    65  ```
    66  $ sudo podman image scp root@localhost::alpine username@localhost::
    67  Copying blob e2eb06d8af82 done
    68  Copying config 696d33ca15 done
    69  Writing manifest to image destination
    70  Storing signatures
    71  Getting image source signatures
    72  Copying blob 5eb901baf107 skipped: already exists
    73  Copying config 696d33ca15 done
    74  Writing manifest to image destination
    75  Storing signatures
    76  Loaded image: docker.io/library/alpine:latest
    77  ```
    78  
    79  ```
    80  $ sudo podman image scp root@localhost::alpine
    81  Copying blob e2eb06d8af82 done
    82  Copying config 696d33ca15 done
    83  Writing manifest to image destination
    84  Storing signatures
    85  Getting image source signatures
    86  Copying blob 5eb901baf107
    87  Copying config 696d33ca15 done
    88  Writing manifest to image destination
    89  Storing signatures
    90  Loaded image: docker.io/library/alpine:latest
    91  ```
    92  
    93  ## SEE ALSO
    94  **[podman(1)](podman.1.md)**, **[podman-load(1)](podman-load.1.md)**, **[podman-save(1)](podman-save.1.md)**, **[podman-remote(1)](podman-remote.1.md)**, **[podman-system-connection-add(1)](podman-system-connection-add.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**, **[containers-transports(5)](https://github.com/containers/image/blob/main/docs/containers-transports.5.md)**
    95  
    96  ## HISTORY
    97  July 2021, Originally written by Charlie Doern <cdoern@redhat.com>