YaCy is a p2p, censorship resistant libre search engine. It can be configured to crawl the internet and private intranets.[1]



1. Before adding the repo[2][3], fetch the key and verify[4] fingerprints. Always check the fingerprint for yourself.

2. Add YaCy apt signing key.

sudo apt-key --keyring /etc/apt/trusted.gpg.d/yacy-pubkey.gpg adv --keyserver hkp:// --recv-keys 8BD752501CB62448A30EA3EA1F968B3903D886E7

3. Add YaCy repository.

echo 'deb ./' > /etc/apt/sources.list.d/yacy.list

Update the package lists.

sudo apt-get update

Install openjdk-7-jre-headless and yacy.

sudo apt-get install openjdk-7-jre-headless yacy

To read more on managing YaCy, consult the official documentation.

2. A proxy exception in Tor Browser must be configured to interact with YaCy. Tor Browser blocks communication with localhost to mitigate some fingerprinting attacks[5]. Note that this exception has fingerprinting implications in event of a website actively abusing JavaScript, but its still much safer than using another browser [6]. To mitigate the risks completely, you are advised to disable scripts globally in NoScript and permit them only when really necessary - a good practice anyhow.

(Note: the following will be no longer required once Whonix releases a custom Tor Browser for connecting to alternative networks. [7])

Configure Tor Browser to connect to localhost.

In Tor Browser type about:config into the URL bar -> press Enter -> search for network.proxy.no_proxies_on -> Set to 0


To access the WebUI copy into the URL bar of Tor Browser and press enter.


To integrate YaCy with Tor Browser you can install the official YaCyBar add-on from Mozilla. N.B. This option is not possible right now because the add-on code needs a revamp.


Looks like socks proxy support is not coming anytime soon:

Random News:

Please help in testing new features and bug fixes in Whonix.

https | (forcing) onion

Share: Twitter | Facebook

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 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?)