Jump to: navigation, search

Upgrading Whonix 13 to Whonix 14


development discussion:

High Level Overview[edit]

1. Backup your data. (Ideally have a copy of your VM, so you can try again.)
2. Consider running the optional #Sanity Tests.
3. Upgrade Whonix-Workstation.
4. Power off Whonix-Workstation.
5. Upgrade Whonix-Gatway.
6. Restart Whonix-Gateway.
7. Restart Whonix-Workstation

Sanity Tests[edit]

These are optional, but recommended. If you want to do them, please press on expand on the right.

sudo dpkg --audit ; echo $?

Expected output.

sudo dpkg --configure -a ; echo $?

Expected output:


Get package upgrades.

sudo apt-get update
sudo apt-get dist-upgrade

Test wise install python-qt4.

sudo apt-get install python-qt4 ; echo $?
## ... successful installation of python-qt4 ...


(Downloading a new Whonix-Gateway / Whonix-Workstation would be probably easier than applying the following instructions for upgrading, but this upgrade should be quite smooth.)

Backups are important as noted in above chapter #Before you start.

Consider doing the #Sanity Tests described above. They'll check if your system is affected by obvious grave issues, that you must fix before attempting to upgrade. If your package manager is broken, for example because you mixed packages from Debian stable with packages from Debian testing, then the upgrade may fail in the middle leaving your system in a difficult to resolve situation.

Consider keeping the full terminal (Konsole) log. Even if everything apparently worked, there might be issues after reboot. In case of a bug report in the forums you would be asked to share the upgrading log so the issue can be investigated.

If you are using Qubes R3.0 or R3.1 as your host operating system, you are advised to upgrade your VMs and dom0 to R3.2 before proceeding. Follow the Qubes R3.1 > R3.2 upgrade instructions on the Qubes website.

Do a usual upgrade of your system's packages from Debian.

TODO: Skip the following. (Just a reminder to update this in future.)

sudo whonix_repository --enable --codename stretch

Update Whonix apt sources list.

sudo whonix_repository --baseuri https://deb.whonix.org --enable --repository developers

Update Debian apt sources list.

sudo sed -i "s/jessie/stretch/g" /etc/apt/sources.list.d/debian.list

Qubes-Whonix only. Update Qubes apt sources list.

sudo sed -i "s/jessie/stretch/g" /etc/apt/sources.list.d/qubes-r3.list

Become root.

sudo su

Enable extensive debugging so reporting eventual bugs becomes easier.

export DEBDEBUG=1

Remove the following accessibility tools unless you are using those. (You would probably know if you are using them.) TODO: Required? (Maybe that gets fixed later during Debian stretch development.)

apt-get purge espeakup brltty

Update the package lists.

apt-get update

Upgrade torsocks and usability-misc first. [1] [2]

apt-get install torsocks usability-misc


apt-get-noninteractive dist-upgrade

Restart whonix-legacy service. [3]

service whonix-legacy restart

Update your package lists again. [4]

apt-get update

Purge packages which are deprecated in Whonix and replaced by new functionality or not required. [5]

apt-get purge iceweasel firefox-esr exim* unattended-upgrades sysfsutils cups

Get rid of old packages.

apt-get autoremove

Remember to store the terminal (Konsole) log. (File -> Save Output As)

Reboot required.




  1. Avoids some torsocks warnings due to the torsocks upgrade.
  2. Provides apt-get-noninteractive.
  3. Required to do manually, because we used apt-get-noninteractive above. Not so crucial, since it would also run after reboot.
  4. This is required because the repository uri of Whonix repository has been upgraded to the new location by the whonix-legacy package.

Random News:

Please contribute by helping to answer Whonix questions.

Impressum | Datenschutz | Haftungsausschluss

https | (forcing) onion
Share: Twitter | Facebook | Google+

This is a wiki. Want to improve this page? Help is welcome and volunteer contributions are happily considered! See Conditions for Contributions to Whonix, then Edit! IP addresses are scrubbed, but editing over Tor is recommended. Edits are held for moderation.

Whonix (g+) is a licensee of the Open Invention Network. Unless otherwise noted, the content of this page is copyrighted and licensed under the same Libre Software license as Whonix itself. (Why?)