NAME

vmexec-run - Run a command in a new virtual machine

SYNOPSIS

vmexec run [-o|--os] [-i|--image] [-e|--env] [-v|--volume] [-p|--publish] [-s|--ssh-timeout] [--show-vm-window] [--pull] [-h|--help] [ARGS]

DESCRIPTION

Run a command in a new virtual machine

OPTIONS

-o, --os=OS

Operating system to run

[possible values: archlinux]

-i, --image=IMAGE

Path to an image

-e, --env=ENV

Set environment variables for the process inside the virtual machine

Can be provided multiple times.

Expected format: KEY=VALUE

-v, --volume=VOLUMES

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.

-p, --publish=PUBLISHED_PORTS

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`.

-s, --ssh-timeout=SSH_TIMEOUT [default: 20]

SSH connection timeout

Try for this long (in seconds) to connect to the virtual machine's SSH server.

--show-vm-window

Show a window with the virtual machine running in it

This is mostly useful for debugging boot failures.

--pull=PULL [default: missing]

When to pull a new image

[possible values: missing, never, newer]

-h, --help

Print help (see a summary with '-h')

[ARGS]

Arguments to run in the virtual machine