<p>Since we provide YaCy as a generic release for all operation systems and a special 'flavour' for Windows users, we distinguish two different processes for installation. Windows users may want to <ahref="#wininst">switch to the Windows installation instructions</a>, however, the following description is more general and applies to all operation systems:
the latest release, simply decompress the archive with your favourite tool
(which can be WinRar or WinZip on Windows, or Stuffit Expander on Mac OS X; Linux
users type 'gunzip <release>.tar.gz' and 'tar -xf <release>.tar') and move the result to any place you want.</p>
<p>If you upgrade from a previous version of YACY, <b>please migrate your settings and data</b>.
This is very easy: simply move (not copy) your DATA directory from the application root directory of the old YACY installation to the new application root directory. If done so, you don't need to do the other remaining configuration steps below again.</p>
<p>Change the proxy settings either in your network configuration or directly in you browser. Check the 'Use HTTP Proxy' flag and configure the IP and port according to the location of the proxy. If you do a single-user installation without changing the configuration in #2, the IP/Host shall be set to '127.0.0.1' or 'localhost', and the Port shall be set to '8080'.</p>
See the 'Settings' menu: you should set an administration password and checkt the access rules.
The default settings are fine, so please change them only if you know what they mean.
</td></tr>
<tr><tdwidth="30%"valign="top"><b>5th Step:<br>Use YACY and it's search service</b></td><tdwidth="70%">
<p>Browse the internet using your web-browser. You should notice that your actions take effect as cache fill/cache hit log's in the httpProxy's terminal window. Whenever you vistited a page through the proxy, the page is indexed and can be search using the search page at
Please be aware that if your settings allow to access the http-server, then anybode else can also search your index as well. If you don't want this, you must set the 'IP-Number filter' of the 'Server Access Settings' in the 'Settings' menu to a string that applies to you local network scheme, like
'localhost,127.0.0.1,192.168*,10*', which should be fine in most cases.
</p>
</td></tr>
</table></p>
<h3><aname="wininst"></a>Instructions for Windows and the Internet Explorer</h3>
<p>In your Internet Explorer, open 'Extras' -> 'Internet Options':<br>
<imgsrc="grafics/TutorialDWin1.gif"></p>
<p>Select 'Connections':<br>
<imgsrc="grafics/TutorialDWin2.gif"></p>
<p>Click on 'Settings' of the 'LAN-Settings', even if you are using a dial-up connection:<br>
<imgsrc="grafics/TutorialDWin3.gif"></p>
<p>Check the 'Proxyserver' check-box:<br>
<imgsrc="grafics/TutorialDWin4.gif"></p>
<p>Enter the location of YACY server. If YACY runs on the same machine as the Browser, set 'localhost'. If you have not changed the initial configuration, the port is '8080'. Check the 'No Proxy for local addess' button. Then hit 'Extended':
<imgsrc="grafics/TutorialDWin5.gif"></p>
<p>Un-check the 'Use the same server for all protocols' - button. Then remove the proxy setting from 'FTP', 'Gopher' and 'Socks'. In the 'Exceptions' field, enter 'localhost;192.168;10':
See the 'Settings' menu: you should set an administration password and checkt the access rules.
The default settings are fine, so please change them only if you know what they mean.
</td></tr>
<tr><tdwidth="30%"valign="top"><b>5th Step:<br>Use YACY and it's search service<br></b></td><tdwidth="70%">
<p>Browse the internet using your web-browser. You should notice that your actions take effect as cache fill/cache hit log's in the httpProxy's terminal window. Whenever you vistited a page through the proxy, the page is indexed and can be search using the search page at
Please be aware that if your settings allow to access the http-server, then anybode else can also search your index as well. If you don't want this, you must set the 'IP-Number filter' of the 'Server Access Settings' in the 'Settings' menu to a string that applies to you local network scheme, like
'localhost,127.0.0.1,192.168*,10*', which should be fine in most cases.