---
name: "vmexec-pull"
section: "1"
platform: "linux"
package: "vmexec"
version: "0.8.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/vmexec-pull"
---

# vmexec-pull(1)

Pull an image without running a virtual machine

## NAME

vmexec-pull - Pull an image without running a virtual machine

## SYNOPSIS

**vmexec pull** \[**--prepare**\] \[**--disable-kvm**\] \[**-m**\|**--memory**\] \[**--show-vm-window**\] \[**-s**\|**--ssh-timeout**\] \[**-h**\|**--help**\] \<*OS\_TYPE*\>

## DESCRIPTION

Pull an image without running a virtual machine

## OPTIONS

- **--prepare**

  Additionally prepare the image so that the first run is fast

  This extracts the kernel, creates the overlay image and performs the warmup boot that would otherwise happen on the first run.

- **--disable-kvm**

  Run the warmup virtual machine with TCG instead of KVM

  This would be mostly useful in environments where KVM is not available. It will be a lot slower but might be acceptable in some contexts.

- **-m**, **--memory** *\<MEMORY\>*

  Memory limit for the warmup virtual machine in GBs

  Must be an integer of at least 1.

  If not provided, all available host memory is used.

- **--show-vm-window**

  Show a QEMU window with the warmup virtual machine running in it

  This is mostly useful for debugging boot failures.

- **-s**, **--ssh-timeout** *\<SSH\_TIMEOUT\>* \[default: 20\]

  SSH connection timeout during warmup

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

- **-h**, **--help**

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

- \<*OS\_TYPE*\>

  The operating system image to pull\

  *Possible values:*

  - •

    archlinux: Arch Linux (images come from \<https://gitlab.archlinux.org/archlinux/arch-boxes\>)