Jump to: navigation, search



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. The output at the moment is:

pub  2048R/0x1F968B3903D886E7 2012-01-07 Michael Peter Christen <mc@yacy.net>
      Key fingerprint = 8BD7 5250 1CB6 2448 A30E  A3EA 1F96 8B39 03D8 86E7

Download key with curl to home folder.

curl -o yacy-pubkey.asc http://debian.yacy.net/yacy_orbiter_key.asc

Check fingerprints/owners without importing anything.

gpg --keyid-format long --with-fingerprint yacy-pubkey.asc

If it looks good import into trusted.gpg.d.

gpg --no-default-keyring --keyring ./yacy-pubkey.gpg --import yacy-pubkey.asc
sudo cp yacy-pubkey.gpg /etc/apt/trusted.gpg.d/yacy-pubkey.gpg
echo 'deb http://debian.yacy.net ./' > /etc/apt/sources.list.d/yacy.list 
sudo apt-get update -qq
sudo apt-get install openjdk-7-jre-headless 
sudo apt-get install 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.

To reconfigure Tor Browser so you can access the local web interface, apply the following six steps.

TODO: Check with TBB series 7.0+ once it becomes stable. There are alpha series bug reports that it doesn't work https://forums.whonix.org/t/new-version-of-tbb-no-longer-accepts-foxyproxy-plugin/2565/32

Step One: Make the tbb-foxyproxy config file available to Tor Browser. [7] [8]


cp /usr/share/usability-misc/tbb-foxyproxy/foxyproxy.xml /home/user/.tb/tor-browser/Browser/TorBrowser/Data/Browser/profile.default/

Step Two: Download and install the add-on:

Browser Settings -> Add-ons -> Search: "foxyproxy" -> Install: FoxyProxy Standard

This is safe to do since all add-ons on Mozilla's servers are now signed and verified by FireFox 43+.[9]

Step Three: Restart Tor Browser.

To reverse this and restore the default Tor Browser fingerprint its best to use a VM snapshot taken before installing the add-on. Re-downloading Tor Browser is another option in case no snapshot was taken. Alternatively FoxyProxy can be removed via about:addons -> Extensions menu.

Note: Tor Browser will soon ship with sandboxing on an opt-in basis. Unfortunately the initial sandbox versions are incompatible with such configurations and must not be enabled.[10]

3. To access the WebUI open in Tor Browser.


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:

We are looking for help in managing our social media accounts. Are you interested?

Impressum | Datenschutz | Haftungsausschluss

https | (forcing) onion
Share: Twitter | Facebook | Google+
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 (g+) is a licensee of the Open Invention Network. Unless otherwise noted above, the content of this page is copyrighted and licensed under the same Free (as in speech) license as Whonix itself.
  1. https://www.digitalocean.com/community/tutorials/how-to-configure-yacy-as-an-alternative-search-engine-or-site-search-tool
  2. http://debian.yacy.net/
  3. http://www.yacy-websuche.de/wiki/index.php/En:DebianInstall
  4. http://debian.yacy.net/yacy_orbiter_key.asc
  5. https://phabricator.whonix.org/T291#5252
  6. https://trac.torproject.org/projects/tor/ticket/10419#comment:37
  7. https://github.com/Whonix/usability-misc
  8. https://github.com/Whonix/usability-misc/blob/master/usr/share/usability-misc/tbb-foxyproxy/foxyproxy.xml
  9. https://wiki.mozilla.org/Add-ons/Extension_Signing
  10. https://lists.torproject.org/pipermail/tor-dev/2016-December/011733.html