Whonix ™ APT Repository Overview
Whonix ™ currently provides four repository choices:
- Whonix ™ stable APT repository: Recommended for most users. The production level packages focus on providing the most reliable Whonix ™ experience. 
- Whonix ™ stable-proposed-updates APT repository: After testing by a wider audience, these packages migrate to the stable repository. 
- Whonix ™ testers APT repository: Recommended for testers, since it is only briefly tested by Whonix ™ developers. It could break apt-get during an upgrade, requiring terminal commands to rectify the problem. 
- Whonix ™ developers APT repository: As above, except it includes untested changes. These changes may eventually migrate to the testers repository if the Whonix ™ team is confident these changes will not break the update system. It is not recommended, unless the user is in touch with the development team.
Due to the Whonix ™ design, a user's security is unlikely to be materially affected by preferring the "beta" (stable-proposed-updates) or "alpha" (testers) repositories over the default stable one. 
Change Whonix ™ APT Repository
It is easy for users to switch between Whonix ™ repositories.
If you are using Qubes-Whonix ™, please press Expand on the right.
If you are using Non-Qubes-Whonix ™, please press Expand on the right.
Afterwards, the following window will appear.
Figure: Auto-update Configuration
Figure: Repository Selection
Command Line Interface
If you are a terminal user, please press Expand on the right.
In Terminal, run.
Figure: Launch Terminal
Figure: Run whonix_repository
Choose one of the following repositories based on personal preferences.
sudo whonix_repository --enable --repository stable
sudo whonix_repository --enable --repository stable-proposed-updates
sudo whonix_repository --enable --repository testers
sudo whonix_repository --enable --repository developers
To use the repository, follow the usual update instructions.
Disable Whonix ™ APT Repository
For Trust reasons some users may prefer not to use Whonix ™ APT Repository. In that case, it is necessary to update Debian packages in Whonix ™ from source code, which is inconvenient.
All Default-Download-Version Whonix ™ variants have the Whonix ™ APT repository enabled. It can be disabled via the GUI or in a terminal with the Whonix ™ repository tool.
Table: Whonix ™ APT Repository Disabling
|Platform / Method||Instructions|
|Whonix ™ Built from Source Code||If Whonix ™ is built from source code, Whonix ™ APT Repository is not added by default. The only exception is if users opt in using a build configuration. It is also possible to verify that it is already disabled.|
|Whonix ™ Default-Download-Version: GUI||
|Whonix ™ Default-Download-Version: Terminal||To disable it in a terminal, run. |
sudo whonix_repository --disable
Users can optionally verify Whonix ™ APT repository is disabled after this procedure.
Verify Whonix ™ APT Repository is Disabled
To check the Whonix ™ APT repository was successfully disabled, run the following tests.
- Whonix ™ Debian package - which ones are safe to remove?
- Building/upgrading Whonix ™ Debian packages from source code
Footnotes / References
- If possible, users are requested to run a separate testers-only Whonix-Gateway ™ (
sys-whonix) and Whonix-Workstation ™ (
anon-whonix) that has the testers repository enabled. If too few people test Whonix ™, undiscovered issues might migrate to the stable repository.
- Users are recommended to make a VM clone for this repository just in case it breaks. That way changes can be rolled back if necessary.
- The terms alpha and beta are avoided because they have generally lost their meaning in the software field; many applications remain in alpha or beta status for years, even though they work perfectly well.
This is a wiki. Want to improve this page? Help is welcome and volunteer contributions are happily considered! Read, understand and agree to Conditions for Contributions to Whonix ™, then Edit! Edits are held for moderation.
Copyright (C) 2012 - 2019 ENCRYPTED SUPPORT LP. Whonix ™ is a trademark. Whonix ™ is a licensee [archive] of the Open Invention Network [archive]. Unless otherwise noted, the content of this page is copyrighted and licensed under the same Freedom Software license as Whonix ™ itself. (Why?)