2014-07-30 02:16:37 -04:00
|
|
|
---
|
2015-04-10 16:17:45 -04:00
|
|
|
layout: doc
|
2014-07-30 02:16:37 -04:00
|
|
|
title: Templates
|
2015-10-28 18:14:40 -04:00
|
|
|
permalink: /doc/templates/
|
2015-10-11 03:04:59 -04:00
|
|
|
redirect_from:
|
2015-10-28 18:14:40 -04:00
|
|
|
- /en/doc/templates/
|
2015-10-11 03:04:59 -04:00
|
|
|
- /doc/Templates/
|
|
|
|
|
- /wiki/Templates/
|
2014-07-30 02:16:37 -04:00
|
|
|
---
|
|
|
|
|
|
2015-10-16 21:29:33 -04:00
|
|
|
TemplateVMs
|
|
|
|
|
===========
|
|
|
|
|
|
|
|
|
|
Every TemplateBasedVM in Qubes is, as the name implied, based on some
|
|
|
|
|
TemplateVM. The TemplateVM is where all the software available to
|
|
|
|
|
TemplateBasedVMs is installed. The default template is based on Fedora,
|
|
|
|
|
but there are additional templates based on other Linux distributions. There
|
|
|
|
|
are also templates available with or without certain software preinstalled. The
|
|
|
|
|
concept of TemplateVMs is initially described
|
2015-10-28 18:14:40 -04:00
|
|
|
[here](/doc/getting-started/#appvms-domains-and-templatevms). The technical
|
2015-10-16 21:29:33 -04:00
|
|
|
details of this implementation are described in the developer documentation
|
2015-10-28 18:14:40 -04:00
|
|
|
[here](/doc/template-implementation/).
|
2015-10-16 21:29:33 -04:00
|
|
|
|
|
|
|
|
Some templates are available in ready-to-use binary form, but some of them are
|
|
|
|
|
available only as source code, which can be built using
|
2015-10-28 18:14:40 -04:00
|
|
|
[Qubes Builder](/doc/qubes-builder/). In particular, some template "flavors"
|
2015-10-16 21:29:33 -04:00
|
|
|
are available in source code form only. Take a look at the [Qubes Builder
|
2015-10-28 18:14:40 -04:00
|
|
|
documentation](/doc/qubes-builder/) for instructions on how to compile them.
|
2015-10-16 21:29:33 -04:00
|
|
|
|
2015-04-23 10:14:55 -04:00
|
|
|
|
|
|
|
|
ITL Supported templates
|
|
|
|
|
-----------------------
|
|
|
|
|
|
2015-10-16 21:29:33 -04:00
|
|
|
These are templates which ITL is responsible for building and releasing updates
|
|
|
|
|
for. ITL guarantees that the binary updates are compiled from exactly the same
|
|
|
|
|
source code as we publish.
|
|
|
|
|
|
|
|
|
|
* Fedora (default base template)
|
2015-10-28 18:14:40 -04:00
|
|
|
* [Fedora - Minimal](/doc/templates/fedora-minimal)
|
|
|
|
|
* [Debian](/doc/templates/debian/)
|
2014-07-30 02:16:37 -04:00
|
|
|
|
|
|
|
|
|
2015-04-23 10:14:55 -04:00
|
|
|
Community Supported templates
|
|
|
|
|
-----------------------------
|
|
|
|
|
|
2015-10-16 21:29:33 -04:00
|
|
|
These templates are supported by the Qubes community. Some of them are
|
|
|
|
|
available in ready-to-use binary package form (built by ITL), while others
|
|
|
|
|
are available only in source code form. In all cases ITL, does not provide
|
|
|
|
|
updates for these templates. However, such updates may be provided by the
|
|
|
|
|
template maintainer.
|
|
|
|
|
|
|
|
|
|
By installing these templates, you are trusting not only ITL and the
|
|
|
|
|
distribution maintainers, but also the template maintainer. In addition,
|
|
|
|
|
these templates may be somewhat less stable, since ITL does not test them.
|
|
|
|
|
|
2015-12-02 13:14:39 -05:00
|
|
|
* [Whonix](/doc/templates/whonix/)
|
|
|
|
|
* [Ubuntu](/doc/templates/ubuntu/)
|
|
|
|
|
* [Archlinux](/doc/templates/archlinux/)
|
2015-10-16 21:29:33 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
Important Notes
|
|
|
|
|
---------------
|
2015-04-23 10:14:55 -04:00
|
|
|
|
2015-10-16 21:29:33 -04:00
|
|
|
* Whenever a TemplateBasedVM is created, the contents of the `/home`
|
|
|
|
|
directory of its parent TemplateVM are copied to the child TemplateBasedVM's
|
|
|
|
|
`/home`. From that point onward, the child TemplateBasedVM's `/home`
|
|
|
|
|
is independent from its parent TemplateVM's `/home`, which means that any
|
|
|
|
|
subsequent changes to the parent TemplateVM's `/home` will no longer affect
|
|
|
|
|
the child TemplateBasedVM's `/home`.
|
2014-07-30 02:16:37 -04:00
|
|
|
|
2015-10-16 21:29:33 -04:00
|
|
|
* Once a TemplateBasedVM has been created, any changes in its `/home`,
|
|
|
|
|
`/usr/local`, or `/rw/config` directories will be persistent across reboots,
|
|
|
|
|
which means that any files stored there will still be available after
|
|
|
|
|
restarting the TemplateBasedVM. No changes in any other directories in
|
|
|
|
|
TemplateBasedVMs persist in this manner. If you would like to make changes
|
|
|
|
|
in other directories which *do* persist in this manner, you must make those
|
|
|
|
|
changes in the parent TemplateVM.
|
2016-02-26 00:19:55 -05:00
|
|
|
|
2016-02-26 00:34:29 -05:00
|
|
|
* Templates are not automatically updated when
|
2016-02-26 00:19:55 -05:00
|
|
|
[updating dom0](/doc/software-update-dom0/). This is by design, since doing
|
|
|
|
|
so would cause all user modifications to templates to be lost. Instead, you
|
2016-02-26 00:34:29 -05:00
|
|
|
should update your templates
|
2016-02-26 00:19:55 -05:00
|
|
|
[from within each template](/doc/software-update-vm/). If you *do* want to
|
|
|
|
|
update a template from dom0 (and thereby lose any user modifications in the
|
|
|
|
|
existing template), you must first uninstall the existing template from dom0:
|
|
|
|
|
|
|
|
|
|
$ sudo yum remove qubes-template-fedora-23
|
2016-03-20 16:31:57 -04:00
|
|
|
|
|
|
|
|
* On XFCE based Dom0, a manual action may be required to remove the "Start Menu"
|
|
|
|
|
sub-menu of the removed TemplateVM. For example, to remove a dangling sub-menu
|
|
|
|
|
for a removed "fedora-21" template, open a Dom0 Terminal and type:
|
|
|
|
|
|
|
|
|
|
$ sudo rm ~/.local/share/applications/fedora-21-*
|
|
|
|
|
|
|
|
|
|
Just make sure there are no other TemplateVMs whose names start with "fedora-21"
|
|
|
|
|
or else their menu items will be removed too.
|
|
|
|
|
|
