qubes-doc/user/managing-os/fedora/fedora.md

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


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

## Installing

To [install](/doc/templates/#installing) a specific Fedora TemplateVM 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 TemplateVM that is already installed in your system, see [How to Reinstall a TemplateVM](/doc/reinstall-template/).

## After Installing

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

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

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

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

## Updating

For routine daily updates within a given release, see [Updating software in TemplateVMs](/doc/software-update-domu/#updating-software-in-templatevms).

## Upgrading

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

- [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.

- [Perform an in-place upgrade of an existing Fedora template.](/doc/template/fedora/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`
Revert "Remove instances of `title:` from YAML headers" This reverts commit 24e6a8a616bfba80534d5d700b2f6b02745561fe. https://github.com/QubesOS/qubes-issues/issues/6701#issuecomment-862060759 2021-06-16 02:19:45 -04:00			`title: The Fedora TemplateVM`
Reorganize TemplateVM pages 2016-11-27 18:29:15 -05:00			`---`


Refactor links in order to obey the new convention rule 2021-04-10 18:09:05 -04:00			`The Fedora [TemplateVM](/doc/templates/) is the default TemplateVM in Qubes OS. This page is about the standard (or "full") Fedora TemplateVM. For the minimal and Xfce versions, please see the [Minimal TemplateVMs](/doc/templates/minimal/) and [Xfce TemplateVMs](/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
Refactor links in order to obey the new convention rule 2021-04-10 18:09:05 -04:00			`To [install](/doc/templates/#installing) a specific Fedora TemplateVM 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
Refactor links in order to obey the new convention rule 2021-04-10 18:09:05 -04:00			`To reinstall a Fedora TemplateVM that is already installed in your system, see [How to Reinstall a TemplateVM](/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
			`After installing a fresh Fedora TemplateVM, we recommend performing the following steps:`

Refactor links in order to obey the new convention rule 2021-04-10 18:09:05 -04:00			`1. [Update the TemplateVM](/doc/software-update-vm/).`
Clarify Fedora TemplateVM instructions Closes QubesOS/qubes-issues#4298 2018-09-11 04:42:00 -04:00
Refactor links in order to obey the new convention rule 2021-04-10 18:09:05 -04:00			`2. [Switch any TemplateBasedVMs that are based on the old TemplateVM to the new one](/doc/templates/#switching).`
Clarify Fedora TemplateVM instructions Closes QubesOS/qubes-issues#4298 2018-09-11 04:42:00 -04:00
Refactor links in order to obey the new convention rule 2021-04-10 18:09:05 -04:00			`3. If desired, [uninstall the old TemplateVM](/doc/templates/#uninstalling).`
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			`## Updating`

Refactor links in order to obey the new convention rule 2021-04-10 18:09:05 -04:00			`For routine daily updates within a given release, see [Updating software in TemplateVMs](/doc/software-update-domu/#updating-software-in-templatevms).`
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`

Improve Fedora and Debian upgrade information 2020-08-16 04:49:30 -04:00			`There are two ways to upgrade your TemplateVM to a new Fedora release:`
"Desired changes for pullrequest #1024" 2020-08-05 06:39:07 -04:00
Steer newbies away from in-place upgrades even more https://qubes-os.discourse.group/t/cat-etc-fedora-release-what-to-do-if-wrong-version/4510/6 2021-06-16 00:22:35 -04:00			- [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
Steer newbies away from in-place upgrades even more https://qubes-os.discourse.group/t/cat-etc-fedora-release-what-to-do-if-wrong-version/4510/6 2021-06-16 00:22:35 -04:00			`- [Perform an in-place upgrade of an existing Fedora template.](/doc/template/fedora/upgrade/) This option will preserve any modifications you've made to the template, but it may be more complicated for less experienced users.`
Refactor links in order to obey the new convention rule 2021-04-10 18:09:05 -04:00