Files
podman/docs/source/markdown/podman-machine-set.1.md
Paul Holzinger 7189b6f269 podman machine set: clarify --rootful option
It is not quite clear what the difference between `podman machine set
--rootful` and `podman system connection default` is.
Add a small note with the difference, the --rootful option will also
affect the socket forwarding.

Fixes #13515

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
2022-03-24 12:24:52 +01:00

1.4 KiB

% podman-machine-set(1)

NAME

podman-machine-set - Sets a virtual machine setting

SYNOPSIS

podman machine set [options] [name]

DESCRIPTION

Sets an updatable virtual machine setting.

Options mirror values passed to podman machine init. Only a limited subset can be changed after machine initialization.

OPTIONS

--help

Print usage statement.

--rootful=true|false

Whether this machine should prefer rootful (true) or rootless (false) container execution. This option will also update the current podman remote connection default if it is currently pointing at the specified machine name (or podman-machine-default if no name is specified).

Unlike podman system connection default this option will also make the API socket, if available, forward to the rootful/rootless socket in the VM.

EXAMPLES

To switch the default VM podman-machine-default from rootless to rootful:

$ podman machine set --rootful

or more explicitly:

$ podman machine set --rootful=true

To switch the default VM podman-machine-default from rootful to rootless:

$ podman machine set --rootful=false

To switch the VM myvm from rootless to rootful:

$ podman machine set --rootful myvm

SEE ALSO

podman(1), podman-machine(1)

HISTORY

February 2022, Originally compiled by Jason Greene jason.greene@redhat.com