Installing Fedora Server Edition as a Virtual Machine using Proxmox Virtual Environment
This document outlines a method for installing Fedora Server from the qcow2 image as a virtual machine in the Proxmox Virtual Environment, henceforth simply Proxmox. VMs can be spun up very quickly after importing the disk image, saving much time and frustration. The setup used when writing this document may not match what yours, so certain details like file paths for the disk images may vary.
Why Fedora Server on Proxmox
Proxmox is an open source server virtualization management solution based on QEMU/KVM and LXC with a web interface for managing most aspects of the VM workflow. It is also popular with homelab enthusiasts. The Fedora Server disk image shortcuts the provisioning process by providing a pre-installed disk image that boots straight into the final setup menu. You can have a fresh Fedora Server VM provisioned in just a couple of minutes using this method.
Brief summary for experienced Proxmox users
Here are the key details if you’re already familiar with creating virtual machines in Proxmox.
-
The VM does not need installation media (ISO) mounted.
-
The VM must be in BIOS mode (SeaBIOS) with a VirtIO SCSI Single controller. Be sure to enable the Qemu Agent if you plan on using it.
-
This document omits the initial disk creation because we import the disk image later in the process.
-
qm disk import [vm_number] [image_name.qcow2] [target_storage] --format qcow2
-
-
You must attach the disk and ensure it is selected in the boot order under
options
for the VM before you try to boot the system.
Procedure
Note: This document assumes that you have ssh access to a Proxmox node and that you have already downloaded the Fedora Server qcow2 disk image. It also assumes centralized storage on an NFS mount, but your storage configuration may differ if you use local LVM storage or Ceph. We provided screenshots for each step of the VM configuration process, but the overall procedure comes from the Proxmox Wiki.
Locate the image file and upload it to Proxmox
Before we create the VM, we will need to find and upload our disk image to the Proxmox node. In the screenshot below you can see that we explored the system to determine that it is using centralized NFS storage mounted at /mnt/pve/nfs-kraken, and we made a directory at some point called osimages to contain our disk images.
Once we sorted out the path, we uploaded the file via scp into the Proxmox node. scp [image_filename] root@[node_name]:/path/to/images/[image_filename]
Verify the image is in place
While not completely necessary, we logged back in to the Proxmox node and verified that the file had actually uploaded to the target directory. We’ll come back to this path later when it is time to import the disk image to a VM.
VM Creation: General
Click on the Create VM
button in the Proxmox UI, and the VM creation wizard should start. Select a node and give the VM a name. Note the VM ID. We will need this later. Click Next
.
VM Creation: OS
We will not need to use an ISO to install the system, so change the radio button to Do not use any media
and click Next
.
VM Creation: System
We get a handful of options to play with on this screen.
-
The
Machine
is whatever you prefer.q35
presents hardware in the PCIe topology, whilei440fx
will give you the older PCI topology. -
The
BIOS
option needs to beSeaBIOS
because the disk image will not boot underUEFI
. -
The
SCSI Controller
option should be set asVirtIO SCSI Single
. The default optionLSI 53C895A
would not boot the disk image. -
Also, remember to enable the
Qemu Agent
option if you intend to use it. You can safely enable this option if you are unsure.
Click Next
.
VM Creation: Disks
Click the little trash can to the left of the disk it pre-populates for you. We will be importing the disk image as our primary disk. Click Next
.
VM Creation: CPU
Set the CPU settings as you need them. The test cluster used when writing this documentation had identical processors across the cluster, so host
was safe to use while still enabling live migration. Click Next
.
VM Creation: Network
Select the network details. The test article had an Open vSwitch configured with VLAN port groups. VirtIO (paravirtualized)
should yield the best performance. Click Next
.
VM Creation: Confirm
The wizard should end with a summary of the hardware settings. Click Finish
to create the VM.
VM Disk Import
Now that the VM itself has been built, we need to log in to the Proxmox node via the console feature or via SSH to import the disk image we uploaded earlier.
-
Log in to the Proxmox node
-
Navigate to the directory where you uploaded the disk image earlier.
-
This test article has storage mounted at /mnt/pve/nfs-kraken/osimages/, but your path will be different.
-
-
Use the qm disk import command to import your disk image.
-
qm disk import [vm_number] [image_name.qcow2] [target_storage] --format qcow2
-
[vm_number] is the vm number of the vm you just created in the previous steps.
-
[image_name.qcow2] is the file name of your Fedora Server image that you uploaded earlier.
-
[target_storage] is the storage volume where you want the disk image for the vm stored. For this test article, I told Proxmox to continue using a volume named
nfs-kraken
. -
The format may vary depending on where you are storing the VM. The test articule uses an NFS mount, and qcow2 formatted images are preferred in this usage scenario.
-
-
When the import process finishes you should get a success message like the one show in the image below. This process was done on a storage array with rotational hard disks, and it still only took a few seconds to complete.
VM Configuration: Disk
Now that the disk is part of the VM, we can go back to the hardware tab, highlight the new unused disk, and click edit. You shouldn’t need to change anything and can safely just click Add
.
VM Configuration: Boot Order
The final step before powering on the VM is to navigate to the VM’s Options
tab, click on Boot Order
, and ensure that the imported disk, typically scsi0
, is selected for boot. Note that in the following screenshot, the other boot options are disabled and scsi0
is moved to the top of the list.
VM Console: First Boot
Now we’re ready open up the console and boot the VM for the first time. You should see the normal GRUB boot loader and kernel messages stream across the console until you are presented with the final setup menu.
End Result
After you complete this process the VM is running just as if you had booted off of the ISO and went through the full server install process, only now it only takes a fraction of the time!
Next Steps
Be sure to check out the tasks in the general post-installation guide for virtual machines as well.
Want to help? Learn how to contribute to Fedora Docs ›