Gentoo TemplateVM

Community Guides
,
1

If you would like to use a stable, predictable, manageable and reproducible distribution in your AppVMs, you can install the Gentoo template, provided by Qubes in ready to use binary package. For the minimal and Xfce versions, please see the Minimal TemplateVMs and Xfce TemplateVMs pages.

Installation

The standard Gentoo TemplateVM can be installed with the following command in dom0:

[user@dom0 ~]$ sudo qubes-dom0-update --enablerepo=qubes-templates-community qubes-template-gentoo

To switch, reinstall and uninstall a Gentoo TemplateVM that is already installed in your system, see How to switch, reinstall and uninstall.

After Installing

After a fresh install, we recommend to Update the TemplateVM. We highlight that the template memory/CPU allocation certainly need to be adjusted in some cases. As Gentoo is a linux source distribution, the template needs resources to perform updates or installing any packages. By default, each TemplateVM has 2 VCPUs for 4000 MB Max memory allocated. If needed, double those values, 4 VCPUs for 8000 MB Max memory. For example, it has been observed failing updates or builds with 4 VCPUs for 4000 MB Max memory due to out of memory issue. For more general considerations, we refer to the official Gentoo Handbook.

Want to contribute?

This document was migrated from the qubes-community project
  • Page archive
  • First commit: 08 Dec 2020. Last commit: 08 Dec 2020.
  • Applicable Qubes OS releases based on commit dates and supported releases: 4.0
  • Original author(s) (GitHub usernames):
  • Original author(s) (forum usernames):
  • Document license: CC BY 4.0
2

Example command fails with this message

error: Template 'gentoo' not found

3

Try gentoo-minimal from community-testing

I never presume to speak for the Qubes team.
When I comment in the Forum I speak for myself.

4

Failed with same error. Maybe you can spot something incorrect in the command I’m using.

$ sudo qubes-dom0-update --enablerepo=qubes-templates-community qubes-template-gentoo-minimal
Using sys-whonix as UpdateVM for Dom0
Downloading packages. This may take a while...
Redirecting to 'qvm-template install --enablerepo=qubes-templates-community gentoo-minimal'
usage: qvm-template [--verbose] [--quiet] [--help] [--repo-files REPO_FILES] [--keyring KEYRING]
                    [--updatevm UPDATEVM] [--enablerepo REPOID] [--disablerepo REPOID]
                    [--repoid REPOS] [--releasever RELEASEVER] [--refresh] [--cachedir CACHEDIR]
                    [--keep-cache] [--yes]
                    {install,reinstall,downgrade,upgrade,download,list,info,search,remove,purge,clean,repolist,migrate-from-rpmdb}
                    ...
qvm-template: error: Template 'gentoo-minimal' not found.
5

It’s in the qubes-templates-community-testing repo for Qubes OS 4.2:

sudo qvm-template  --enablerepo qubes-templates-community-testing install qubes-template-gentoo-minimal
1 Like
6

Thank you. I glossed over the community vs community-testing part of the repo.