{{Header}} {{hide_all_banners}} {{Title|
title={{project_name_long}} for KVM
}}{{#seo:
|description={{project_name_short}} for KVM
|image=Download-kvm.jpg
}}
{{Contributor|
|status=stable
|about=About this {{PAGENAME}} Page
|difficulty=medium
|contributor=[https://forums.{{project_clearnet}}/users/hulahoop HulaHoop]
|support=[[KVM/Support|Community support only!]]
}}
[[File:Download-kvm.jpg|<code>unofficial logo re-design for the [https://www.linux-kvm.org KVM] virtualizer + Kicksecure</code>|thumb]]
{{intro|
This is the KVM flavor of the {{project_name_short}} project.
}}
{{Community_Support|scope=page}}
= Introduction =
Much of the warnings and use case instructions from the {{project_name_short}} edition, such as running the OS [[KVM#Command_Line_Interface_.28CLI.29|headlessly]] or using [[KVM#Shared_Folders|shared folders]], are applicable.

For more details about {{project_name_short}}, check [[About|{{project_name_short}}]] [[About|pages]].

Support tickets should be forwarded to the [https://forums.{{project_clearnet}}/c/kvm KVM subforum].

= Build from Scratch =

Advanced users are encouraged to [[Dev/Build_Documentation|build]] {{project_name_short}} images for high security assurance.

= Download {{project_name_short}} =

<!-- Extra terms of service notice because KVM has no VM import dialog which could present TOS. -->
{{tos}}

'''{{free}}'''

{{Tab
|type=controller
|content=

<!-- ────────────────  SECTION 1  ──────────────── -->
{{Tab
|active=true
|title= == GUI ==
|image=[[File:Clipart-gui.svg|alt=Symbol representing GUI]]
|content=

 {{Tab                      <!-- nested controller -->
 |type=controller
 |addToClass=margin-top-10
 |content=

   {{Tab
   |active=true
   |title= === stable Xfce ===
   |image=[[File:Rg1024_brick_tile.png]]
   |content=
       {{DownloadTableUnified
           |project_name={{project_name_short}}
           |os_keyword=kvm
           |os_name=KVM
           |version_type=stable
           |flavor=Xfce
           |after_slash=libvirt
           |extension=Intel_AMD64.qcow2.libvirt.xz
           |version={{Version_KVM}}
       }} <!-- close DownloadTableUnified -->
   }} <!-- close tab -->

   {{Tab
   |title= === testers Xfce ===
   |image=[[File:Cornues.png]]
   |content=
       {{DownloadTableUnified
           |project_name={{project_name_short}}
           |os_keyword=kvm
           |os_name=KVM
           |version_type=testers
           |flavor=Xfce
           |after_slash=libvirt
           |extension=Intel_AMD64.qcow2.libvirt.xz
           |version={{VersionTesters}}
       }} <!-- close DownloadTableUnified -->    }} <!-- close tab -->

 }} <!-- close nested controller -->

}} <!-- close tab: Section 1 -->

<!-- ────────────────  SECTION 2  ──────────────── -->
{{Tab
|title= == CLI ==
|image=[[File:Utilities-terminal.png|alt=Symbol representing CLI|50px]]
|content=

 {{Tab                      <!-- nested controller -->
 |type=controller
 |addToClass=margin-top-10
 |content=

   {{Tab
   |active=true
   |title= === stable CLI ===
   |image=[[File:Rg1024_brick_tile.png]]
   |content=
       {{DownloadTableUnified
           |project_name={{project_name_short}}
           |os_keyword=kvm
           |os_name=KVM
           |version_type=stable
           |flavor=CLI
           |after_slash=libvirt
           |extension=Intel_AMD64.qcow2.libvirt.xz
           |version={{Version_KVM}}
       }} <!-- close DownloadTableUnified -->    }} <!-- close tab -->

   {{Tab
   |title= === testers CLI ===
   |image=[[File:Cornues.png]]
   |content=
       {{DownloadTableUnified
           |project_name={{project_name_short}}
           |os_keyword=kvm
           |os_name=KVM
           |version_type=testers
           |flavor=CLI
           |after_slash=libvirt
           |extension=Intel_AMD64.qcow2.libvirt.xz
           |version={{VersionTesters}}
       }} <!-- close DownloadTableUnified -->
   }} <!-- close tab -->
 }} <!-- close nested controller -->

}} <!-- close tab: Section 2 -->

}} <!-- close top‑level controller -->

{{mbox
|icon=fa-solid fa-exclamation cs-red
|addToClass=cs-yellow-light
|text=
'''Note:''' Save your download to your usual <code>~/Downloads</code> folder.
}} <!-- End mbox -->

= Decompress =

Use {{Code2|tar}} to decompress the archive.

{{CodeSelect|code=
tar -xvf Kicksecure*.libvirt.xz
}}

Do not use {{Code2|unxz}}! Extract the images using {{Code2|tar}}.

= Importing {{project_name_short}} VM Template =

The supplied XML files serve as a description for libvirt and define the properties of a {{project_name_short}} VM and the networking it should have.
{{Box|text=
'''1.''' {{project_name_short}} works with the network named ''default'' out of the box.

'''2.''' Import the {{project_name_short}} image.

{{CodeSelect|code=
virsh -c qemu:///system define Kicksecure*.xml
}}
}}

= Moving the {{project_name_short}} Image File =

The XML files are configured to point to the default storage location of <code>/var/lib/libvirt/images</code>. The following steps move the images there so the machines can boot.

<u>Note:</u> Changing the default location may cause conflicts with SELinux, which will prevent the machines from booting.

It is recommended to move the image file instead of copying it.

{{CodeSelect|code=
sudo mv Kicksecure*.qcow2 /var/lib/libvirt/images/Kicksecure.qcow2
}}

{{Anchor|sparse files}}

== Shared Folders ==
See {{whonix_wiki
|wikipage=KVM#Shared_Folders
|text=KVM, Shared_Folders
}}.

= Footnotes =
{{reflist|close=1}}

{{Footer}}

[[Category:Documentation]]