mirror of
https://github.com/containers/podman.git
synced 2025-05-23 01:57:56 +08:00
30e731ecc8
Commit 800a2e2d35 introduced a way to disable the conversion of `--`into an en dash on docs.podman.io, so the ugly workaround of escaping the dashes is no longer necessary. Signed-off-by: Paul Holzinger <paul.holzinger@web.de>
65 lines
1.5 KiB
Markdown
65 lines
1.5 KiB
Markdown
% podman-machine-init(1)
|
|
|
|
## NAME
|
|
podman\-machine\-init - Initialize a new virtual machine
|
|
|
|
## SYNOPSIS
|
|
**podman machine init** [*options*] [*name*]
|
|
|
|
## DESCRIPTION
|
|
|
|
Initialize a new virtual machine for Podman.
|
|
|
|
Podman on macOS 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 init** initializes a new Linux virtual machine where containers are run.
|
|
SSH keys are automatically generated to access the VM, and system connections to the root account
|
|
and a user account inside the VM are added.
|
|
|
|
## OPTIONS
|
|
|
|
#### **--cpus**=*number*
|
|
|
|
Number of CPUs.
|
|
|
|
#### **--disk-size**=*number*
|
|
|
|
Size of the disk for the guest VM in GB.
|
|
|
|
#### **--ignition-path**
|
|
|
|
Fully qualified path of the ignition file.
|
|
|
|
If an ignition file is provided, the file
|
|
will be copied into the user's CONF_DIR and renamed. Additionally, no SSH keys will
|
|
be generated nor will a system connection be made. It is assumed that the user will
|
|
do these things manually or handle otherwise.
|
|
|
|
#### **--image-path**
|
|
|
|
Fully qualified path of the uncompressed image file
|
|
|
|
#### **--memory**, **-m**=*number*
|
|
|
|
Memory (in MB).
|
|
|
|
#### **--help**
|
|
|
|
Print usage statement.
|
|
|
|
## EXAMPLES
|
|
|
|
```
|
|
$ podman machine init myvm
|
|
$ podman machine init --device=/dev/xvdc:rw myvm
|
|
$ podman machine init --memory=1024 myvm
|
|
```
|
|
|
|
## SEE ALSO
|
|
podman-machine (1)
|
|
|
|
## HISTORY
|
|
March 2021, Originally compiled by Ashley Cui <acui@redhat.com>
|