qubes-doc/user/templates/fedora/fedora.md

---
lang: en
layout: doc
permalink: /doc/templates/fedora/
ref: 136
title: Fedora templates
---

The Fedora [template](/doc/templates/) is the default template in Qubes OS. This page is about the standard (or "full") Fedora template. For the minimal and Xfce versions, please see the [Minimal templates](/doc/templates/minimal/) and [Xfce templates](/doc/templates/xfce/) pages.

## Installing

To [install](/doc/templates/#installing) a specific Fedora template that is not currently installed in your system, use the following command in dom0:

```
$ sudo qubes-dom0-update qubes-template-fedora-XX
```

   (Replace `XX` with the Fedora version number of the template you wish to install.)

To reinstall a Fedora template that is already installed in your system, see [How to Reinstall a template](/doc/reinstall-template/).

## After Installing

After installing a fresh Fedora template, we recommend performing the following steps:

1. [Update the template](/doc/software-update-vm/).

2. [Switch any app qubes that are based on the old template to the new one](/doc/templates/#switching).

3. If desired, [uninstall the old template](/doc/templates/#uninstalling).

## Installing software

See [How to Install Software](/doc/how-to-install-software/).

## Updating

For routine daily updates within a given release, see [How to Update](/doc/how-to-update/).

## Upgrading

There are two ways to upgrade your template to a new Fedora release:

- **Recommended:** [Install a fresh template to replace the existing one.](#installing) **This option may be simpler for less experienced users.** After you install the new template, redo all desired template modifications and [switch everything that was set to the old template to the new template](/doc/templates/#switching). You may want to write down the modifications you make to your templates so that you remember what to redo on each fresh install. To see a log of package manager actions, open a terminal in the old Fedora template and use the `dnf history` command.

- **Advanced:** [Perform an in-place upgrade of an existing Fedora template.](/doc/templates/fedora/in-place-upgrade/) This option will preserve any modifications you've made to the template, **but it may be more complicated for less experienced users.**
Reorganize TemplateVM pages 2016-11-27 18:29:15 -05:00			`---`
Add lang + ref tags to frontmatter Those are fields used by the language switcher to correlate pages across different languages, even if they have different names/paths/titles. They are generated with the prepare_for_translation.py script. 2021-03-13 13:06:18 -05:00			`lang: en`
Reorganize TemplateVM pages 2016-11-27 18:29:15 -05:00			`layout: doc`
Revert "Remove all instances of `permalink:` in YAML frontmatter" This reverts commit c815e4c54c315dfca30c66f6a33e07b1ff90b786. https://github.com/QubesOS/qubes-issues/issues/6701#issuecomment-862822827 2021-06-16 22:56:25 -04:00			`permalink: /doc/templates/fedora/`
Add lang + ref tags to frontmatter Those are fields used by the language switcher to correlate pages across different languages, even if they have different names/paths/titles. They are generated with the prepare_for_translation.py script. 2021-03-13 13:06:18 -05:00			`ref: 136`
Sentence case for titles 2021-07-08 21:06:41 -04:00			`title: Fedora templates`
Reorganize TemplateVM pages 2016-11-27 18:29:15 -05:00			`---`

Mass replace "TemplateVM" with "template" QubesOS/qubes-issues#1015 2021-06-18 05:16:40 -04:00			`The Fedora [template](/doc/templates/) is the default template in Qubes OS. This page is about the standard (or "full") Fedora template. For the minimal and Xfce versions, please see the [Minimal templates](/doc/templates/minimal/) and [Xfce templates](/doc/templates/xfce/) pages.`
Add installation instructions for the standard Fedora TemplateVM 2018-01-07 21:24:33 -05:00
Revamp documentation on managing OSes in Qubes - Unify and normalize Fedora and Debian docs - Deduplicate content - Cross-link pages - Move content to correct pages - Use more accurate and intuitive terms and names Fixes QubesOS/qubes-issues#5284 2019-09-02 05:34:26 -04:00			`## Installing`
Add installation instructions for the standard Fedora TemplateVM 2018-01-07 21:24:33 -05:00
Mass replace "TemplateVM" with "template" QubesOS/qubes-issues#1015 2021-06-18 05:16:40 -04:00			`To [install](/doc/templates/#installing) a specific Fedora template that is not currently installed in your system, use the following command in dom0:`
Add installation instructions for the standard Fedora TemplateVM 2018-01-07 21:24:33 -05:00
Markdown formatting fixes - mark all code blocks with ``` - unify empty lines between sections - adjust list syntax (no space before dash) - adjust headers to use Atx-style syntax - remove trailing spaces 2021-03-13 12:03:23 -05:00			```
			`$ sudo qubes-dom0-update qubes-template-fedora-XX`
			```
Add installation instructions for the standard Fedora TemplateVM 2018-01-07 21:24:33 -05:00
Update fedora.md Description updated to reflect situation "install", not "remove" 2018-12-07 10:55:34 -05:00			(Replace `XX` with the Fedora version number of the template you wish to install.)
Add installation instructions for the standard Fedora TemplateVM 2018-01-07 21:24:33 -05:00
Mass replace "TemplateVM" with "template" QubesOS/qubes-issues#1015 2021-06-18 05:16:40 -04:00			`To reinstall a Fedora template that is already installed in your system, see [How to Reinstall a template](/doc/reinstall-template/).`
Add installation instructions for the standard Fedora TemplateVM 2018-01-07 21:24:33 -05:00
Revamp documentation on managing OSes in Qubes - Unify and normalize Fedora and Debian docs - Deduplicate content - Cross-link pages - Move content to correct pages - Use more accurate and intuitive terms and names Fixes QubesOS/qubes-issues#5284 2019-09-02 05:34:26 -04:00			`## After Installing`
Add installation instructions for the standard Fedora TemplateVM 2018-01-07 21:24:33 -05:00
Mass replace "TemplateVM" with "template" QubesOS/qubes-issues#1015 2021-06-18 05:16:40 -04:00			`After installing a fresh Fedora template, we recommend performing the following steps:`
Add installation instructions for the standard Fedora TemplateVM 2018-01-07 21:24:33 -05:00
Mass replace "TemplateVM" with "template" QubesOS/qubes-issues#1015 2021-06-18 05:16:40 -04:00			`1. [Update the template](/doc/software-update-vm/).`
Clarify Fedora TemplateVM instructions Closes QubesOS/qubes-issues#4298 2018-09-11 04:42:00 -04:00
Mass replace "TemplateVM" with "template" QubesOS/qubes-issues#1015 2021-06-18 05:16:40 -04:00			`2. [Switch any app qubes that are based on the old template to the new one](/doc/templates/#switching).`
Clarify Fedora TemplateVM instructions Closes QubesOS/qubes-issues#4298 2018-09-11 04:42:00 -04:00
Mass replace "TemplateVM" with "template" QubesOS/qubes-issues#1015 2021-06-18 05:16:40 -04:00			`3. If desired, [uninstall the old template](/doc/templates/#uninstalling).`
Add installation instructions for the standard Fedora TemplateVM 2018-01-07 21:24:33 -05:00
Fix link; add section on installing software 2021-06-21 01:01:01 -04:00			`## Installing software`

			`See [How to Install Software](/doc/how-to-install-software/).`

Revamp documentation on managing OSes in Qubes - Unify and normalize Fedora and Debian docs - Deduplicate content - Cross-link pages - Move content to correct pages - Use more accurate and intuitive terms and names Fixes QubesOS/qubes-issues#5284 2019-09-02 05:34:26 -04:00			`## Updating`

Fix link; add section on installing software 2021-06-21 01:01:01 -04:00			`For routine daily updates within a given release, see [How to Update](/doc/how-to-update/).`
Revamp documentation on managing OSes in Qubes - Unify and normalize Fedora and Debian docs - Deduplicate content - Cross-link pages - Move content to correct pages - Use more accurate and intuitive terms and names Fixes QubesOS/qubes-issues#5284 2019-09-02 05:34:26 -04:00
			`## Upgrading`

Mass replace "TemplateVM" with "template" QubesOS/qubes-issues#1015 2021-06-18 05:16:40 -04:00			`There are two ways to upgrade your template to a new Fedora release:`
"Desired changes for pullrequest #1024" 2020-08-05 06:39:07 -04:00
Steer newbies toward easy upgrade method even more 2021-06-21 00:55:36 -04:00			- Recommended: [Install a fresh template to replace the existing one.](#installing) This option may be simpler for less experienced users. After you install the new template, redo all desired template modifications and [switch everything that was set to the old template to the new template](/doc/templates/#switching). You may want to write down the modifications you make to your templates so that you remember what to redo on each fresh install. To see a log of package manager actions, open a terminal in the old Fedora template and use the `dnf history` command.
Refactor links in order to obey the new convention rule 2021-04-10 18:09:05 -04:00
Make '/doc/template[s]/' paths consistent Most pages were using the pattern '/doc/templates/[...]', but some were using the pattern '/doc/template/[...]', which was confusing. This commit unifies on the former. 2022-05-26 15:27:06 -04:00			`- Advanced: [Perform an in-place upgrade of an existing Fedora template.](/doc/templates/fedora/in-place-upgrade/) This option will preserve any modifications you've made to the template, but it may be more complicated for less experienced users.`