Update to reflect qvm-template tool

This commit is contained in:
unman@thirdeyesecurity.org 2023-06-06 15:09:23 +00:00
parent abd0fe3597
commit d1adfaa4fc
No known key found for this signature in database
GPG Key ID: BB52274595B71262
2 changed files with 14 additions and 21 deletions

View File

@ -81,14 +81,12 @@ How to test [templates](/doc/templates/):
To temporarily enable any of these repos, use the `--enablerepo=<repo-name>` To temporarily enable any of these repos, use the `--enablerepo=<repo-name>`
option. Example commands: option. Example commands:
``` ```
sudo qubes-dom0-update --enablerepo=qubes-templates-itl-testing qvm-template --enablerepo=qubes-templates-itl-testing list --available
sudo qubes-dom0-update --enablerepo=qubes-templates-community-testing qvm-template --enablerepo=qubes-templates-itl-testing install <template_name>
``` ```
To enable any of these repos permanently, change the corresponding `enabled` value to `1` in `/etc/qubes/repo-templates`.
To enable or disable any of these repos permanently, change the corresponding To disable any of these repos permanently, change the corresponding `enabled` value to `0`.
`enabled` value to `1` in `/etc/yum.repos.d/qubes-templates.repo`.
## Providing feedback ## Providing feedback

View File

@ -95,28 +95,23 @@ when you wish to install a fresh template from the Qubes repositories, e.g.:
* When you suspect your template has been compromised. * When you suspect your template has been compromised.
* When you have made modifications to your template that you no longer want. * When you have made modifications to your template that you no longer want.
Please refer to each template's installation instructions. Usually, the You can use a command line tool - `qvm-template` - or a GUI - `qvm-template-gui`.
installation method is to execute the following type of command in dom0:
At the command line in dom0, `qvm-template list --available` will show available templates. To install a template, use:
``` ```
$ sudo qubes-dom0-update qubes-template-<DISTRO_NAME>-<RELEASE_NUMBER> $ qvm-template install <template_name>
``` ```
`qubes-template-<DISTRO_NAME>-<RELEASE_NUMBER>` is the name of the desired You can also use `qvm-template` to upgrade or reinstall templates.
template package. Advanced users can install a
[minimal](/doc/templates/minimal/) version of the template, if one exists, by
appending `-minimal` directly to the end of the template package name.
If you wish to install a community template, you must enable the community
template repo:
Repo definitions are stored in `/etc/qubes/repo-templates` and associated keys in `/etc/qubes/repo-templates/keys`.
There are additional repos for testing releases and community templates.
To temporarily enable any of these repos, use the `--enablerepo=<repo-name>` option. E.g. :
``` ```
$ sudo qubes-dom0-update --enablerepo=qubes-templates-community qubes-template-<DISTRO_NAME>-<RELEASE_NUMBER> $ qvm-template --enablerepo qubes-templates-community install <template_name>
``` ```
To permanently enable a repo, set the line `enabled = 1` in the repo definition in `/etc/qubes/repo-templates`.
If you receive the message that no match is found for To permanently disable, set the line to `enabled = 0`.
`qubes-template-<DISTRO_NAME>-<RELEASE_NUMBER>`, see
[here](/faq/#when-i-try-to-install-a-template-it-says-no-match-is-found).
If you wish to install a template that is in testing, please see If you wish to install a template that is in testing, please see
[here](/doc/testing/#templates). [here](/doc/testing/#templates).