`multipass transfer` command

The multipass transfer command copies files between host and instance, without the need of mounting a folder on the instance.

For example, to copy a local file local_file.txt to the default home folder of the instance good-prawn, use the command:

multipass transfer local_file.txt good-prawn:.

Conversely, to copy a file instance_file.txt from the default home folder of the ample-pigeon instance to the current working folder, use the command:

multipass transfer ample-pigeon:remote_file.txt .

The source file can be the host standard input, in which case the stream will be written on the destination file on the instance. In the same way, the destination can be the standard output of the host and the source a file on the instance. In both cases, the standard input and output are specified with -.

If the target path does not exist, you can use the --parents option, that will create any missing parent directories. For example, if you run the command:

multipass transfer local_file.txt ample-pigeon:non/existent/path/remote_file.txt

and the system informs you that:

[2022-10-11T13:07:25.789] [error] [sftp] remote target does not exist

you can use the --parents option to create the missing parent folders:

multipass transfer --parents local_file.txt ample-pigeon:non/existent/path/remote_file.txt

You can also copy an entire directory tree using the --recursive option:

multipass transfer --recursive ample-pigeon:dir .

---

The full multipass help transfer output explains the available options:

Usage: multipass transfer [options] <source> [<source> ...] <destination>
Copy files and directories between the host and instances.

Options:
  -h, --help       Displays help on commandline options
  -v, --verbose    Increase logging verbosity. Repeat the 'v' in the short
                   option for more detail. Maximum verbosity is obtained with 4
                   (or more) v's, i.e. -vvvv.
  -r, --recursive  Recursively copy entire directories
  -p, --parents    Make parent directories as needed

Arguments:
  source           One or more paths to transfer, prefixed with <name:> for
                   paths inside the instance, or '-' for stdin
  destination      The destination path, prefixed with <name:> for a path
                   inside the instance, or '-' for stdout

---

Errors or typos? Topics missing? Hard to read? Let us know or open an issue on GitHub.