Qubes OS

Introduction

  • Introduction
  • Screenshots
  • Video tours
  • Getting started
  • Frequently asked questions (FAQ)
  • Issue tracking
  • Help, support, mailing lists, and forum
  • How to contribute
  • Statistics
  • Code of conduct
  • Privacy policy

Choosing Your Hardware

  • System requirements
  • Certified hardware
  • Community-recommended hardware
  • Hardware compatibility list (HCL)
  • How to use the hardware compatibility list (HCL)

Downloading, Installing, and Upgrading Qubes

  • Download Qubes OS
  • Download mirrors
  • Installation guide
  • Installation security
  • Upgrade guides
  • Supported releases
  • Testing new releases and updates

How-to guides

  • How to organize your qubes
  • How to update
  • How to back up, restore, and migrate
  • How to copy and paste text
  • How to copy and move files
  • How to copy from dom0
  • How to install software
  • How to use disposables
  • How to enter fullscreen mode
  • How to use devices
  • How to use block storage devices
  • How to use USB devices
  • How to use PCI devices
  • How to use optical discs
  • How to reinstall a template

Templates

  • Templates
  • Fedora templates
  • How to upgrade a Fedora template in-place
  • Debian templates
  • How to upgrade a Debian template in-place
  • Minimal templates
  • Xfce templates
  • Windows qubes

Troubleshooting

  • Installation troubleshooting
  • Update troubleshooting
  • Updating Debian and Whonix
  • Hardware troubleshooting
  • UEFI troubleshooting
  • Autostart troubleshooting
  • Suspend/resume troubleshooting
  • App menu shortcut troubleshooting
  • Qube troubleshooting
  • HVM troubleshooting
  • Disk troubleshooting
  • PCI troubleshooting
  • USB troubleshooting
  • GUI troubleshooting
  • Media troubleshooting
  • VPN troubleshooting

Security in Qubes

  • Firewall
  • Data leaks
  • Passwordless root access in qubes
  • Device handling security
  • Anti evil maid (AEM)
  • Split GPG
  • Multi-factor Login
  • CTAP proxy

Advanced topics

  • How to install software in dom0
  • Volume backup and revert
  • Standalones and HVMs
  • Config files
  • Secondary storage
  • RPC policies
  • USB qubes
  • Managing qube kernels
  • Salt (management software)
  • GUI domain
  • Disposable customization
  • Installing contributed packages
  • How to make any file persistent (bind-dirs)
  • GUI configuration
  • Resize disk image
  • Qubes service
  • How to mount a Qubes partition from another OS
  • KDE (desktop environment)
  • i3 (window manager)
  • AwesomeWM (window manager)

Reference

  • Command-line tools
  • Glossary

Project Security

  • Qubes OS project security center
  • Qubes security pack (qubes-secpack)
  • Verifying signatures

Developers - general

  • Package contributions
  • Google Summer of Code (GSoC)
  • Google Season of Docs (GSoD)
  • How to edit the documentation
  • Documentation style guide
  • Website style guide
  • Continuous integration (CI)
  • Usability & UX
  • Developing Qubes OS GUI tools
  • Visual style guide
  • Research
  • Developer books

Developers - code

  • Source code
  • Software license
  • Coding style
  • Code signing

Developers - system

  • Architecture
  • Security design goals
  • Security-critical code
  • Qubes core admin
  • Qubes core admin client
  • Qubes core stack
  • GUI virtualization
  • Networking
  • Template implementation
  • Audio virtualization
  • Template manager

Developers - services

  • Inter-qube file copying (qfilecopy)
  • Qubes memory manager (qmemman)
  • Disposable implementation
  • Dom0 secure updates
  • Qrexec: secure communication across domains
  • Qrexec v2 (deprecated)
  • Qrexec: Qubes RPC internals
  • Qrexec: socket-based services
  • Admin API
  • Qfileexchgd (deprecated)

Developers - debugging

  • How to set up a test bench
  • Automated tests
  • Qube configuration interface
  • Windows debugging
  • Safe remote dom0 terminals
  • How to mount LVM images

Developers - building

  • Qubes builder v2
  • Qubes builder details
  • Development workflow
  • Qubes ISO building
  • Qubes template configs

Developers - releases

  • Release notes
  • Release schedules
  • Release checklist
  • Version scheme

External - Operating System Guides

  • Template: Ubuntu
  • Template: Whonix
  • Template: CentOS
  • Template: Gentoo
  • Pentesting
  • Pentesting: BlackArch
  • Pentesting: Kali
  • Pentesting: PTF
  • Tips for Using Linux in an HVM
  • Creating a NetBSD VM

External - Security Guides

  • Security Guidelines
  • Using Multi-factor Authentication with Qubes
  • How to Set Up a Split Bitcoin Wallet in Qubes
  • Split dm-crypt
  • Split SSH
  • Using OnlyKey with Qubes OS

External - Privacy Guides

  • Whonix for Privacy & Anonymity
  • Running Tails in Qubes
  • Anonymizing your MAC Address
  • Signal
  • Reducing the fingerprint of the text-based web browser w3m

External - Configuration Guides

  • Qubes Tips and Tricks
  • How to set up a ProxyVM as a VPN Gateway
  • Multibooting
  • Changing your Time Zone
  • Installing ZFS in Qubes
  • Mutt Guide
  • Postfix Guide
  • Fetchmail Guide
  • Creating Custom NetVMs and ProxyVMs
  • How to make proxy for individual tcp connection from networkless VM
  • Adding Bridge Support to the NetVM (EXPERIMENTAL)
  • Screen Sharing
  • Enabling TRIM for SSD disks
  • Configuring a Network Printer
  • Using External Audio Devices
  • Rxvt Guide
  • Adding SSD storage cache
  • How to Make a Multimedia TemplateVM
  • How to install an Nvidia driver in dom0

External - Customization Guides

  • Customizing Fedora minimal templates
  • Customizing Windows 7 templates
  • Language Localization
  • Dark Theme in Dom0 and DomU
  • Safely Removing TemplateVM Packages (Example: Thunderbird)

External - Troubleshooting

  • Nvidia troubleshooting guide
  • Lenovo ThinkPad Troubleshooting
  • Apple MacBook Troubleshooting
  • Sony Vaio Troubleshooting
  • Intel Integrated Graphics Troubleshooting
  • Multiboot Troubleshooting
  • Application Troubleshooting
  • Tails Troubleshooting

External - Building Guides

  • Building a TemplateVM based on a new OS (ArchLinux example)
  • Building the Archlinux Template
  • Building the Whonix Templates
  • How to compile kernels for dom0
Qubes OS
  • Search

© Copyright 2025, Qubes OS Project.

Built with Sphinx using a theme provided by Read the Docs.