Qubes OS Community Project

For more information about this project, please see this page.

This repository hosts user-contributed documentation and code/resources.

Pending submissions, reviews and QA can be seen in this repository's issues and pull requests.

User-contributed documentation and links ( icon) to third party docs

Infrequently Asked Questions

common-tasks

• how to copy files (and sparse files) from a VM to dom0
• how to open URLs in another VM

configuration

• use Qubes 3.2 OS as a network server
• use Qubes OS as a smartTV
• VM hardening (fend off malware at VM startup)
• VPN configuration
• Run wireguard on server and use as VPN for Qubes
• Exposing Mumble server running in Qubes using Wireguard
• Make an HTTP Filtering Proxy
• Ansible Qubes (see Rudd-O's other repos as well)
• shrink VM volumes
• script to create Windows qubes automatically
• Manage Qubes via dmenu
• Pihole qube (old post, but also work on QubesOS 4.0)
• Newer Pihole qube, with cloudflared or NextDNS servers
• qubes-dns
• Using multiple languages in dom0
• How to manage Bluetooth graphically
• How to persist Tailscale tunnel in AppVM
• Verify boot process without Heads or AEM on TPM 2.0

coreboot

• install coreboot on a Thinkpad x230

customization

• change DPI scaling in dom0 and VMs
• setup mirage firewall
• gaming HVM with GPU passthrough
• Choose deafult terminal settings for a TemplateVM
• AwesomeWM
• Screenlockers
• QubesOS Autostart Menu
• sys-VPN notification setup
• PAM Distress login script

hardware

• tips on choosing the right hardware

localization

• how to use multiple keyboard layouts

misc

• Qubes 3.2 cheat sheet
• infrequently asked questions

security

• multifactor authentication
• security guidelines
• split bitcoin
• split gpg
• forensics

system

• understanding and fixing issues with time/clock
• restoring 3.2 templates/standalones to 4.0
• connect to a VM console
• display reminders to make regular backups
• mount a VM's private storage volume in another VM

user-setups

• examples of user setups (templates and VMs used, productivity tips, customizations, ...)

User-contributed code and links ( icon) to third party resources

Prolific authors

• Tasket

OS-administration

• qubes4-multi-update: updates multiple template, standalone VMs and dom0 in R4.0 (readme)
• R4-universal-update-script.sh: bash script to automate VM updates
• findpref: find all VMs that match a pref value and optionally set new values for them (readme)
• qvm-portfwd-iptables: port forwarding to allow external connections, see usage notes at bottom
• mount_lvm_image.sh: mount lvm image to a newly created DisposableVM
• build-archlinux.sh: build the archlinux template

monitoring

• ls-qubes.sh: outputs the nb. of running qubes + total memory used; the output can be fed into a panel text applet (see comments in the script).
• qubes-performance
• qrexec-proxy
• qubes-callbackd

multimedia

• sound-control-scripts: toggle, volume up, volume down, ...

productivity

• toggle-fullscreen-scripts
• screenshot-scripts
• bash autocompletion script for qvm-* commands in dom0
• qvm-screenshot-tool
• qubes-split-dm-crypt
• qcrypt
• qidle
• qubes-url-redirector ("Open in Qube")
• qubes-terminal-hotkeys
• qubes-conky
• qvm-ls-mermaid
• fedora-template-updater-script

misc

• halt-vm-by-window: shutdown a Qubes VM associated with the currently active window (readme)
• network traffic analysis (also see Zrubi's other Qubes blog posts !)
• Ubuntu VMs: repository with templates and packages to set up Ubuntu VMs
• shadow-qube: A "Truly Disposable" Qube
• Qubes for Journalists and free-speech defenders: a work-in-progress respository of scripts and advice for journalists and human rights workers.