Testers Update instructions
DO NOT FORGET TO BACKUP (CLONE) your existing whonix templates 
Following is the procedure I used to update a Qubes OS Release 3 whonix-gateway template from 9.6.2 to 10.0.5. I have not tested updating whonix-workstation, since I did not have a 9.6 version installed, but I would assume the same procedure as listed below could be followed verbatim.
In dom0
Backup (clone) existing whonix-gateway and whonix-workstation (max 30 chars)
qvm-clone whonix-gateway-experimental whonix-gw-backup
qvm-clone whonix-workstation whonix-ws-backup
In Whonix template-vm
Fix if you receive locale errors that may have happened during a Debian system update
sudo localedef -f UTF-8 -i en_US -c en_US.UTF-8
sudo update-locale LC_ALL=en_US.UTF-8
poweroff # Need to restart template-vm for setttings to take effect
Enable qubes TEST repo; uncomment test repos (remove the ‘#’)
(Use vi, nano or whatever text editor you are familiar with)
sudo vi /etc/apt/sources.list.d/qubes-r3.list
- or for r2
sudo vi /etc/apt/sources.list.d/qubes-r2.list
Enable Whonix TEST repo (for access to qubes-whonix).
This step has to be run even if set previously though setup since whonix-setup-wizard pointed to the incorrect repos
sudo whonix_repository
Update package index
sudo apt-get update
IMPORTANT: Confirm qubes-whonix installation candidate is at least 0.10.0.5-1
sudo apt-cache policy qubes-whonix
qubes-whonix:
Installed: 9.6.2-1+wheezy1
Candidate: 0:10.0.5-1
Version table:
0:10.0.5-1 0
500 http://sourceforge.net/projects/whonixdevelopermetafiles/files/internal/ developers/main amd64 Packages
*** 9.6.2-1+wheezy1 0
100 /var/lib/dpkg/status
Expected error messages, warnings, dialog’s or prompts that require action
It should be fine to ignore any errors or warnings to do not cause dist-upgrade to fail
It is also fine to ignore a 'whonixcheckdialog may appear with following message. ClickOK`.
ERROR: Virtualizer xen xen-hvm unsupported by Whonix developers! Whonixcheck aborted!
Using Virtualizer xen xen-hvm together with Whonix is recommended against, because it is rarely tested. [1] [2] [3]
It could be made possible, but would require more Whonix contributors.
It may already work, but is highly experimental.
This might endanger your anonymity. Do not proceed unless you know what you are doing.
If you wish to ignore this warning and to continue whonixcheck anyway, you can set
WHONIXCHECK_NO_EXIT_ON_UNSUPPORTED_VIRTUALIZER="1"
in /etc/whonix.d/30_whonixcheck_default.
Recommended action:
- Shut down.
- Read Whonix documentation [4].
- Use Whonix with either VirtualBox or Physical Isolation [5].
Select Y to to install any maintainer version of files
Configuration file `/etc/whonix.d/30_whonixcheck_default'
==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ? Your options are:
Y or I : install the package maintainer's version
N or O : keep your currently-installed version
D : show the differences between the versions
Z : start a shell to examine the situation
The default action is to keep your current version.
*** 30_whonixcheck_default (Y/I/N/O/D/Z) [default=N] ?
Configuration file `/etc/apt/sources.list.d/qubes-r3.list'
==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ? Your options are:
Y or I : install the package maintainer's version
N or O : keep your currently-installed version
D : show the differences between the versions
Z : start a shell to examine the situation
The default action is to keep your current version.
*** qubes-r3.list (Y/I/N/O/D/Z) [default=N] ?
Start the Whonix 10.0 upgrade
As stated above, enter Y for configuration file replacements, and Click OK if whonixcheck dialog appears
sudo apt-get dist-upgrade
Exit status may look like the following:
Errors were encountered while processing:
timezone-utc
E: Sub-process /usr/bin/dpkg returned an error code (1)
Fix timezone installation errors
(Ignore qubes-update-check.service failed error. Will be fixed upstream)
sudo apt-get install -f
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following packages were automatically installed and are no longer required:
anon-gw-first-run-notice ksh libgtop2-7 libgtop2-common libsystemd-id128-0 libunique-3.0-0 nautilus-actions netcat-openbsd
spice-vdagent ucspi-tcp
Use 'apt-get autoremove' to remove them.
0 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.
1 not fully installed or removed.
After this operation, 0 B of additional disk space will be used.
Setting up timezone-utc (3:0.8-1) ...
Job for qubes-update-check.service failed. See 'systemctl status qubes-update-check.service' and 'journalctl -xn' for details.
E: Problem executing scripts DPkg::Post-Invoke 'systemctl start qubes-update-check.service'
E: Sub-process returned an error code
Remove configuration files that were backup up by dpkg
sudo rm /etc/whonix.d/30_whonixcheck_default.dpkg-old
Disable Whonix TEST repo (select stable)
sudo whonix-setup-wizard repository
Disable qubes TEST repo; comment out test repo (Insert ‘#’ at beginning of line)
sudo vi /etc/apt/sources.list.d/qubes-r3.list
- or for r2
sudo vi /etc/apt/sources.list.d/qubes-r2.list
Remove unneeded files
sudo apt-get autoremove
Shutdown template-vm
sudo poweroff