YaCy Decentralized Search Engine

From Whonix
Jump to navigation Jump to search
YaCy Logo

Yacy p2p Censorship Resistant Search Engine

Documentation for this is incomplete. Contributions are happily considered! See this for potential alternatives.

Info This page is archived.

Outdated. Volunteer contributions to update this wiki page are welcome.


YaCyarchive.org 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.



Official installation instructionsarchive.org for Debian.

To read more on managing YaCy, consult the official documentationarchive.org.

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. [3] 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. [4] 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. [5]

Configure Tor Browser to connect to localhost.


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

Figure: YaCy in Whonix


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 Proxiesarchive.org.


We believe security software like Whonix needs to remain open source and independent. Would you help sustain and grow the project? Learn more about our 12 year success story and maybe DONATE!