Files
podman/docs/source/markdown/podman-machine-init.1.md
Paul Holzinger 30e731ecc8 Revert escaped double dash man page flag syntax
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>
2021-05-07 18:30:00 +02:00

1.5 KiB

% 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