From Whonix


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

YaCy is a free search engine that anyone can use to build a search portal for their intranet or to help search the public internet. When contributing to the world-wide peer network, the scale of YaCy is limited only by the number of users in the world and can index billions of web pages. It is fully decentralized, all users of the search engine network are equal, the network does not store user search requests and it is not possible for anyone to censor the content of the shared index. We want to achieve freedom of information through a free, distributed web search which is powered by the world's users. ... The resulting decentralized web search currently has about 1.4 billion documents in its index (and growing - download and install YaCy to help out!) and more than 600 peer operators contribute each month. About 130,000 search queries are performed with this network each day.

This means it is unnecessary to rely upon centralized professional search engines and their proprietary software. Instead, hundreds of peer operators can serve search queries in a decentralized fashion.



warning 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-Workstation ™ to compartmentalize VMs with additional software.

1. Check the YaCy key fingerprint.

Before adding the repository, [3] [4] fetch the key and verify [5] 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 -- see footnote. [6]

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

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

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. [7] 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. [8] 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. [9]

Configure Tor Browser to connect to localhost.

Ambox warning pn.svg.png Warning:

  • This step changes the web fingerprint of Tor Browser!
  • Leave all other settings as is!

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
  5. Search for network.proxy.allow_hijacking_localhost
  6. Set to false


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 [archive] 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: Support for "Remote" SOCKS Proxies [archive].


Follow: Twitter.png Facebook.png 1280px-Gab text logo.svg.png Rss.png Matrix logo.svg.png 1024px-Telegram 2019 Logo.svg.png Discourse logo.svg

Donate: Donate Bank Wire Paypal Bitcoin accepted here Monero accepted here Contriute

Whonix donate bitcoin.png Monero donate whonix.png

Share: Twitter | Facebook

https link onion link

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

Whonix ™ is a derivative of and not affiliated with Debian [archive]. Debian is a registered trademark [archive] owned by Software in the Public Interest, Inc [archive].

Whonix ™ is produced independently from the Tor® [archive] anonymity software and carries no guarantee from The Tor Project [archive] about quality, suitability or anything else.

By using our website, you acknowledge that you have read, understood and agreed to our Privacy Policy, Cookie Policy, Terms of Service, and E-Sign Consent. Whonix ™ is provided by ENCRYPTED SUPPORT LP. See Imprint.