qusal/salt/sys-gui-gpu/README.md

2.3 KiB

sys-gui

GPU GUI domain in Qubes OS.

Table of Contents

Description

Setup a GPU GUI domain named "sys-gui-gpu". The GPU is attached to the qube and all graphics computation are handled by this qube. Requires a dedicated graphics card (external GPU) and PCI passthrough support.

Installation

WARNING: unfinished formula.

  • Top:
sudo qubesctl top.enable qvm.sys-gui pillar=True
sudo qubesctl top.enable sys-gui-gpu
sudo qubesctl --targets=tpl-sys-gui,sys-gui-gpu state.apply
sudo qubesctl top.disable sys-gui-gpu
sudo qubesctl state.apply sys-gui-gpu.prefs
  • State:
sudo qubesctl top.enable qvm.sys-gui pillar=True
sudo qubesctl state.apply sys-gui-gpu.create
sudo qubesctl --skip-dom0 --targets=tpl-sys-gui state.apply sys-gui-gpu.install
sudo qubesctl --skip-dom0 --targets=sys-gui-gpu state.apply sys-gui-gpu.configure
sudo qubesctl state.apply sys-gui-gpu.prefs

The formula assumes Intel graphics card, if you have a card from another vendor, please use qvm-pci to persistently attach the GPU with the permissive option to sys-gui-gpu.

Shutdown all your running qubes as the global property default_guivm has changed to sys-gui-gpu.

Uninstallation

Reboot you computer and prevent Qubes OS autostart of any qube, be it sys-gui-gpu or the qubes connected to it to reach dom0. For that, you need to boot Qubes OS with qubes.skip_autostart GRUB parameter. Only after you have done these steps manually, you can continue the uninstallation procedure.

Set Global preference default_guivm to dom0 and disable autostart of sys-gui-gpu:

sudo qubesctl state.apply sys-gui-gpu.cancel

Usage

Qubes that have their guivm preference set to sys-gui-gpu, will use it as the GUI domain.

The process to enter sys-gui-gpu can be a simple logout, but on most platforms, a reboot is required and recommended to prevent data loss.

The login credentials are the same used in dom0, the first user in the qubes group and the corresponding password.