Files
podman/docs/source/markdown/podman-machine-create.1.md
Ashley Cui a861f6fd3e Podman machine CLI and interface stub
Podman machine will be a mac-only command that manages the VM where
containers are run. Currently, only the CLI is written and the interface
function for the VM management is stub for future developement

The podman machine cli is only built on mac builds.

Signed-off-by: Ashley Cui <acui@redhat.com>
2021-03-25 08:41:11 -05:00

1.2 KiB

% podman-machine-create(1)

NAME

podman-machine-create - Create a new virtual machine

SYNOPSIS

podman machine create [options] name

DESCRIPTION

Creates 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 create creates a new Linux virtual machine where containers are run.

OPTIONS

--cpus=number

Number of CPUs.

--memory, -m=number

Memory (in MB).

--kernel-path=path

Print usage statement.

--device=device[:permissions]

Add a device to the virtual machine. Optional permissions parameter can be used to specify device permissions. ro means the device is read-only.

Example: --device=/dev/xvdc:ro.

--help

Print usage statement.

EXAMPLES

$ podman machine create myvm
$ podman machine create --device=/dev/xvdc:rw myvm
$ podman machine create --memory=1024 myvm

SEE ALSO

podman-machine (1)

HISTORY

March 2021, Originally compiled by Ashley Cui acui@redhat.com