Importing the QCOW2 Image

You can import the QCOW2 image using either the command line (CLI) or the Proxmox web console (GUI). The CLI method works with all Proxmox versions, while the web console method (GUI) requires Proxmox 9 or later.

To import the QCOW2 image into Proxmox, use one of the following methods:

📘

Note

The CLI method is the recommended and and easiest way to deploy the QCOW2 image.

Importing the QCOW2 Image Using CLI

To import the QCOW2 image using CLI, complete the following steps:

  1. Transfer the downloaded QCOW2 image to the Proxmox server's import directory.
    scp axis-connector-rocky-linux-9-nci-docker-<version>.qcow2 root@<proxmox-host>:/var/lib/vz/import/
  2. On the Proxmox server's terminal, run the following command to create the virtual machine and import the image:
    qm create <VMID> \
      --name <VM Name> \
      --memory 8192 \
      --cores 2 \
      --ostype l26 \
      --cpu cputype=x86-64-v2-AES \
      --scsihw virtio-scsi-pci \
      --scsi0 local-lvm:0,import-from=/var/lib/vz/import/axis-connector-rocky-linux-9-nci-docker-<version>.qcow2 \
      --net0 virtio,bridge=vmbr0 \
      --boot order=scsi0
  3. Run the qm start <VMID> command to start the virtual machine.
  4. Activate the connector. For more information, see Activating the Connector.

Importing the QCOW2 Image Using the Proxmox Web Console

To import the QCOW2 image using the Proxmox web console, complete the following steps:

  1. Transfer the QCOW2 file to the Proxmox server's import directory (/var/lib/vz/import/) using SCP, SFTP, or the Proxmox web console's upload feature.
  2. In the Proxmox web console (https://<proxmox-host>:8006), click Create VM.
  3. Enter a VM ID and name.
  4. In the Processors step, set the CPU type to x86-64-v2-AES.
    📘

    Note

    The connector image requires the x86-64-v2-AES CPU model. The virtual machine will fail to boot if the CPU model is set incorrectly.

  5. Set CPU cores to 2 and Memory to 8192 MB (8 GB).
    📘

    Note

    This is the minimum recommended specification.
    For connectors with higher performance requirements, set the CPU Cores and Memory parameters to a higher value.

  6. Under the Hardware -> Add -> Hard Disk -> Import page, select the QCOW2 file from /var/lib/vz/import/.
  7. Under Network, set the adapter model to VirtIO (virtio) and select the applicable bridge.
  8. Under the Options -> Boot Order page, ensure the imported SCSI disk is listed first.
  9. Click Start to start the virtual machine.
  10. Activate the connector. For more information, see Activating the Connector.