mirror of
https://github.com/ben-grande/qusal.git
synced 2025-04-24 17:19:23 -04:00
f933523e10
- 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
84 lines
2.6 KiB
Markdown
84 lines
2.6 KiB
Markdown
# sys-gui-gpu
|
|
|
|
GPU GUI domain in Qubes OS.
|
|
|
|
## Table of Contents
|
|
|
|
* [Description](#description)
|
|
* [Installation](#installation)
|
|
* [Uninstallation](#uninstallation)
|
|
* [Usage](#usage)
|
|
|
|
## 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](../../docs/TROUBLESHOOT.md#no-support-for-unfinished-formulas).
|
|
|
|
* Top:
|
|
|
|
```sh
|
|
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:
|
|
|
|
<!-- pkg:begin:post-install -->
|
|
|
|
```sh
|
|
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
|
|
```
|
|
|
|
<!-- pkg:end:post-install -->
|
|
|
|
The formula assumes Intel graphics card, if you have a card from another
|
|
vendor, please use
|
|
[qvm-pci](https://www.qubes-os.org/doc/how-to-use-pci-devices/#qvm-pci-usage)
|
|
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](https://www.qubes-os.org/doc/autostart-troubleshooting/).
|
|
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`:
|
|
|
|
```sh
|
|
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.
|