What is this?
YaCy is a distributed Web Search Engine, based on a peer-to-peer network.
What does indexing mean?
Indexing means that a web page is separated into the single words on it and to save the URLs to the sites containing them under a reference to the word itself in a database. So searching for a word (or many words) may be easily performed by fetching all URLs "belonging" to the search term.
What is a DHT?
A distributed hash table (DHT) is a class of a decentralized distributed system that provides a lookup service similar to a hash table; (key, value) pairs are stored in a DHT, and any participating node can efficiently retrieve the value associated with a given key. Responsibility for maintaining the mapping from keys to values is distributed among the nodes, in such a way that a change in the set of participants causes a minimal amount of disruption.(source:Wikipedia)
What's the meaning of "to crawl"?
A so-called "crawler" fetches a web page and parses out all links on it; this is the first step or "depth 0". It continues to get all web pages linked on the first document which is then called "depth 1" and does the same respectively for all documents of this step. The crawler is limitable to a specified depth or can even crawl indefinitely and so can crawl the whole "indexable Web", including those parts of the indexable web who are censored by commercial search-engines and therefore normally not part of what most people are presented as The visible web.
What is a P2P network?
Meaning Peer to Peer computing or networking is a distributed application architecture that partitions tasks or work loads between peers. Peers are equally privileged, equipotent participants in the application. They are said to form a peer-to-peer network of nodes. Peers make a portion of their resources, such as processing power, disk storage or network bandwidth, directly available to other network participants, without the need for central coordination by servers or stable hosts. Wikipedia
What is a Peer?
A peer is a communications endpoint in a computer network. Each peer offers its services and uses the services of other peers. In YaCy, a peer provides web indexing services to other peers on the YaCy search network.
What is RWI?
RWI is an acronym for Reverse Word Index. This is generated by the indexer from the collected data and stored in the database.
Isn't P2P illegal?
No. P2P (peer to peer) only describes the technology by which computers exchange data amongst themselves. Past legal disputes have been over what types of data have been exchanged over such networks. Namely, copyrighted material. The P2P file sharing technique itself is legal, despite the fact that it has been used facilitate in the transfer of copyrighted data. The only files shared amongst YaCy peers are indexes of the publicly accessible internet.
YaCy in general
What are global and local indexes?
Once you use the proxy, a local copy of the indexed data is automatically created. You can access the global index only if the program has a connection to the YaCy network. This is effectively the combination of all local indexes.
I am not a technican. Can I install YaCy easily and use it to index my own web pages?
YaCy is very easy to install. You don't need any special knowledge or additional software; also you don't need to set up an extra database engine. Indexing your own website isn't hard too: Simply crawl it and turn off DHT Distribution and DHT Receive to keep the index of your site on your peer.
Can I crawl and index the web with YaCy?
Yes. You can start your own crawl and you may also trigger distributed crawling, which means that your own YaCy peer asks other peers to perform specific crawl tasks. You can specify many parameters that focus your crawl to a limited set of web pages.
Is there a central server? Does the search engine network need one?
No. The YaCy network architecture does not need a central server, and there is none. There are currently four so-called seed-list servers hard-coded into source code due to they are mostly available and have accurate seed list information (see FAQ for details).
Search Engines need a lot of terabytes of space, don't they? How much space do I need on my machine?
The global index is shared, but not copied to the peers. If you run YaCy, you need an average of the same disc memory amount for the index as you need for the cache. In fact, the global space for the index may reach the space of Terabytes, but not all of that on your machine!
Do I need a fast machine? Search Engines need big server farms, don't they?
You don't need a fast machine to run YaCy. You also don't need a lot of space. You can configure the amount of Megabytes that you want to spend for the cache and (currently only indirectly) the index. Any time-critical task is delayed automatically and takes place when you are idle surfing (this works only if you use YaCy as http proxy).
How long does a search take?
Time for a search depends on many factors. One is, if you perform a local-only search or a global DHT-based search. Another factor comes in place when enable search heuristics. A third and important factor is if you have already searched for it often (short time between two same searches), in this case the search may still be cached. Another factor is if the parameter verify=true, if so the fetched HTML snippet got verified, say fetched again. If you use verify=false this may give you less accurate search results (wrong maybe) but they are way faster.
In general YaCy's architecture does not do peer-hopping, it also doesn't have a TTL (time-to-live). It is expected that search results are instantly responded to the requester. This can be done by asking the index-owning peer directly which is in fact possible by using DHT's (distributed hash tables). Because YaCy needs some redundancy to compensate for missing peers, it asks several peers simultaneously. To collect their response, YaCy waits a little time of at most 6 seconds (by default, you can change that).
Do I need to set up and run a separate database?
No. YaCy contains its own database engine, which does not need any extra set-up or configuration.
What kind of database do you use? Is it fast enough?
The database stores either tables or property-lists in files with the structure of AVL-Trees (which are height-regulated binary trees). Such a search tree ensures a logarithmic order of computation time. For example a search within an AVL tree with one million entries needs an average of 20 comparisons, and at most 24 in the worst case. This database is therefore extremely fast. It lacks an API like SQL or the LDAP protocol, but it does not need one because it provides a highly specialized database structure. The missing interface pays off with a very small organization overhead, which improves the speed further in comparison to other databases with SQL or LDAP api's. This database is fast enough for millions of indexed web pages, maybe also for billions.
Why do you use your own database? Why not use mySQL or openLDAP?
The database structure we need is very special. One demand is that the entries can be retrieved in logarithmic time and can be enumerated in any order. Enumeration in a specific order is needed to create conjunctions of tables very fast. This is needed when someone searches for several words. We implement the search word conjunction by pairwise and simultanous enumeration/comparisment of index trees/sequences. This forces us to use binary trees as data structure. Another demand is that we need the ability to have many index tables, maybe millions of tables. The size of the tables may be not big in average, but we need many of them. This is in contrast of the organization of relational databases, where the focus is on management of very large tables, but not of many of them. A third demand is the ease of installation and maintenance: the user shall not be forced to install a RBMS first, care about tablespaces and such. The integrated database is completely service-free.
What does Virgin, Junior, Senior, Principal Status mean?
- Status Virgin means your peer did not have contact to the network yet. Simply put, you are "offline". You can search the local index only.
- Status Junior means your peer has contact to the yacy network but cannot be reached by other peers. One reason could be a firewall or missing router configuration. You can search the local index only. Junior peers can contribute to the network by submitting index files to senior/principal peers without being asked.
- Status Senior means your peer has contact to the yacy network and can be reached by other peers. It is now an access point for index sharing and distribution. You can search the local and global index. This is the best status to use, it supports the network.
- A Principal is a Senior peer that uploaded an additional peer-list to a server. This list supports other peers to get in contact with the existing Yacy network to perform a global search. If you have the possibility to upload a file to an FTP server, you can become a Principal by uploading your peer-list.
Why should I run my peer in Senior Mode?
Some p2p-based file sharing software assign non-contributing peers very low priority. We think that that this is not always fair since sometimes the operator does not have the choice of opening the firewall or configuring the router accordingly. Our idea of 'information wares' and their exchange can also be applied to junior peers: they must contribute to the global index by submitting their index actively, while senior peers contribute passively. Therefore we don't need to give junior peers low priority: they contribute equally, so they may participate equally. But enough senior peers are needed to make this architecture functional.
Since any peer contributes almost equally, either actively or passively, it is not mandatory. However, since any peer can add to the index, but what is added can only be stored on and found through senior peers, you should decide to run in Senior Mode if you can.
Even if only 1/10 of the peers which were Junior as of March 2012 become Senior, the network’s capacity will grow considerably.
My peer says it runs in 'Junior Mode'. How can I run it in Senior Mode?
Open your firewall for port 8090 (or the port you configured) or program your router to forward this port to your computer.
Will running YaCy jeopardize my privacy?
YaCy respects user privacy. All password- or cookies-protected pages are excluded from indexing. Additionally, pages loaded using
POST parameters are not indexed by default. Thus, only publicly accessible, non-password-protected pages will be indexed.
For a detailed explanation on the technique: How YaCy protects your privacy wrt to personalized pages.
Can other people find-out about my browsing log/history?
There's no way to browse the pages that are stored on a peer. A search of the pages is only possible on a precise word. The words are themselves dispatched over the peers thanks to the distributed hash tables (DHT). Then the hash tables of the peers are mixed, which makes retrieving the history of browsing of a certain peer impossible.
My YaCy search pages doesn't show!
The default address for the YaCy search and administration page is http://localhost:8090. If you are using Internet Explorer, please mind adding http:// before localhost:8090. In case you have changed the default port of YaCy from 8090 to another one, you will have to open the new port in your firewall or router (and maybe close the port 8090 if you don't use it). Another reason could be a bad setting of the proxy, in which case you need to deactivate the proxy for the local pages.
Why does YaCy show different results from Google?
We expect YaCy to show different results than Google, for several reasons. As long as YaCy has only a few peers working, it cannot compete with Google. Hence the importance of having a great number of YaCy peers working. But even then YaCy will provide different and better results than Google, since it can be adapted to the user's own preferences and is not influenced by commercial aspects.
I can not uninstall, because YaCy is still running
First check whether YaCy still runs. If it doesn't run, it may not have been shut down properly. Start YaCy again, then uninstall. Alternatively delete the yacy.running file in the yacy/DATA/ directory, then uninstall.
How can I help?
First of all: run YaCy in senior mode. This helps to enrich the global index and to make YaCy more attractive. If you want to add your own code, you are welcome; but please contact the author first and discuss your idea to see how it may fit into the overall architecture. You can help a lot by simply giving us feedback or telling us about new ideas. You can also help by telling other people about this software. And if you find a bug or you see an uncovered use-case, we welcome your bug-report. Any feed-back is welcome.
Something seems not to be working properly ; what should I do?
YaCy is still undergoing development, so one should opt for a stable version for use. The latest stable version can be downloaded from the YaCy homepage http://www.yacy.net. If you are experiencing a strange behaviour of YaCy then you should search the Wiki or the forum http://www.yacy-forum.org/ for known issues. If the issue is unknown, then you can ask for help on the forum (and provide the YaCy version, details on the occurrence of the issue, and if possible an excerpt from the log file in order to help fix the bug).
How can I index Tor or Freenet pages?
The indexing of Tor or Freenet pages is for the moment deliberately avoided in the source code because it is not desired to index these pages at this stage of the development of YaCy. However, the crawling of such sites is planned in the future, however, most likely the crawl results will not distributed globally, but will only be available to the local peer.
How do I give the index of one peer to another?
This actually happens automatically through the DHT distribution of the words. However, there is also the possibility of transferring the entire index to another peer. This can either be done through a so-called Index-Transfer (link needs update) or a index-Import (link needs update).
Which data types / mime type are indexed by YaCy?
By default YaCy will only index html and text files, i.e. files with the mime types:
- text / plain
- text / html
- application / xhtml + xml
In order to index other file types you can install the corresponding optional package of YaCy. This additional package contains other useful parsers for additional content like PDF, DOC, RTF, RSS and other formats. For a complete list of supported formats see here.
Will already-indexed pages (i.e. indexed and index-exchanged) automatically be reindexed after a few days/years?
Unfortunately no. However, there is the possibility for a chronological "recrawl" to be executed for a URL (or an entire website if desired). Learn more about this feature under "Index Control -> Index Creation."
Are DHT entries unique in a search network or can URLs also appear twice or three times?
URLs are analyzed more than once so that a peer delayed does not lose his part in the search index. As for the indexes they are stored redundantly on multiple peers.
How can I change the Connection Timeout value?
This can be done on the configuration page "Admin Console" -> "Advanced behavior" http://localhost:8090/ConfigProperties_p.html. Just search for the line
client-timeout "and change the value there. The timeout is in milliseconds.
Do not forget to restart YaCy after the change.
Alternatively, another way to do is through the configuration file
DATA/SETTINGS. If this type of configuration is to be performed then YaCy must be stopped before.
What should I do before the YaCy robot crawls my website?
In order to prevent YaCy from crawling your website, a robots.txt file should be created with the following content:
User-Agent: yacy Disallow: /
Otherwise the robots themselves can not be controlled, since everyone of them is run by a YaCy user, and not centrally by the YaCy project.
I can not log in YaCy anymore as I forgot my password. How do I reset my password?
If you have lost your password, you can reset it (or choose a new one). There are two methods:
Password reset while YaCy is running
This is the most convenient way. You don't need to shut down YaCy:
- use a command line terminal and log in to the user account running YaCy
- execute <yacy-app>/bin/passwd.sh <new-password>
This changes only the admin account password for the account named 'admin'.
Password reset while YaCy is shut down
Edit the file DATA/SETTINGS/yacy.conf:
- remove the entry serverAccountBase64MD5
- remove the entry adminAccount (if any)
- choose a new password by setting the entry serverAccount to <account>:<password>, for example serverAccount=admin:mysecretpassword
The next time you start YaCy the account/password combination will be read, encrypted and then deleted from yacy.conf, so that it will not be available in plain text anywhere anymore.
Then you will be able to log again into YaCy with the account/password you entered in the yacy.conf file, or set another password if you didn't set a combination.
How can I limit the size of single files to be downloaded?
The maximum file size can be set under Advanced settings-> Crawler settings. Maximum sizes can be specified for HTTP and FTP. The file size is in bytes. A converter can be found at Bit and Byte (bits and bytes) (broken link)
The number of storable links/words is theoretically not limited, but it becomes actually limited following the slowdown of the indexing process with the increase of the links/words number. There are users with more than 10 million Web pages indexed in their YaCy instance. Also, the necessary space for the index of a web page depends on the size and nature of the document. With 10 million web pages indexed, an index size of 20GB is not uncommon.
Can I limit the size of the indexes on my hard-drive?
For the moment not directly. Automatically limiting that size would mean having to delete stored indexes, which is not suitable.
- A discussion on this topic is taking place in the German-version forum: http://forum.yacy-websuche.de/viewtopic.php?f=5&t=2328
- You can set two minimums of free disk space at /Performance_p.html: one for the crawls, and the other for DHT-in. The number for crawls seems to have to be equal or bigger than the number for DHT-in. Note that, with DHT-in disabled, global searching using the peer's UI is disabled. Also proxy/crawling privacy might suffer.
- You can also just disable “Index Receive” at /ConfigNetwork_p.html, so that your index is only augmented through crawling (over which you have some control).
- For a very indirect additional limit, you can change the Index Reference Size at /IndexControlRWIs_p.html.
FAQ wish-list / TODO-list
Questions that should be included:
- Why is there no support for MySQL in YaCy?
- Man sollte den Speicherplatz nachträglich, bzw. generell ändern können.
- What are those Active, Passive and Potential peers at /Network.html?
- Does a YaCy network get rid of the data about non-existent pages?