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



1. Check the YaCy key fingerprint.

Before adding the repository, [2] [3] fetch the key and verify [4] the fingerprint. 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

4. 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.

Tor Browser Proxy Exception[edit]

A proxy exception must be configured in Tor Browser to interact with YaCy. Tor Browser blocks communication with localhost to mitigate some fingerprinting attacks. [5] Note that this exception has fingerprinting implications in the event a website actively abuses JavaScript, but it is still far safer than using another browser. [6] To completely mitigate the risk, it is advised to disable scripts globally with the NoScript extension and only permit JavaScript when absolutely necessary; a sensible anonymity practice.

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

Configure Tor Browser to connect to localhost.

In Tor Browser:

  1. Type about:config into the URL bar.
  2. Press Enter
  3. Search for network.proxy.no_proxies_on
  4. Set to 0


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

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:


Random News:

Please consider a recurring payment for your Priority Support!

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