Files
podman/docs/source/markdown/podman-machine-cp.1.md
Jake Correnti 42fb942a6f Introduce podman machine cp command
Add a new `podman machine cp` subcommand to allow users to copy files or
directories between a running Podman Machine and their host.

Tests cover the following cases:
- Copy a file from the host machine to the VM
- Copy a directory from the host machine to the VM
- Copy a file from the VM to the host machine
- Copy a directory from the VM to the host machine
- Copy a file to a directory
- Copy a directory to a file

Signed-off-by: Jake Correnti <jakecorrenti+github@proton.me>
2025-02-28 09:56:46 -05:00

1.5 KiB

% podman-machine-cp 1

NAME

podman-machine-cp - Securely copy contents between the host and the virtual machine

SYNOPSIS

podman machine cp [options] src_path dest_path

DESCRIPTION

Use secure copy (scp) to copy files or directories between the virtual machine and your host machine.

podman machine cp does not support copying between two virtual machines, which would require two machines running simultaneously.

Additionally, podman machine cp will automatically do a recursive copy of files and directories.

OPTIONS

--help

Print usage statement.

--quiet, -q

Suppress copy status output.

EXAMPLES

Copy a file from your host to the running Podman Machine.

$ podman machine cp ~/configuration.txt podman-machine-default:~/configuration.txt
...
Copy Successful

Copy a file from the running Podman Machine to your host.

$ podman machine cp podman-machine-default:~/logs/log.txt ~/logs/podman-machine-default.txt
...
Copy Successful

Copy a directory from your host to the running Podman Machine.

$ podman machine cp ~/.config podman-machine-default:~/.config
...
Copy Successful

Copy a directory from the running Podman Machine to your host.

$ podman machine cp podman-machine-default:~/.config ~/podman-machine-default.config
...
Copy Successful

SEE ALSO

podman(1), podman-machine(1)

HISTORY

February 2025, Originally compiled by Jake Correnti jcorrent@redhat.com