qubes-doc/user/hardware/hcl.md

---
lang: en
layout: doc
permalink: /doc/hcl/
redirect_from:
- /en/doc/hcl/
- /doc/HCL/
- /wiki/HCL/
- /wiki/HCLR1/
- /wiki/HCL-R2B2/
ref: 146
title: Hardware compatibility list (HCL)
---

The [HCL](/hcl) is a compilation of reports generated and submitted by users across various Qubes versions about their hardware's compatibility with Qubes.

 **Note:**
 Except in the case of developer-reported entries, the Qubes team has not independently verified the accuracy of these reports.
 Please first consult the data sheets (CPU, chipset, motherboard) prior to buying new hardware for Qubes.
 Make sure it meets the [System Requirements](/doc/system-requirements/) and search in particular for support of:

-   HVM ("AMD virtualization (AMD-V)", "Intel virtualization (VT-x)", "VIA virtualization (VIA VT)")
-   IOMMU ("AMD I/O Virtualization Technology (AMD-Vi)", "Intel Virtualization Technology for Directed I/O (VT-d)")
-   TPM ("Trusted Platform Module (TPM)" connected to a "20-pin TPM header" on motherboards.)

If using the list to make a purchasing decision, we recommend that you choose hardware with:

-   the best achievable Qubes security level (green columns in HVM, IOMMU, TPM)
-   and general machine compatibility (green columns in Qubes version, dom0 kernel, remarks).

Also see [Certified Hardware](/doc/certified-hardware/) and [Hardware Testing](/doc/hardware-testing/).

Generating and Submitting New Reports
-------------------------------------

In order to generate an HCL report in Qubes, simply open a terminal in dom0 (KDE: start-menu -\> System Tools -\> Konsole or Terminal Emulator)
and run `qubes-hcl-report <vm-name>`, where `<vm-name>` is the name of the VM to which the generated HCL files will be saved.
(Note: If you are working with a new Qubes installation, you may need to update your system in order to download this script.)

You are encouraged to submit your HCL report for the benefit of further Qubes development and other users.
When submitting reports, test the hardware yourself, if possible.
If you would like to submit your HCL report, please send the **HCL Info** `.yml` file to [\`qubes-users@googlegroups.com\`](/support/#qubes-users) with the subject `HCL - <your machine model name>`. Alternatively you can also create a post in the [HCL Reports category](https://forum.qubes-os.org/c/user-support/hcl-reports/23) of the forum.
Please include any useful information about any Qubes features you may have tested (see the legend below), as well as general machine compatibility (video, networking, sleep, etc.).
Please consider sending the **HCL Support Files** `.cpio.gz` file as well. To generate these add the `-s` or `--support` command line option.

**Please note:**
 The **HCL Support Files** may contain numerous hardware details, including serial numbers. If, for privacy or security reasons, you do not wish to make this information public, please **do not** send the `.cpio.gz` file to the public mailing list.
HCL changed Initial version 2012-05-02 06:44:45 -04:00			`---`
Add lang + ref tags to frontmatter Those are fields used by the language switcher to correlate pages across different languages, even if they have different names/paths/titles. They are generated with the prepare_for_translation.py script. 2021-03-13 13:06:18 -05:00			`lang: en`
wiki -> doc migration 2015-04-10 16:17:45 -04:00			`layout: doc`
Revert "Remove all instances of `permalink:` in YAML frontmatter" This reverts commit c815e4c54c315dfca30c66f6a33e07b1ff90b786. https://github.com/QubesOS/qubes-issues/issues/6701#issuecomment-862822827 2021-06-16 22:56:25 -04:00			`permalink: /doc/hcl/`
HCL cleanup, fixing links 2015-05-09 08:59:07 -04:00			`redirect_from:`
Remove en/ from URLs (QubesOS/qubes-issues#1333) 2015-10-28 18:14:40 -04:00			`- /en/doc/hcl/`
Change URIs from CamelCase to lowercase-hyphen-separated 2015-10-11 03:04:59 -04:00			`- /doc/HCL/`
HCL cleanup, fixing links 2015-05-09 08:59:07 -04:00			`- /wiki/HCL/`
			`- /wiki/HCLR1/`
			`- /wiki/HCL-R2B2/`
Add lang + ref tags to frontmatter Those are fields used by the language switcher to correlate pages across different languages, even if they have different names/paths/titles. They are generated with the prepare_for_translation.py script. 2021-03-13 13:06:18 -05:00			`ref: 146`
Fix capitalization; update terms (QubesOS/qubes-issues#6769) Thank you to @unman for the initial sentence case pass. 2021-07-09 08:10:44 -04:00			`title: Hardware compatibility list (HCL)`
HCL changed Initial version 2012-05-02 06:44:45 -04:00			`---`

Small Edit to hcl.md * Expanded Introduction * Finished unfinished sentences * Moved some sentences 2017-04-19 14:09:28 -04:00			`The [HCL](/hcl) is a compilation of reports generated and submitted by users across various Qubes versions about their hardware's compatibility with Qubes.`

HCL changed minor changes and rearranging, splitting Apple BIOS Version string, TPM 2014-09-24 16:34:12 -04:00			`Note:`
			`Except in the case of developer-reported entries, the Qubes team has not independently verified the accuracy of these reports.`
			`Please first consult the data sheets (CPU, chipset, motherboard) prior to buying new hardware for Qubes.`
Small Edit to hcl.md * Expanded Introduction * Finished unfinished sentences * Moved some sentences 2017-04-19 14:09:28 -04:00			`Make sure it meets the [System Requirements](/doc/system-requirements/) and search in particular for support of:`
HCL changed minor changes and rearranging, splitting Apple BIOS Version string, TPM 2014-09-24 16:34:12 -04:00
			`- HVM ("AMD virtualization (AMD-V)", "Intel virtualization (VT-x)", "VIA virtualization (VIA VT)")`
			`- IOMMU ("AMD I/O Virtualization Technology (AMD-Vi)", "Intel Virtualization Technology for Directed I/O (VT-d)")`
			`- TPM ("Trusted Platform Module (TPM)" connected to a "20-pin TPM header" on motherboards.)`

Small Edit to hcl.md * Expanded Introduction * Finished unfinished sentences * Moved some sentences 2017-04-19 14:09:28 -04:00			`If using the list to make a purchasing decision, we recommend that you choose hardware with:`
HCL changed minor changes and rearranging, splitting Apple BIOS Version string, TPM 2014-09-24 16:34:12 -04:00
			`- the best achievable Qubes security level (green columns in HVM, IOMMU, TPM)`
			`- and general machine compatibility (green columns in Qubes version, dom0 kernel, remarks).`
HCL changed Link to the old HCL 2013-12-14 03:27:25 -05:00
Refactor links in order to obey the new convention rule 2021-04-10 18:09:05 -04:00			`Also see [Certified Hardware](/doc/certified-hardware/) and [Hardware Testing](/doc/hardware-testing/).`
Link to Hardware Testing and Certified Hardware pages 2019-08-01 22:11:27 -04:00
HCL changed preview: one table per relase: https://groups.google.com/d/msg/qubes-users/XgEMteF0MtA/k_WwoS7mVMcJ 2013-12-14 08:31:53 -05:00			`Generating and Submitting New Reports`
			`-------------------------------------`

;_; 2017-04-24 12:19:46 -04:00			`In order to generate an HCL report in Qubes, simply open a terminal in dom0 (KDE: start-menu -\> System Tools -\> Konsole or Terminal Emulator)`
Small Edit to hcl.md * Expanded Introduction * Finished unfinished sentences * Moved some sentences 2017-04-19 14:09:28 -04:00			and run `qubes-hcl-report <vm-name>`, where `<vm-name>` is the name of the VM to which the generated HCL files will be saved.
			`(Note: If you are working with a new Qubes installation, you may need to update your system in order to download this script.)`
HCL changed preview: one table per relase: https://groups.google.com/d/msg/qubes-users/XgEMteF0MtA/k_WwoS7mVMcJ 2013-12-14 08:31:53 -05:00
HCL changed minor changes and rearranging, splitting Apple BIOS Version string, TPM 2014-09-24 16:34:12 -04:00			`You are encouraged to submit your HCL report for the benefit of further Qubes development and other users.`
Small Edit to hcl.md * Expanded Introduction * Finished unfinished sentences * Moved some sentences 2017-04-19 14:09:28 -04:00			`When submitting reports, test the hardware yourself, if possible.`
Update Qubes Forum URLs 2021-07-01 10:03:05 -04:00			If you would like to submit your HCL report, please send the HCL Info `.yml` file to [\`qubes-users@googlegroups.com\`](/support/#qubes-users) with the subject `HCL - <your machine model name>`. Alternatively you can also create a post in the [HCL Reports category](https://forum.qubes-os.org/c/user-support/hcl-reports/23) of the forum.
Small Edit to hcl.md * Expanded Introduction * Finished unfinished sentences * Moved some sentences 2017-04-19 14:09:28 -04:00			`Please include any useful information about any Qubes features you may have tested (see the legend below), as well as general machine compatibility (video, networking, sleep, etc.).`
			Please consider sending the HCL Support Files `.cpio.gz` file as well. To generate these add the `-s` or `--support` command line option.
HCL changed preview: one table per relase: https://groups.google.com/d/msg/qubes-users/XgEMteF0MtA/k_WwoS7mVMcJ 2013-12-14 08:31:53 -05:00
HCL changed updated Legend, inserted TPM/AEM column 2014-04-29 11:55:56 -04:00			`Please note:`
			The HCL Support Files may contain numerous hardware details, including serial numbers. If, for privacy or security reasons, you do not wish to make this information public, please do not send the `.cpio.gz` file to the public mailing list.