Security warning: Adding a third party repository allows the vendor to replace any package on your system. Proceed at your own risk! See Foreign Sources for further information. For greater safety, users adding third party repositories should always use Multiple Whonix-Workstations to compartmentalize VMs with additional software.
1. Check the YaCy key fingerprint.
2. Add YaCy apt signing key.
sudo apt-key --keyring /etc/apt/trusted.gpg.d/yacy-pubkey.gpg adv --keyserver hkp://ipv4.pool.sks-keyservers.net:80 --recv-keys 8BD752501CB62448A30EA3EA1F968B3903D886E7
3. Add YaCy repository.
echo 'deb http://debian.yacy.net ./' > /etc/apt/sources.list.d/yacy.list
Update the package lists.
sudo apt-get update
sudo apt-get install openjdk-7-jre-headless yacy
To read more on managing YaCy, consult the official documentation.
Tor Browser Proxy Exception
Note: The following steps will no longer be required once Whonix releases a custom Tor Browser for connecting to alternative networks. 
Configure Tor Browser to connect to localhost.
In Tor Browser:
about:configinto the URL bar.
- Search for
- Set to
To access the WebUI, copy
127.0.0.1:8090 into the URL bar of Tor Browser and press
Note: YaCy cannot be integrated with Tor Browser because the official YaCyBar add-on from Mozilla is incompatible with Firefox Quantum and was last updated in 2011. Unless the add-on code is revamped, this option will remain impossible at present.
SOCKS proxy support is very unlikely in the near-medium term, as the relevant developer ticket has not been updated since 2013, see: http://mantis.tokeek.de/view.php?id=219
- Except in the case of YaCy, which needs internet access.
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.