How to Install Xpenology on a Linux KVM/QEMU Virtual Machine!

  • Post author:WunderTech
  • Post published:June 13, 2020
  • Post last modified:November 2, 2022
  • Post category:Xpenology
  • Reading time:16 mins read

Share what you're reading!

In this tutorial, we will look at how to install Xpenology on KVM, a Linux based hypervisor.

Running Xpenology on a KVM virtual machine is a great way to have a fully functioning NAS without dedicating an entire machine to the operating system. After looking at how to install Xpenology on KVM, check out some of our tutorials on different ways to use DSM!

The process is fairly straight forward, but there are a few prerequisites that I want to point out:


  • You must be running a 64-bit version of Linux with virtualization turned on in your systems BIOS settings.
  • You must be running a processor that is the Haswell generation or newer. I have set this up on an AMD Ryzen 5 1600 and a Core i7 5600U (for testing), and they both run great. If you do not have a Haswell generation or newer processor, you will never be able to find your “Synology” when trying to connect.
  • For older hardware, please use one of the older loaders which requires an older version of Synology DSM. This thread explains the minimum requirements: NOTE: You will need to use a different MAC address based on which loader you use.

A few helpful notes before we get started…

  • If you are using the correct processor (and loader) but cannot find your “Synology”, either your MAC address is different than written in this guide or you are using incorrect NIC settings.
  • If you get to the stage of installing the operating system and the installation fails, check to ensure that the boot drive is set as SATA. If it wasn’t, you might need to generate a new QCOW2 image file.
  • Outside of installing KVM/QEMU, I installed the UEFI firmware which can be installed by using the command below. I am not certain that this is required, but if you run into any issues, it can’t hurt to install them.
sudo apt install -y virt-manager qemu-efi
  • The most important point: Xpenology is a home-brewed version of Synology’s DSM. It is suggested that you use this for testing purposes or you backup your important files regularly (which should be done regardless). Xpenology has a great developer community, but there is no true “support”, and no guarantee that this operating system will be stable. I personally own a DS1019+ which is used as my production NAS and use Xpenology for testing purposes only. Use at your own risk.
  • Do NOT update Xpenology without ensuring that the new version works with the existing bootloader. Incremental updates are generally fine, but major version updates may require a new or updated bootloader.

How to Install Xpenology on KVM – Instructions

1. Download Jun’s Loader (v1.04b DS918+) from here.

2. After the download is complete, extract the files and place the synoboot.img file in the location of your choosing. For this tutorial, I will place it in my “Documents” folder.

3. When the file is in the folder of your choosing, navigate there and run the command below to convert the image into a QCOW2 image. This is the image file that we will import into the Virtual Machine Manager.

qemu-img convert -f raw -O qcow2 synoboot.img syno-ds918-qcow2.img
qemu image conversion

4. After the image has been created, create a new Virtual Machine in Virtual Machine Manager. In step one, select “Import existing disk image”.

kvm import qemu file

5. At the second step, select “Browse” and select the QCOW2 image file that we created in step three. For OS type, select “Linux” and for the version, select “ALT Linux 2.4”. I am not certain that these settings are mandatory, but I know that it works using these settings.

create virtual machine

6. Specify the Memory (RAM) and CPUs you would like allocated to this virtual machine.

system memory and cpu's

7. At the final step, give your Virtual Machine a name, select “Customize configuration before install” and select “Finish”.

VM name

8. When customizing the virtual machine before installation, there are a few very important changes that we need to make. First, change the CPU to “kvm64” and apply.

CPU changes in kvm

9. Under IDE Disk 1 (the default hard drive), change the “Disk bus” to “SATA” under the advanced options and apply.

hard disk changes in kvm

10. Select “Add Hardware” in the bottom and add a new SATA drive that is 16GB. You can realistically make this as large as you’d like, but I create a volume using this virtual disk and use the space for app installations.

storage addition in kvm

11. Under the “NIC” settings, change the “Network source” to “Host device macvtap”. Under the “Device model”, change the setting to “e1000”. Enter the MAC address as “00:11:32:12:34:56” and apply. NOTE: you MUST use a wired ethernet connection for this step. Wireless cards will not work. The settings above are also VERY important, as you will be unable to find your “Synology” in later steps with an incorrect MAC address or NIC configuration.

NIC changes

12. Under the “Boot Options”, change the Boot device to “SATA Disk 1”. You can also check off “Start virtual machine on host boot up” if you’d like this virtual machine to start when the operating system initially starts.

boot order in kvm

13. With all of these settings configured, you can now select “Begin installation”. The loader will now boot.

final install

14. We must now download the DSM version that we will be installing. Click here to download DSM 6.2.3 for the DS918+ (the version of our bootloader). If you would rather install an older version (6.2.1, 6.2.2), you can use this link to download the file. NOTE: Download the “.pat” file, not the “.pat.md5”.

15. After the DSM version is downloaded and a few minutes have now passed, you should be able to find your Synology. Navigate to the website and wait for your device to be found. DHCP will give your DiskStation an IP address and you will be able to see the MAC address listed as we configured in step 11. Select “Connect”.

dsm connection

16. Accept the End User License Agreement and select “Set Up”.

dsm setup

17. We will now install DSM. Select “Manual Install”.

dsm installation

18. Browse to the file we downloaded in step 14 which is the DSM operating system. After selecting the file, “Install Now”.

operating system selection

19. You will be prompted informing you that all data on hard disk(s) 1 and 2 will be removed. The data that this is referring to is the QCOW2 image that we created and the 16GB virtual hard drive. Check the “I understand” box and press “OK”.

hard disk format for existing drives

20. DSM will now install. The installation process can take upwards of 10 minutes and will reboot the “Synology” when complete.

dsm installation progress

21. After a few minutes have passed, open a new tab and navigate to Your DiskStation should show up and you will be able to connect.

dsm connection after installation

22. Give your DiskStation a Server Name, Username and Password.

name and account creation

23. The next step will ask you to setup QuickConnect. DO NOT CREATE AN ACCOUNT. Select “Skip this step” at the bottom of the screen. You will be prompted that you’ll need to set up port forwarding to connect. Select “yes”.

quickconnect setup

24. Final step is to select “Go”!

dsm final installation notice

25. Xpenology is now installed. From here, you will need to configure your volumes, storage pools, and everything else involved with configuring DSM from scratch. The setup is now technically complete, but I have added a few helpful tips below. The first will show you how to change the QCOW2 drive from SATA to USB (so it doesn’t show up in DSM). I will also show you how to pass physical hard drives to the NAS so that they can be added to storage pools as a raid array.

dsm operating system

Continued Configuration

1. When installing DSM, we had to set the QCOW2 image we created as a SATA drive. Without doing this step, the DSM installation will fail. However, after installing DSM, you will notice that this drive is passed to the operating system and will show under the “HDD/SSD” section of the storage manager.

hard disk page in dsm

2. If you’d like to remove this drive from showing up, shut down the Xpenology OS that we just created and navigate to the KVM settings. Under the “SATA Disk 1” settings, change the “Disk bus” to “USB” and apply. This setting will stop DSM from listing this as a drive.

kvm disk changes

3. Ensure that the “Boot Options” now has the “USB Disk 1” as the first boot option.

kvm start vm at boot

4. We will now need to pass physical drives to our Xpenology so that we can create a raid array. In order to do this, we will need to find the drives name which can be done using the GUI or by running a command in the terminal. This is the command that needs to be run to get the drives names.


5. The second option is by using a great tool called GParted. If you don’t have GParted, you can install it by running this command:

sudo apt install gparted

6. Open GParted, and switch to the physical Hard Drive in the top right that you would like passed to Xpenology. The important thing that we are looking for is the name. In my case, I will be passing “/dev/sdb” to Xpenology.

gparted main menu

7. Navigate back to the virtual machine’s settings and select “Add Hardware”. Under Storage, enter the name found in the step above. Change the “Bus type” to “SATA” and click “Finish”. The drive will now be passed to Xpenology. Do this for all of the physical drives you have that you would like passed to Xpenology. You will now be able to create raid arrays using these drives. NOTE: When you pass these drives to Xpenology and create a storage pool, ALL DATA WILL BE ERASED. Ensure that no important data exists on these drives before proceeding.

adding additional storage in kvm

Screenshot with drive added and boot drive set as USB:

synology dsm hdd menu in storage manager


This concludes the tutorial on how to install Xpenology on KVM. This is a pretty long process, but somewhat straight forward if you follow the instructions above. The biggest issues you may run into are hardware related, but the instructions above should guide you along the process as easily as possible.

If you’ve just finished setting up Xpenology, check out our tutorial on how to setup DDNS! If you have any questions on how to install Xpenology on KVM, please leave them in the comments!