93 lines
2.5 KiB
Groff
93 lines
2.5 KiB
Groff
.nh
|
|
.TH podman-machine-start 1
|
|
.SH NAME
|
|
podman-machine-start \- Start a virtual machine
|
|
|
|
.SH SYNOPSIS
|
|
\fBpodman machine start\fP [\fIname\fP]
|
|
|
|
.SH DESCRIPTION
|
|
Starts a virtual machine for Podman.
|
|
|
|
.PP
|
|
Rootless only.
|
|
|
|
.PP
|
|
Podman on MacOS and Windows 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 must be used to manage MacOS and Windows machines,
|
|
but can be optionally used on Linux.
|
|
|
|
.PP
|
|
The default machine name is \fBpodman-machine-default\fR\&. If a machine name is not specified as an argument,
|
|
then \fBpodman-machine-default\fR will be started.
|
|
|
|
.PP
|
|
Only one Podman managed VM can be active at a time. If a VM is already running,
|
|
\fBpodman machine start\fR returns an error.
|
|
|
|
.PP
|
|
\fBpodman machine start\fP starts a Linux virtual machine where containers are run.
|
|
|
|
.SH OPTIONS
|
|
.SS \fB--help\fP
|
|
Print usage statement.
|
|
|
|
.SS \fB--no-info\fP
|
|
Suppress informational tips.
|
|
|
|
.SS \fB--quiet\fP, \fB-q\fP
|
|
Suppress machine starting status output.
|
|
|
|
.SH EXAMPLES
|
|
Start the specified podman machine.
|
|
|
|
.EX
|
|
$ podman machine start myvm
|
|
Starting machine "myvm"
|
|
This machine is currently configured in rootless mode. If your containers
|
|
require root permissions (e.g. ports < 1024), or if you run into compatibility
|
|
issues with non-podman clients, you can switch using the following command:
|
|
|
|
podman machine set --rootful myvm
|
|
|
|
API forwarding listening on: /var/folders/my/k1kpd8ds7p938mchyb1r_4mw0000gn/T/podman/myvm-api.sock
|
|
|
|
The system helper service is not installed; the default Docker API socket
|
|
address can't be used by podman. If you would like to install it, run the following commands:
|
|
|
|
sudo /opt/homebrew/Cellar/podman/5.2.4/bin/podman-mac-helper install
|
|
podman machine stop myvm; podman machine start myvm
|
|
|
|
You can still connect Docker API clients by setting DOCKER_HOST using the
|
|
following command in your terminal session:
|
|
|
|
export DOCKER_HOST='unix:///var/folders/my/k1kpd8ds7p938mchyb1r_4mw0000gn/T/podman/myvm-api.sock'
|
|
|
|
Machine "myvm" started successfully
|
|
.EE
|
|
|
|
.PP
|
|
Start with --no-info:
|
|
|
|
.EX
|
|
$ podman machine start --no-info myvm
|
|
Starting machine "myvm"
|
|
Machine "myvm" started successfully
|
|
.EE
|
|
|
|
.PP
|
|
Start with --quiet:
|
|
|
|
.EX
|
|
$ podman machine start --quiet myvm
|
|
Machine "myvm" started successfully
|
|
.EE
|
|
|
|
.SH SEE ALSO
|
|
\fBpodman(1)\fP, \fBpodman-machine(1)\fP
|
|
|
|
.SH HISTORY
|
|
March 2021, Originally compiled by Ashley Cui acui@redhat.com
|
|
\[la]mailto:acui@redhat.com\[ra]
|