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 |