vmexec-run(1)               General Commands Manual              vmexec-run(1)

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

                                     run                         vmexec-run(1)