.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH vmexec-run 1  "run " 
.SH NAME
vmexec\-run \- Run a command in a new virtual machine
.SH SYNOPSIS
\fBvmexec run\fR [\fB\-o\fR|\fB\-\-os\fR] [\fB\-i\fR|\fB\-\-image\fR] [\fB\-e\fR|\fB\-\-env\fR] [\fB\-v\fR|\fB\-\-volume\fR] [\fB\-p\fR|\fB\-\-publish\fR] [\fB\-s\fR|\fB\-\-ssh\-timeout\fR] [\fB\-\-show\-vm\-window\fR] [\fB\-\-pull\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIARGS\fR] 
.SH DESCRIPTION
Run a command in a new virtual machine
.SH OPTIONS
.TP
\fB\-o\fR, \fB\-\-os\fR=\fIOS\fR
Operating system to run
.br

.br
[\fIpossible values: \fRarchlinux]
.TP
\fB\-i\fR, \fB\-\-image\fR=\fIIMAGE\fR
Path to an image
.TP
\fB\-e\fR, \fB\-\-env\fR=\fIENV\fR
Set environment variables for the process inside the virtual machine

Can be provided multiple times.

Expected format: KEY=VALUE
.TP
\fB\-v\fR, \fB\-\-volume\fR=\fIVOLUMES\fR
Bind mount a volume into the virtual machine

Can be provided multiple times.

Expected format: source:dest[:ro]

`ro` can optionally be provided to mark the mount as read\-only.
.TP
\fB\-p\fR, \fB\-\-publish\fR=\fIPUBLISHED_PORTS\fR
Publish a port on the virtual machine to the host

Can be provided multiple times.

Expected format: [[hostip:][hostport]:]vmport

`hostip` is optional and if not provided, the port will be bound on all host IPs.

`hostport` is optional and if not provided, the same value of `vmport` will be used for the host port.

Currently only IPv4 is supported for `hostip`.
.TP
\fB\-s\fR, \fB\-\-ssh\-timeout\fR=\fISSH_TIMEOUT\fR [default: 20]
SSH connection timeout

Try for this long (in seconds) to connect to the virtual machine\*(Aqs SSH server.
.TP
\fB\-\-show\-vm\-window\fR
Show a window with the virtual machine running in it

This is mostly useful for debugging boot failures.
.TP
\fB\-\-pull\fR=\fIPULL\fR [default: missing]
When to pull a new image
.br

.br
[\fIpossible values: \fRmissing, never, newer]
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help (see a summary with \*(Aq\-h\*(Aq)
.TP
[\fIARGS\fR]
Arguments to run in the virtual machine