qubes-doc/user/troubleshooting/update-troubleshooting.md

---
lang: en
layout: doc
permalink: /doc/update-troubleshooting/
ref: 239
title: Update troubleshooting
---

## “Failed to synchronize cache for repo” errors when updating Fedora templates

This is general Fedora issue, not a Qubes-specific issue.
Usually, this is due to network problems (especially if downloading updates over Tor) or problems with the download mirrors.
Often, the problem can be resolved by trying again on a different connection (a different Tor circuit, if using Tor) or waiting and trying again later.
Here are some examples of non-Qubes reports about this problem:

- [https://ask.fedoraproject.org/en/question/88086/error-failed-to-synchronize-cache-for-repo-fedora/](https://ask.fedoraproject.org/en/question/88086/error-failed-to-synchronize-cache-for-repo-fedora/)
- [https://unix.stackexchange.com/questions/390805/repos-not-working-on-fedora-error-failed-to-synchronize-cache-for-repo-update](https://unix.stackexchange.com/questions/390805/repos-not-working-on-fedora-error-failed-to-synchronize-cache-for-repo-update)
- [https://www.reddit.com/r/Fedora/comments/74nldq/fedora\_26\_dnf\_error\_failed\_to\_synchronize\_cache/](https://www.reddit.com/r/Fedora/comments/74nldq/fedora_26_dnf_error_failed_to_synchronize_cache/)
- [https://bugzilla.redhat.com/show\_bug.cgi?id=1494178](https://bugzilla.redhat.com/show_bug.cgi?id=1494178)
- [https://stackoverflow.com/questions/45318256/error-failed-to-synchronize-cache-for-repo-updates](https://stackoverflow.com/questions/45318256/error-failed-to-synchronize-cache-for-repo-updates)

More examples can be found by searching for "Failed to synchronize cache for repo" (with quotation marks) on your preferred search engine.

## Lost internet access after a template update

In earlier versions of Qubes, there were situations where qubes lost internet access after a template update. The following fix should be applied in recent versions of Qubes.

Run `systemctl enable NetworkManager-dispatcher.service` in the template upon which your NetVM is based.
You may have to reboot afterward for the change to take effect.
(Note: This is an upstream problem. See [this Redhat ticket](https://bugzilla.redhat.com/show_bug.cgi?id=974811)).
For details, see the qubes-users mailing list threads [here](https://groups.google.com/d/topic/qubes-users/xPLGsAJiDW4/discussion) and [here](https://groups.google.com/d/topic/qubes-users/uN9G8hjKrGI/discussion).)

## Windows update is stuck

This has nothing to do with Qubes.
It's a longstanding Windows bug.
More information about this issue and solutions can be found [here](https://superuser.com/questions/951960/windows-7-sp1-windows-update-stuck-checking-for-updates).

## Dom0 and/or template update stalls when updating via the GUI tool

This can usually be fixed by updating via the command line.

In dom0, open a terminal and run `sudo qubes-dom0-update`.

Depending on your operating system, open a terminal in the templates and run:
* Fedora: `sudo dnf upgrade`
* Debian: `apt-get update && apt-get dist-upgrade`
Add Update Troublshooting, edit VM TS 2020-11-20 18:20:47 -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`
Add Update Troublshooting, edit VM TS 2020-11-20 18:20:47 -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/update-troubleshooting/`
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: 239`
Sentence case for titles 2021-07-08 21:06:41 -04:00			`title: Update troubleshooting`
Add Update Troublshooting, edit VM TS 2020-11-20 18:20:47 -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			`## “Failed to synchronize cache for repo” errors when updating Fedora templates`
Add Update Troublshooting, edit VM TS 2020-11-20 18:20:47 -05:00
			`This is general Fedora issue, not a Qubes-specific issue.`
			`Usually, this is due to network problems (especially if downloading updates over Tor) or problems with the download mirrors.`
			`Often, the problem can be resolved by trying again on a different connection (a different Tor circuit, if using Tor) or waiting and trying again later.`
			`Here are some examples of non-Qubes reports about this problem:`

Refactor links in order to obey the new convention rule 2021-04-10 18:09:05 -04:00			`- [https://ask.fedoraproject.org/en/question/88086/error-failed-to-synchronize-cache-for-repo-fedora/](https://ask.fedoraproject.org/en/question/88086/error-failed-to-synchronize-cache-for-repo-fedora/)`
			`- [https://unix.stackexchange.com/questions/390805/repos-not-working-on-fedora-error-failed-to-synchronize-cache-for-repo-update](https://unix.stackexchange.com/questions/390805/repos-not-working-on-fedora-error-failed-to-synchronize-cache-for-repo-update)`
			`- [https://www.reddit.com/r/Fedora/comments/74nldq/fedora\_26\_dnf\_error\_failed\_to\_synchronize\_cache/](https://www.reddit.com/r/Fedora/comments/74nldq/fedora_26_dnf_error_failed_to_synchronize_cache/)`
			`- [https://bugzilla.redhat.com/show\_bug.cgi?id=1494178](https://bugzilla.redhat.com/show_bug.cgi?id=1494178)`
			`- [https://stackoverflow.com/questions/45318256/error-failed-to-synchronize-cache-for-repo-updates](https://stackoverflow.com/questions/45318256/error-failed-to-synchronize-cache-for-repo-updates)`
Add Update Troublshooting, edit VM TS 2020-11-20 18:20:47 -05:00
			`More examples can be found by searching for "Failed to synchronize cache for repo" (with quotation marks) on your preferred search engine.`

Mass replace "TemplateVM" with "template" QubesOS/qubes-issues#1015 2021-06-18 05:16:40 -04:00			`## Lost internet access after a template update`
Add Update Troublshooting, edit VM TS 2020-11-20 18:20:47 -05:00
Mass replace "TemplateVM" with "template" QubesOS/qubes-issues#1015 2021-06-18 05:16:40 -04:00			`In earlier versions of Qubes, there were situations where qubes lost internet access after a template update. The following fix should be applied in recent versions of Qubes.`
Add Update Troublshooting, edit VM TS 2020-11-20 18:20:47 -05:00
Mass replace "TemplateVM" with "template" QubesOS/qubes-issues#1015 2021-06-18 05:16:40 -04:00			Run `systemctl enable NetworkManager-dispatcher.service` in the template upon which your NetVM is based.
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			`You may have to reboot afterward for the change to take effect.`
			`(Note: This is an upstream problem. See [this Redhat ticket](https://bugzilla.redhat.com/show_bug.cgi?id=974811)).`
Add Update Troublshooting, edit VM TS 2020-11-20 18:20:47 -05:00			`For details, see the qubes-users mailing list threads [here](https://groups.google.com/d/topic/qubes-users/xPLGsAJiDW4/discussion) and [here](https://groups.google.com/d/topic/qubes-users/uN9G8hjKrGI/discussion).)`

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			`## Windows update is stuck`
Add Update Troublshooting, edit VM TS 2020-11-20 18:20:47 -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			`This has nothing to do with Qubes.`
Update update-troubleshooting.md 2020-11-24 14:02:32 -05:00			`It's a longstanding Windows bug.`
			`More information about this issue and solutions can be found [here](https://superuser.com/questions/951960/windows-7-sp1-windows-update-stuck-checking-for-updates).`
Add Update Troublshooting, edit VM TS 2020-11-20 18:20:47 -05:00
Mass replace "TemplateVM" with "template" QubesOS/qubes-issues#1015 2021-06-18 05:16:40 -04:00			`## Dom0 and/or template update stalls when updating via the GUI tool`
Add Update Troublshooting, edit VM TS 2020-11-20 18:20:47 -05:00
			`This can usually be fixed by updating via the command line.`

			In dom0, open a terminal and run `sudo qubes-dom0-update`.

Mass replace "TemplateVM" with "template" QubesOS/qubes-issues#1015 2021-06-18 05:16:40 -04:00			`Depending on your operating system, open a terminal in the templates and run:`
Update update-troubleshooting.md 2020-11-24 14:02:32 -05:00			* Fedora: `sudo dnf upgrade`
			* Debian: `apt-get update && apt-get dist-upgrade`