mirror of
https://github.com/containers/podman.git
synced 2025-05-20 16:47:39 +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>
54 lines
1.3 KiB
Markdown
54 lines
1.3 KiB
Markdown
% podman-machine-start 1
|
|
|
|
## NAME
|
|
podman\-machine\-start - Start a virtual machine
|
|
|
|
## SYNOPSIS
|
|
**podman machine start** [*name*]
|
|
|
|
## DESCRIPTION
|
|
|
|
Starts a virtual machine for Podman.
|
|
|
|
Rootless only.
|
|
|
|
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.
|
|
|
|
The default machine name is `podman-machine-default`. If a machine name is not specified as an argument,
|
|
then `podman-machine-default` will be started.
|
|
|
|
Only one Podman managed VM can be active at a time. If a VM is already running,
|
|
`podman machine start` returns an error.
|
|
|
|
**podman machine start** starts a Linux virtual machine where containers are run.
|
|
|
|
## OPTIONS
|
|
|
|
#### **--help**
|
|
|
|
Print usage statement.
|
|
|
|
#### **--no-info**
|
|
|
|
Suppress informational tips.
|
|
|
|
#### **--quiet**, **-q**
|
|
|
|
Suppress machine starting status output.
|
|
|
|
## EXAMPLES
|
|
|
|
Start the specified podman machine.
|
|
```
|
|
$ podman machine start myvm
|
|
```
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-machine(1)](podman-machine.1.md)**
|
|
|
|
## HISTORY
|
|
March 2021, Originally compiled by Ashley Cui <acui@redhat.com>
|