mirror of
https://github.com/containers/podman.git
synced 2025-06-05 14:06:01 +08:00

If you change this option all the containers disappear from the default connection and socket. Thus it is required to recreate the resources. Sharing between root and rootless is not possible for various reasons. Fixes #19936 Signed-off-by: Paul Holzinger <pholzing@redhat.com>
86 lines
2.1 KiB
Markdown
86 lines
2.1 KiB
Markdown
% podman-machine-set 1
|
|
|
|
## NAME
|
|
podman\-machine\-set - Set a virtual machine setting
|
|
|
|
## SYNOPSIS
|
|
**podman machine set** [*options*] [*name*]
|
|
|
|
## DESCRIPTION
|
|
|
|
Change a machine setting.
|
|
|
|
The default machine name is `podman-machine-default`. If a machine name is not specified as an argument,
|
|
then the settings will be applied to `podman-machine-default`.
|
|
|
|
Rootless only.
|
|
|
|
## OPTIONS
|
|
|
|
#### **--cpus**=*number*
|
|
|
|
Number of CPUs.
|
|
Only supported for QEMU machines.
|
|
|
|
#### **--disk-size**=*number*
|
|
|
|
Size of the disk for the guest VM in GB.
|
|
Can only be increased. Only supported for QEMU machines.
|
|
|
|
#### **--help**
|
|
|
|
Print usage statement.
|
|
|
|
#### **--memory**, **-m**=*number*
|
|
|
|
Memory (in MB).
|
|
Only supported for QEMU machines.
|
|
|
|
#### **--rootful**
|
|
|
|
Whether this machine prefers rootful (`true`) or rootless (`false`)
|
|
container execution. This option updates 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**](podman-system-connection-default.1.md)
|
|
this option makes the API socket, if available, forward to the rootful/rootless
|
|
socket in the VM.
|
|
|
|
Note that changing this option means that all the existing containers/images/volumes, etc...
|
|
are no longer visible with the default connection/socket. This is because the root and rootless
|
|
users in the VM are completely separated and do not share any storage. The data however is not
|
|
lost and you can always change this option back or use the other connection to access it.
|
|
|
|
@@option user-mode-networking
|
|
|
|
## 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.1.md)**, **[podman-machine(1)](podman-machine.1.md)**
|
|
|
|
## HISTORY
|
|
February 2022, Originally compiled by Jason Greene <jason.greene@redhat.com>
|