1podman-machine-init(1)()                              podman-machine-init(1)()
2
3
4

NAME

6       podman-machine-init - Initialize a new virtual machine
7
8

SYNOPSIS

10       podman machine init [options] [name]
11
12

DESCRIPTION

14       Initialize a new virtual machine for Podman.
15
16
17       Podman  on macOS requires a virtual machine. This is because containers
18       are Linux - containers do not run on any other OS  because  containers'
19       core functionality are tied to the Linux kernel.
20
21
22       podman  machine init initializes a new Linux virtual machine where con‐
23       tainers are run.  SSH keys are automatically generated  to  access  the
24       VM,  and  system connections to the root account and a user account in‐
25       side the VM are added.
26
27
28       By default, the VM distribution is Fedora CoreOS.   Fedora  CoreOS  up‐
29       grades  come out every 14 days and are detected and installed automati‐
30       cally. The VM will be rebooted during the upgrade.  For  more  informa‐
31       tion  on updates and advanced configuration, please see the FCOS update
32       docs here and here.
33
34

OPTIONS

36   --cpus=number
37       Number of CPUs.
38
39
40   --disk-size=number
41       Size of the disk for the guest VM in GB.
42
43
44   --ignition-path
45       Fully qualified path of the ignition file.
46
47
48       If an ignition file is provided, the  file  will  be  copied  into  the
49       user's  CONF_DIR and renamed.  Additionally, no SSH keys will be gener‐
50       ated nor will a system connection be made.  It is assumed that the user
51       will do these things manually or handle otherwise.
52
53
54   --image-path
55       Fully  qualified path or URL to the VM image.  Can also be set to test‐
56       ing, next, or stable to pull down default image.  Defaults to testing.
57
58
59   --memory, -m=number
60       Memory (in MB).
61
62
63   --help
64       Print usage statement.
65
66

EXAMPLES

68              $ podman machine init
69              $ podman machine init myvm
70              $ podman machine init --disk-size 50
71              $ podman machine init --memory=1024 myvm
72
73
74

SEE ALSO

76       podman-machine(1)
77
78

HISTORY

80       March  2021,  Originally  compiled  by   Ashley   Cui   acui@redhat.com
81       ⟨mailto:acui@redhat.com⟩
82
83
84
85                                                      podman-machine-init(1)()