qusal/salt/sys-gui/README.md

71 lines
1.7 KiB
Markdown

# sys-gui
Hybrid GUI domain in Qubes OS.
## Table of Contents
* [Description](#description)
* [Installation](#installation)
* [Uninstallation](#uninstallation)
* [Usage](#usage)
## Description
Setup a Hybrid GUI domain named "sys-gui". Dom0 remains with the X Server and
graphics drivers but runs only a single GUI application, a full-screen proxy
for the GUI domain's graphical server.
## Installation
WARNING: [unfinished formula](../../docs/TROUBLESHOOT.md#no-support-for-unfinished-formulas).
* Top:
```sh
sudo qubesctl top.enable qvm.sys-gui pillar=True
sudo qubesctl top.enable sys-gui
sudo qubesctl --targets=tpl-sys-gui,sys-gui state.apply
sudo qubesctl top.disable sys-gui
sudo qubesctl state.apply sys-gui.prefs
```
* State:
<!-- pkg:begin:post-install -->
```sh
sudo qubesctl top.enable qvm.sys-gui pillar=True
sudo qubesctl state.apply sys-gui.create
sudo qubesctl --skip-dom0 --targets=tpl-sys-gui state.apply sys-gui.install
sudo qubesctl --skip-dom0 --targets=sys-gui state.apply sys-gui.configure
sudo qubesctl state.apply sys-gui.prefs
```
<!-- pkg:end:post-install -->
Shutdown all your running qubes as the global property `default_guivm` has
changed to `sys-gui`.
## Usage
Qubes that have their `guivm` preference set to `sys-gui`, will use it as the
GUI domain.
Logout and in the login manager (lightdm, sddm), select session type
`GUI domain (sys-gui)`.
The login credentials are the same used in `dom0`, the first user in the
`qubes` group and the corresponding password.
## Uninstallation
Set Global preference `default_guivm` to `dom0` and disable `autostart` of
`sys-gui`:
```sh
sudo qubesctl state.apply sys-gui.cancel
```
Logout and in the login manager (lightdm, sddm), select session type
`Plasma (X11)` or `Xfce`.