<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:
<p>Installation of YaCy is VERY EASY! Just follow the <b>simple three steps</b> for either <ahref="#linuxinst">Linux</a>, <ahref="#macinst">Macintosh</a> or <ahref="#wininst">Windows</a> operating systems. If you upgrade from a previous version of YaCy, please see the <ahref="#upgradeinst">Upgrade Instructions</a>.
<p>Just double-click the Installer file. The installer will ask you about some settings: simply use the default options.</p>
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>
<p>The installer creates a link to the application on the desktop. Just double-click the 'YACY Console' icon.</p>
<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
.. and start the YaCy start script:<br>
'localhost,127.0.0.1,192.168*,10*', which should be fine in most cases.
<tt>> ./startYACY.sh</tt><br>
</p>
</td></tr>
<tr><tdwidth="20%"valign="top"><b>3rd Step:<br>Administrate YaCy<br>with your Web Browser</b></td><tdwidth="80%">
<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.
You should set an administration password there.
The default settings are fine, so please change them only if you know what they mean.
All the other 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.
</p>
</p>
</td></tr>
</td></tr>
</table></p>
</table></p>
<h3><aname="upgradeinst"></a>If you upgrade from a previous version of YaCy:</h3>
<tr><tdwidth="20%"valign="top"><b>migrate your data</b></td><tdwidth="80%">
<p>There is a DATA directory in your current installation that holds all your data that you created during the last YaCy run-time:</p>
<p>If you have a windows installation, first de-install YaCy using the YaCy de-installer and answer to the question 'keep DATA' with 'yes'. Then simply run the installer of the new YaCy release.</p>
<p>If you have a Linux or Macintosh system, first decompress the new YaCy release and then move the DATA directory from the old installation path to the new installation path.</p>
</td></tr>
</table></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>-->
orbiter
19 years ago