summaryrefslogtreecommitdiff
path: root/docs/source/markdown/podman-machine-create.1.md
blob: 8282e3d565eb67b01c44395625e3547cf2f6ede3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
% 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>