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

OPTIONS

29   --cpus=number
30       Number of CPUs.
31
32
33   --disk-size=number
34       Size of the disk for the guest VM in GB.
35
36
37   --ignition-path
38       Fully qualified path of the ignition file.
39
40
41       If an ignition file is provided, the  file  will  be  copied  into  the
42       user's  CONF_DIR and renamed.  Additionally, no SSH keys will be gener‐
43       ated nor will a system connection be made.  It is assumed that the user
44       will do these things manually or handle otherwise.
45
46
47   --image-path
48       Fully qualified path of the uncompressed image file
49
50
51   --memory, -m=number
52       Memory (in MB).
53
54
55   --help
56       Print usage statement.
57
58

EXAMPLES

60              $ podman machine init myvm
61              $ podman machine init --device=/dev/xvdc:rw myvm
62              $ podman machine init --memory=1024 myvm
63
64
65

SEE ALSO

67       podman-machine (1)
68
69

HISTORY

71       March   2021,   Originally   compiled  by  Ashley  Cui  acui@redhat.com
72       ⟨mailto:acui@redhat.com⟩
73
74
75
76                                                      podman-machine-init(1)()