mirror of
https://github.com/containers/podman.git
synced 2025-06-03 20:33:20 +08:00

Podman Machine crashes if run as root. When creating the machine, we write the ignition so that the UID of the core user matches the UID of the user on the host. We by default, create the root user on the machine with UID 0. If the user on the host is root, the core UID and the Root UID collide, causing a the VM not to boot. [NO NEW TESTS NEEDED] Signed-off-by: Ashley Cui <acui@redhat.com>
37 lines
2.1 KiB
Markdown
37 lines
2.1 KiB
Markdown
% podman-machine(1)
|
|
|
|
## NAME
|
|
podman\-machine - Manage Podman's virtual machine
|
|
|
|
## SYNOPSIS
|
|
**podman machine** *subcommand*
|
|
|
|
## DESCRIPTION
|
|
`podman machine` is a set of subcommands that manage Podman's virtual machine.
|
|
|
|
Podman on MacOS and Windows requires a virtual machine. This is because containers are Linux -
|
|
containers do not run on any other OS because containers' core functionality are
|
|
tied to the Linux kernel. Podman machine must be used to manage MacOS and Windows machines,
|
|
but can be optionally used on Linux.
|
|
|
|
All `podman machine` commands are rootless only.
|
|
|
|
## SUBCOMMANDS
|
|
|
|
| Command | Man Page | Description |
|
|
|---------|------------------------------------------------------|-----------------------------------|
|
|
| init | [podman-machine-init(1)](podman-machine-init.1.md) | Initialize a new virtual machine |
|
|
| inspect | [podman-machine-inspect(1)](podman-machine-inspect.1.md) | Inspect one or more virtual machines |
|
|
| list | [podman-machine-list(1)](podman-machine-list.1.md) | List virtual machines |
|
|
| rm | [podman-machine-rm(1)](podman-machine-rm.1.md) | Remove a virtual machine |
|
|
| set | [podman-machine-set(1)](podman-machine-set.1.md) | Sets a virtual machine setting |
|
|
| ssh | [podman-machine-ssh(1)](podman-machine-ssh.1.md) | SSH into a virtual machine |
|
|
| start | [podman-machine-start(1)](podman-machine-start.1.md) | Start a virtual machine |
|
|
| stop | [podman-machine-stop(1)](podman-machine-stop.1.md) | Stop a virtual machine |
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-machine-init(1)](podman-machine-init.1.md)**, **[podman-machine-list(1)](podman-machine-list.1.md)**, **[podman-machine-rm(1)](podman-machine-rm.1.md)**, **[podman-machine-ssh(1)](podman-machine-ssh.1.md)**, **[podman-machine-start(1)](podman-machine-start.1.md)**, **[podman-machine-stop(1)](podman-machine-stop.1.md)**, **[podman-machine-inspect(1)](podman-machine-inspect.1.md)**
|
|
|
|
## HISTORY
|
|
March 2021, Originally compiled by Ashley Cui <acui@redhat.com>
|