Import QCOW2 Image Into Proxmox

Introduction

Some OSes, and firewalls or network appliances are shipped only in QCOW2 format.

For those wondering, QCOW, stands for QEMU copy-on-write, is the default storage format for virtual disks of QEMU/KVM instances.

Using the QCOW2 images, we can instantly create and run new virtual machines with hypervisor.

Step 1: Create a Directory to Store QCOW2 Images

First, we need to create a directory to store the QCOW2 images. I am going to create a directory called "qcow" under the Proxmox default storage directory.

Please note that you can save the images on any location of your choice.

Step 2: Copy the QCOW2 Images to Proxmox Storage Directory

Download and copy the QCOW2 image to the directory that you created earlier. For the purpose of this guide, I will be using FreeBSD 12.3 QCOW2 image file.

You can verify if the image is really copied or not.

Sample Output:

Step 3: Create a VM Without OS

Log in to the Proxmox Web UI dashboard by navigating to https://ip-address:8006 URL.

Right click on your Proxmox node and click Create VM option from the context menu.

Enter the name of the VM. Also make a note of the VM ID (i.e. 107 in my case). The ID will be auto-created based on the existing number of available VMs. We are going to need the VM ID when we attach the QCOW2 image to the VM. Click OK to continue.

Next choose "Do not use any media" option. Because we already have a pre-installed OS in the QCOW2 image, right? Yes! Also choose the guest type and version. There is no entry for Unix guest OS in Proxmox, so I simply selected "Other". If you use import a Linux Qcow2 image, choose guest type as "Linux" and Kernel as "6.x-2.6 Kernel".

Choose the graphics card, firmware and SCSI controller settings for your VM. usually, the default values are sufficient. I will go with default values.

Enter the size for the virtual machine's disk. Here, I will keep the default size i.e. 32 GB. Also make sure you've chosen the disk format as "QEMU image format" as shown in the following screenshot.

Enter the CPU details such as the number of sockets and cores.

Enter the RAM size for your VM. here, I have given 2 GB.

Enter network details. Mostly the default settings will work just fine. If you wish to change the network settings (E.g. enable or disable firewall), do it as you wish.

You will see the summary of the VM's settings. Review them and if you're OK with it, click Finish to create the VM. Or click "Back" button and change the settings as you wish.

We just created a VM without OS. It is time to attach the QCOW2 image to the VM.

Step 4: Import QCOW2 Image into Proxmox Server

Before importing the QCOW2 into your Proxmox server, make sure you've the following details in hand.

1. Virtual machine's ID,

2. Proxmox storage name,

3. Location of the Proxmox QCOW2 image file.

4. If you don't have them or don't know where to find them, just open your Proxmox web UI dashboard. On the left pane, you will see the virtual machine's IDs and the storage name.

Here, my FreeBSD 12 VM id is "107" and Proxmox storage name is "local". And the directory path where I saved the QCOW2 image is /var/lib/vz/template/qcow/ (Please refer Step 2.).

Change into the /var/lib/vz/template/qcow/ directory:

Now, import the QCOW2 image into the Proxmox server using command:

Replace the VM id (107) and storage name (local) with your own.

Sample Output:

We imported the virtual disk to Proxmox. Now go back to the Proxmox web UI dashboard and attach the virtual disk to the VM.

Step 5: Attach QCOW2 Virtual Disk to VM

Click on the Virtual machine that you created in step 3. In my case, it is FreeBSD 12 VM. Select "Hardware" tab. On the right hand side, you will the newly imported QCOW2 disk as unused disk. Select the unused disk and then click "Edit" button.

Choose the bus type as "VirtIO Block" to get best disk I/O performance and hit "Add" button.

You will now see a newly disk with VirtIO as bus type has been attached to the VM.

Great! We successfully attached a new disk to the Proxmox VM.

Step 6: Change the Boot Order

To make the VM to boot from the newly added disk, we must change the boot order.

Select Virtual machine -> Options -> Boot Order.

To boot from the new disk, it must be on top in the boot order window. Select the newly added VirtIO disk and drag it to the top. Make sure you checked the tick box to enable the disk. Click "OK" to save.

Now start the virtual machine. It should boot from the new disk.