Go to file
Michael Christen 331e0a24fc
Merge pull request #621 from OFA54/patch-1
turkish translation tr.lng
2023-12-20 23:34:35 +01:00
.github fixed workflow for ci process/2 2023-08-31 18:05:58 +02:00
LICENSES creating LICENSES directory 2021-03-11 12:16:37 +01:00
addon apply patches from @HenryLoenwind 2023-09-27 19:56:08 +02:00
bin fixed apicall call method parameters 2020-12-22 00:46:47 +01:00
defaults bring defaults for recrawlindex to init config 2023-12-09 01:32:31 +01:00
docker Migrated from java 8 to java 11. This step is required to upgrade certain packages, most important solr which will be migrated from 8.9 to 9.x 2023-08-31 17:52:30 +02:00
examples move example code SearchClient out of yacycore package 2016-03-14 02:22:06 +01:00
htroot added a 'minified' option to YaCy dumps 2023-11-13 10:27:50 +01:00
kubernetes removed Debian and Red Hat build process 2021-07-19 20:33:52 +02:00
langdetect Use language-detection library for increased accuracy 2015-07-02 18:41:13 +02:00
lib removed 7Zip parser because the old library could not be replaced by a maven repository 2023-07-27 23:11:27 +02:00
libt use ivy to manage jars 2022-04-08 18:33:20 +00:00
locales tr.lng 2023-11-18 01:03:28 +03:00
screenshots added screenshots 2023-09-30 13:07:18 +02:00
skins fine tuning the dark-green color scheme 2023-10-26 12:35:22 +02:00
snap Added a stop command using the existing stop script to the snap package 2019-02-04 14:34:37 +01:00
source Merge pull request #615 from okybaca/logging2 2023-12-03 16:40:21 +01:00
test fix test xlsx file with correct anchor 2022-02-07 04:24:29 +01:00
vocabularies moved yacy.logging to defaults according to request in 2012-05-17 04:26:03 +02:00
.checkstyle problems with code style 2009-06-29 22:22:35 +00:00
.classpath removed 7zip from eclipse classpath 2023-09-02 11:44:33 +02:00
.dockerignore fixed build problem from https://github.com/yacy/yacy_search_server/issues/566 2023-03-05 00:48:45 +01:00
.env Removed unnecessary variables for local heroku run 2016-07-13 01:07:11 +02:00
.gitignore removed 7Zip parser because the old library could not be replaced by a maven repository 2023-07-27 23:11:27 +02:00
.project removed ContentControl servlet and functinality 2022-09-28 17:25:04 +02:00
AUTHORS added flori and me 2008-06-13 10:05:31 +00:00
CONTRIBUTING.md Add contributor guidelines; closes #214 2018-08-15 23:23:30 +07:00
COPYRIGHT updated copyright message; included LGPL for 'cora' and a warranty 2013-06-30 11:30:39 +02:00
Heroku.md fix typo 2022-11-06 00:14:13 +08:00
NOTICE * updated jxpath to latest v1.3 2009-07-15 16:13:24 +00:00
Procfile Simplified Heroku variables configuration 2016-07-28 02:04:51 +02:00
README.md added a link to docker build guide 2023-10-29 02:35:57 +01:00
app.json Updated YaCy home page embedded links from http to https scheme 2018-05-22 17:46:12 +02:00
build.nsi Migrated from java 8 to java 11. This step is required to upgrade certain packages, most important solr which will be migrated from 8.9 to 9.x 2023-08-31 17:52:30 +02:00
build.properties Migrated from java 8 to java 11. This step is required to upgrade certain packages, most important solr which will be migrated from 8.9 to 9.x 2023-08-31 17:52:30 +02:00
build.xml removed warnings during normal build 2023-10-04 22:00:30 +02:00
fixMacBuild.sh attempt to make a Mac Release using gradle 2021-10-25 18:37:39 +02:00
getWin32MaxHeap.bat update for memory observer algorithm 2009-12-06 17:45:48 +00:00
gpl.txt initial load with yacy 0.36 2005-04-07 19:19:42 +00:00
installYaCyWindowsService.bat removed Xms java memory startup parameter 2021-07-19 20:04:11 +02:00
ivy.xml Merge pull request #612 from okybaca/sitemap-fix 2023-11-27 12:16:43 +01:00
killYACY.sh Fix for http://mantis.tokeek.de/view.php?id=432 2014-08-25 22:47:33 +02:00
lgpl21.txt migrated all my LGPL 3 -licensed files to the LGPL 2.1 because LGPL 3 is not compatible to the GPL 2 2010-06-28 16:25:14 +00:00
restartYACY.sh added a restartYACY.sh script 2023-06-19 00:37:40 +02:00
startYACY.bat for some strange reason there is no javaw in temurin, only java 2022-10-06 00:11:04 +02:00
startYACY.sh apply patches from @HenryLoenwind 2023-09-27 19:56:08 +02:00
startYACY_debug.bat changed link to new forum location 2022-02-03 13:27:06 +01:00
stopYACY.bat upd classpath in batches (remove not necessary htroot) 2016-02-03 21:50:50 +01:00
stopYACY.sh instead of WAITING lines, WAITING FOR STOP and dots are echoed 2023-08-09 12:46:21 +02:00
uninstallYaCyWindowsService.bat added Windows Service installer 2013-12-26 05:07:26 +01:00
updateYACY.sh fixed apicall call method parameters 2020-12-22 00:46:47 +01:00
yacy-packages.readme fix typo 2022-11-06 00:14:13 +08:00
yacy.yellow performance setting for remote indexing configuration and latest changes for 0.39 2005-07-22 13:56:19 +00:00



Search Engine Software

YaCy Home Page YaCy Discourse Forums become a Github Sponsor become a Patreon Member Build Status Install Link

Web Search Crawl Start Index Browser

What is YaCy?

YaCy is a full search engine application containing a server hosting a search index, a web application to provide a nice user front-end for searches and index creation and a production-ready web crawler with a scheduler to keep a search index fresh.

YaCy search portals can also be placed in an intranet environment, making it a replacement for commercial enterprise search solutions. A network scanner makes it easy to discover all available HTTP, FTP and SMB servers.

Running a personal Search Engine is a great tool for privacy; indeed YaCy was created with the privacy aspect as priority motivation for the project.

You can also use YaCy with a customized search page in your own web applications.

Large-Scale Web Search with a Peer-to-Peer Network

Each YaCy peer can be part of a large search network where search indexes can be exchanged with other YaCy installation over a built-in peer-to-peer network protocol.

This is the default operation that enables new users to instantly access a large-scale search cluster, operated only by YaCy users.

You can opt-out from the YaCy cluster operation by choosing a different operation mode in the web interface. You can also opt-out from the network in individual searches, turning the use of YaCy a completely privacy-aware tool - in this operation mode search results are computed from the local index only.


We recommend to compile YaCy yourself and install it from the git sources. Pre-compiled YaCy packages exist but are not generated on a regular basis. Automaticaly built latest developer release is available at release.yacy.net. To get a ready-to-run production package, run YaCy from Docker.

Compile and run YaCy from git sources

You need Java 11 or later to run YaCy and ant to build YaCy. This would install the requirements on debian:

sudo apt-get install openjdk-11-jdk-headless ant

Then clone the repository and build the application:

git clone --depth 1 https://github.com/yacy/yacy_search_server.git
cd yacy_search_server
ant clean all

To start YaCy, run


The administration interface is then available in your web browser at http://localhost:8090. Some of the web pages are protected and need an administration account; these pages are usually also available without a password from the localhost, but remote access needs a log-in. The default admin account name is admin and the default password is yacy. Please change it after installation using the http://<server-address>:8090/ConfigAccounts_p.html service.

Stop YaCy on the console with


Run YaCy using Docker

The Official YaCy Image is yacy/yacy_search_server:latest. It is hosted on Dockerhub at https://hub.docker.com/r/yacy/yacy_search_server

To install YaCy in intel-based environments, run:

docker run -d --name yacy_search_server -p 8090:8090 -p 8443:8443 -v yacy_search_server_data:/opt/yacy_search_server/DATA --restart unless-stopped --log-opt max-size=200m --log-opt max-file=2 yacy/yacy_search_server:latest

then open http://localhost:8090 in your web-browser.

For building Docker image from latest sources, see docker/Readme.md.

Help develop YaCy

  • clone https://github.com/yacy/yacy_search_server.git using build-in Eclipse features (File -> Import -> Git)
  • or download source from this site (download button "Code" -> download as Zip -> and unpack)
  • Open Help -> Eclipse Marketplace -> Search for "ivy" -> Install "Apache IvyDE"
  • right-click on the YaCy project in the package explorer -> Ivy -> resolve

This will build YaCy in Eclipse. To run YaCy:

  • Package Explorer -> YaCy: navigate to source -> net.yacy
  • right-click on yacy.java -> Run as -> Java Application

Join our development community, got to https://community.searchlab.eu

Send pull requests to https://github.com/yacy/yacy_search_server

APIs and attaching software

YaCy has many built-in interfaces, and they are all based on HTTP/XML and HTTP/JSON. You can discover these interfaces if you notice the orange "API" icon in the upper right corner of some web pages in the YaCy web interface. Click it, and you will see the XML/JSON version of the respective webpage. You can also use the shell script provided in the /bin subdirectory. The shell scripts also call the YaCy web interface. By cloning some of those scripts you can easily create more shell API access methods.


This project is available as open source under the terms of the GPL 2.0 or later. However, some elements are being licensed under GNU Lesser General Public License. For accurate information, please check individual files. As well as for accurate information regarding copyrights. The (GPLv2+) source code used to build YaCy is distributed with the package (in /source and /htroot).


Visit the international YaCy forum where you can start a discussion there in your own language.

Questions and requests for paid customization and integration into enterprise solutions. can be sent to the maintainer, Michael Christen per e-mail (at mc@yacy.net) with a meaningful subject including the word 'YaCy' to prevent it getting stuck in the spam filter.

  • Michael Peter Christen