1podman-machine(1)           General Commands Manual          podman-machine(1)
2
3
4

NAME

6       podman-machine - Manage Podman's virtual machine
7
8

SYNOPSIS

10       podman machine subcommand
11
12

DESCRIPTION

14       podman machine is a set of subcommands that manage Podman's virtual ma‐
15       chine.
16
17
18       Podman on MacOS and Windows requires a virtual machine. This is because
19       containers  are  Linux  - containers do not run on any other OS because
20       containers' core functionality are tied to the Linux kernel. Podman ma‐
21       chine must be used to manage MacOS and Windows machines, but can be op‐
22       tionally used on Linux.
23
24
25       All podman machine commands are rootless only.
26
27
28       NOTE: The  podman-machine  configuration  file  is  managed  under  the
29       $XDG_CONFIG_HOME/containers/podman/machine/   directory.  Changing  the
30       $XDG_CONFIG_HOME environment variable while the  machines  are  running
31       can lead to unexpected behavior.
32
33

SUBCOMMANDS

35       ┌────────┬───────────────────────────┬───────────────────────────────┐
36       │Command │ Man Page                  │ Description                   │
37       ├────────┼───────────────────────────┼───────────────────────────────┤
38       │info    │ podman-machine-info(1)    │ Display machine host info     │
39       ├────────┼───────────────────────────┼───────────────────────────────┤
40       │init    │ podman-machine-init(1)    │ Initialize  a new virtual ma‐ │
41       │        │                           │ chine                         │
42       ├────────┼───────────────────────────┼───────────────────────────────┤
43       │inspect │ podman-machine-inspect(1) │ Inspect one or  more  virtual │
44       │        │                           │ machines                      │
45       ├────────┼───────────────────────────┼───────────────────────────────┤
46       │list    │ podman-machine-list(1)    │ List virtual machines         │
47       ├────────┼───────────────────────────┼───────────────────────────────┤
48       │os      │ podman-machine-os(1)      │ Manage  a  Podman virtual ma‐ │
49       │        │                           │ chine's OS                    │
50       ├────────┼───────────────────────────┼───────────────────────────────┤
51       │rm      │ podman-machine-rm(1)      │ Remove a virtual machine      │
52       ├────────┼───────────────────────────┼───────────────────────────────┤
53       │set     │ podman-machine-set(1)     │ Set a virtual machine setting │
54       ├────────┼───────────────────────────┼───────────────────────────────┤
55       │ssh     │ podman-machine-ssh(1)     │ SSH into a virtual machine    │
56       ├────────┼───────────────────────────┼───────────────────────────────┤
57       │start   │ podman-machine-start(1)   │ Start a virtual machine       │
58       ├────────┼───────────────────────────┼───────────────────────────────┤
59       │stop    │ podman-machine-stop(1)    │ Stop a virtual machine        │
60       └────────┴───────────────────────────┴───────────────────────────────┘
61

SEE ALSO

63       podman(1), podman-machine-info(1),  podman-machine-init(1),  podman-ma‐
64       chine-list(1),  podman-machine-os(1),  podman-machine-rm(1), podman-ma‐
65       chine-ssh(1), podman-machine-start(1), podman-machine-stop(1),  podman-
66       machine-inspect(1)
67
68

HISTORY

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