Git-Mirrors/qubes-doc
1
0
Fork 0
mirror of https://github.com/QubesOS/qubes-doc.git synced 2025-02-26 01:31:18 -05:00
Code Issues Packages Projects Releases Wiki Activity

Create "Reinstall Whonix" page

Browse Source
This commit is contained in:
Andrew David Wong 2016-06-06 15:58:49 -07:00
parent a0bee729e1
commit ffbe63ac8c
No known key found for this signature in database
GPG Key ID: 8CE137352A019A17
2 changed files with 56 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
privacy/whonix-reinstall.md Normal file
View File

@ -0,0 +1,54 @@
---
layout: doc
title: Reinstall Whonix in Qubes
permalink: /doc/whonix/reinstall/
---
Reinstall Whonix in Qubes
===========================
If you suspect your Whonix templates are broken, misconfigured, or compromised,
or if you wish to do a clean reinstall in order to upgrade to a new version, you
can reinstall the Whonix templates from the Qubes repository. This procedure
involves [uninstalling] your Whonix templates, then [installing] them again.
1. (Optional) Clone your existing `whonix-gw` and `whonix-ws` templates.
This can be a good idea if you've customized the existing templates and want
to keep them. On the other hand, if you suspect that these templates are
broken, misconfigured, or compromised, you may want to remove them
without cloning them.
2. (Optional) Temporarily change all VMs based on `whonix-gw` and `whonix-ws` to
another template (e.g., the ones created in the previous step).
This can be a good idea if you have user data in these VMs that you want to
keep. On the other hand, if you suspect that these VMs (or the templates on
which they are based) are broken, misconfigured, or compromised, you may
want to remove them instead. You can do this in Qubes Manager by
right-clicking on the VM and clicking **Remove VM**, or you can use the
command `qvm-remove <vm-name>` in dom0.
3. Uninstall the Whonix templates from dom0:
$ sudo yum remove qubes-template-whonix-gw
$ sudo yum remove qubes-template-whonix-ws
4. Reinstall the Whonix templates in dom0:
$ sudo qubes-dom0-update --enablerepo=qubes-templates-community \
qubes-template-whonix-gw qubes-template-whonix-ws
5. If you followed step 2, change the VMs from step 2 back to the new
`whonix-gw` and `whonix-ws`. If you instead removed all VMs based on the old
`whonix-gw` and `whonix-ws`, simply create your desired VMs from the new
templates.
At a minimum, you'll want a ProxyVM (conventionally called `sys-whonix`)
based on `whonix-gw` and an AppVM based on `whonix-ws` that uses `sys-whonix`
as its NetVM.
[uninstalling]: /doc/whonix/uninstall/
[installing]: /doc/whonix/install/

3
privacy/whonix.md
View File

@ -29,9 +29,10 @@ To install Whonix, you must have a working Qubes machine already.
* [Install Whonix in Qubes](/doc/whonix/install/)
* [Updating Whonix in Qubes](/doc/whonix/update/)
## Customizing & Uninstalling Whonix
## Customizing, Reinstalling, & Uninstalling Whonix
* [Customizing Whonix](/doc/whonix/customize/)
* [Reinstall Whonix in Qubes](/doc/whonix/reinstall/)
* [Uninstall Whonix from Qubes](/doc/whonix/uninstall/)
*The following links are on Whonix's website and are technical.*