From f24299be1ebdd81a5acb6af66967104955ae885a Mon Sep 17 00:00:00 2001 From: Oni Date: Wed, 7 Jun 2023 05:59:45 -0400 Subject: [PATCH] Use 'qvm-template' to uninstall templates The 'dnf remove' command no longer removes templates and mentions "No Match" when using . The 'qvm-template' command will remove templates from both package installation and cloning. 'qvm-template' also warns about qubes dependent on the template which reduces the need for the user to preemptively check that relationship. In its implementation, 'qvm-template' imports and calls 'qvm-remove' to remove the template. 'qvm-template' was selected as the command to present as it provides a more consistent interface when installing, listing, and removing among other commands. --- user/templates/templates.md | 27 +++++++++------------------ 1 file changed, 9 insertions(+), 18 deletions(-) diff --git a/user/templates/templates.md b/user/templates/templates.md index f3740dec..30e40635 100644 --- a/user/templates/templates.md +++ b/user/templates/templates.md @@ -144,28 +144,19 @@ Please see [How to Install Software](/doc/how-to-install-software). ## Uninstalling -If you want to remove a template you must make sure that it is not being used. -You should check that the template is not being used by any qubes, -and also that it is not set as the default template. - -The procedure for uninstalling a template depends on how it was created. - -If the template was originaly created by cloning another template, then you can -delete it the same way as you would any other qube. In the Qube Manager, -right-click on the template and select **Delete qube**. (If you're not sure, -you can safely try this method first to see if it works.) - -If, on the other hand, the template came pre-installed or was installed by -installing a template package in dom0, per the instructions -[above](#installing), then you must execute the following type of command in -dom0 in order to uninstall it: +To remove a template, the graphical `Qube Manager` (Qubes Menu > Qubes Tools > Qube Manager) may be used. Right-click the template to be uninstalled and click "Delete qube" to begin removal. +Alternatively, to remove a template via the command line in dom0: ``` -$ sudo dnf remove qubes-template-- +$ qvm-template remove ``` -`qubes-template--` is the name of the desired -template package. +\ is the first column from the output of: +``` +$ qvm-template list --installed +``` + +In either case, if another qube is based on the template, the template will remain installed and a list of the dependent qubes will be displayed. [Switch](#switching) the dependent qubes to another template before attempting the removal again. You may see warning messages like the following: