Git-Mirrors/qubes-doc
1
0
Fork 0
mirror of https://github.com/QubesOS/qubes-doc.git synced 2025-08-11 08:00:40 -04:00
Code Issues Projects Releases Packages Wiki Activity

Convert to RST

Browse source 
This is done using tools at
https://github.com/maiska/qubes-translation-utilz, commit
4c8e2a7f559fd37e29b51769ed1ab1c6cf92e00d.
This commit is contained in:
Marek Marczykowski-Górecki 2025-07-04 14:23:09 +02:00
parent e3db139fe3
commit 7e464d0f40
No known key found for this signature in database
GPG key ID: F32894BE9684938A
428 changed files with 32833 additions and 29703 deletions
Download patch file Download diff file Expand all files Collapse all files

54
user/troubleshooting/update-troubleshooting.rst Normal file
View file

@ -0,0 +1,54 @@
======================
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://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://bugzilla.redhat.com/show_bug.cgi?id=1494178
- 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``