mirror of
https://github.com/containers/podman.git
synced 2025-05-28 21:46:51 +08:00
d3a49fdedb
On Mac and Windows systems the --latest option is not supported this PR mentions this fact in the examples section of the man page. Also added documentation and consistency to the man pages examples sections. Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
100 lines
2.8 KiB
Markdown
100 lines
2.8 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.
|
|
|
|
#### **--usb**=*bus=number,devnum=number* or *vendor=hexadecimal,product=hexadecimal* or *""*
|
|
|
|
Assign a USB device from the host to the VM.
|
|
Only supported for QEMU Machines.
|
|
|
|
The device needs to be present when the VM starts.
|
|
The device needs to have proper permissions in order to be assign to podman machine.
|
|
|
|
Use an empty string to remove all previously set USB devices.
|
|
|
|
Note that using bus and device number are simpler but the values can change every boot or when the
|
|
device is unplugged. Using vendor and product might lead to collision in the case of multiple
|
|
devices with the same vendor product value, the first available device is assigned.
|
|
|
|
@@option user-mode-networking
|
|
|
|
## EXAMPLES
|
|
|
|
To switch the default Podman machine from rootless to rootful:
|
|
|
|
```
|
|
$ podman machine set --rootful
|
|
```
|
|
|
|
or more explicitly set with value true.
|
|
|
|
```
|
|
$ podman machine set --rootful=true
|
|
```
|
|
|
|
Switch the default Podman machine from rootful to rootless.
|
|
```
|
|
$ podman machine set --rootful=false
|
|
```
|
|
|
|
Switch the specified Podman machine 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>
|