Sometimes the Debian, {{project_name_short}} or Qubes onion servers are non-functional. This means updates cannot be completed automatically and an error message similar to below will appear.

{{CodeSelect|code=
user@host:~$ sudo apt update
Hit:1 https://deb.debian.org/debian-security {{Stable project version based on Debian codename}}-security InRelease
Hit:2 tor+http://deb.dds6qkxpwdeubwucdiaord2xgbbeyds25rbsgr73tbfpqpt4a6vjwsyd.onion {{Stable project version based on Debian codename}} InRelease
Ign:3 https://deb.debian.org/debian {{Stable project version based on Debian codename}} InRelease
Hit:4 https://deb.whonix.org {{Stable project version based on Debian codename}} InRelease
Hit:5 https://deb.debian.org/debian {{Stable project version based on Debian codename}} Release
Err:7 tor+http://5ajw6aqf3ep7sijnscdzw77t7xq4xjpsy335yb2wiwgouo7yfxtjlmid.onion {{Stable project version based on Debian codename}}/updates InRelease
SOCKS proxy socks5h://localhost:9050 could not connect to 5ajw6aqf3ep7sijnscdzw77t7xq4xjpsy335yb2wiwgouo7yfxtjlmid.onion (0.0.0.0:0) due to: Host unreachable (6)
Err:8 tor+http://2s4yqjx5ul6okpp3f2gaunr2syex5jgbfpfvhxxbbjwnrsvbk5v3qbid.onion/debian {{Stable project version based on Debian codename}} InRelease
SOCKS proxy socks5h://localhost:9050 could not connect to 2s4yqjx5ul6okpp3f2gaunr2syex5jgbfpfvhxxbbjwnrsvbk5v3qbid.onion (0.0.0.0:0) due to: Host unreachable (6)
Reading package lists… Done
W: Failed to fetch tor+http://5ajw6aqf3ep7sijnscdzw77t7xq4xjpsy335yb2wiwgouo7yfxtjlmid.onion/dists/{{Stable project version based on Debian codename}}/updates/InRelease SOCKS proxy socks5h://localhost:9050 could not connect to 5ajw6aqf3ep7sijnscdzw77t7xq4xjpsy335yb2wiwgouo7yfxtjlmid.onion (0.0.0.0:0) due to: Host unreachable (6)
W: Failed to fetch tor+http://2s4yqjx5ul6okpp3f2gaunr2syex5jgbfpfvhxxbbjwnrsvbk5v3qbid.onion/debian/dists/{{Stable project version based on Debian codename}}/InRelease SOCKS proxy socks5h://localhost:9050 could not connect to 2s4yqjx5ul6okpp3f2gaunr2syex5jgbfpfvhxxbbjwnrsvbk5v3qbid.onion (0.0.0.0:0) due to: Host unreachable (6)
W: Some index files failed to download. They have been ignored, or old ones used instead.
}}

Until the onion service is re-established, complete the following steps in {{project_name_gateway_long}} (<code>{{project_name_gateway_template}}</code>) and {{project_name_workstation_long}} (<code>{{project_name_workstation_template}}</code>) to circumvent the issue. <ref>If similar issues occur with {{project_name_short}} or Qubes onion services then follow the same procedure and modify the <code>derivative.list</code> and <code>qubes-r4.list</code> files, respectively.</ref> <ref>https://forums.whonix.org/t/errors-updating-september-2018/6028</ref>
{{Box|text=
'''1.''' Open Debian ''sources.list'' in an editor.

{{Open with root rights|filename=
/etc/apt/sources.list.d/debian.list
}}

'''2.''' Comment (#) the .onion address lines and uncomment the clearnet address lines.

The code blocks should look like this; only these entries require editing. <ref>There is no Debian onion for fasttrack yet.</ref>

{{CodeSelect|code=
deb tor+https://deb.debian.org/debian bullseye main contrib non-free
deb tor+https://deb.debian.org/debian bullseye-updates main contrib non-free
deb tor+https://deb.debian.org/debian-security bullseye-security main contrib non-free
deb tor+https://deb.debian.org/debian bullseye-backports main contrib non-free
deb tor+https://fasttrack.debian.net/debian bullseye-fasttrack main contrib non-free

#deb tor+http://2s4yqjx5ul6okpp3f2gaunr2syex5jgbfpfvhxxbbjwnrsvbk5v3qbid.onion/debian bullseye main contrib non-free
#deb tor+http://2s4yqjx5ul6okpp3f2gaunr2syex5jgbfpfvhxxbbjwnrsvbk5v3qbid.onion/debian bullseye-updates main contrib non-free
#deb tor+http://5ajw6aqf3ep7sijnscdzw77t7xq4xjpsy335yb2wiwgouo7yfxtjlmid.onion/debian-security bullseye-security main contrib non-free
#deb tor+http://2s4yqjx5ul6okpp3f2gaunr2syex5jgbfpfvhxxbbjwnrsvbk5v3qbid.onion/debian bullseye-backports main contrib non-free
}}

Save and exit.

'''3.''' Confirm the clearnet repositories are functional.

{{CodeSelect|code=
sudo apt update
}}

'''4.''' ''Optional:'' Revert and update the package lists.

Consider reverting these changes later on because onion repositories have various security advantages. Afterwards, apply [[#Updates|Updates]] to refresh the package lists.
}}