qusal/salt/sys-gui-gpu/README.md
Ben Grande f933523e10
feat: bump Fedora version
- Update to Fedora 41;
- Change default Fedora template to Xfce variant;
- Enforce Fedora based formulas to depend on a chain that always has the
  correct management disposable set. For 'qubes-builder,' it requires
  'mgmt', which requires 'fedora-minimal', which requires 'fedora-xfce';
- Cleanup salt patch necessary on version 39 and 40.
- Update base templates when stale before being cloned to derivative
  templates.
- Remove non-essential bootstrap formulas from requirements. Dom0 was
  never required, but very recommended, templates were required because
  it was best to update them on their formula before generating outdated
  clones of it.

Fix: https://github.com/ben-grande/qusal/issues/108
Fix: https://github.com/ben-grande/qusal/issues/57
2025-04-14 15:25:57 +02:00

2.6 KiB

sys-gui-gpu

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-gpu pillar=True
sudo qubesctl top.enable mgmt sys-gui-gpu
sudo qubesctl --targets=tpl-mgmt state.apply
sudo qubesctl state.apply sys-gui.prefs-mgmt
sudo qubesctl --targets=tpl-sys-gui,sys-gui-gpu state.apply
sudo qubesctl top.disable mgmt sys-gui-gpu
sudo qubesctl state.apply sys-gui-gpu.prefs
  • State:
sudo qubesctl top.enable qvm.sys-gui-gpu pillar=True
sudo qubesctl state.apply sys-gui-gpu.create
sudo qubesctl --skip-dom0 --targets=tpl-mgmt state.apply mgmt.install
sudo qubesctl state.apply sys-gui.prefs-mgmt
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.