<!DOCTYPE HTML PUBLIC "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension//EN" [
<!ENTITY base CDATA "..">
<!ENTITY date "$FreeBSD$">
<!ENTITY title "Mirroring the FreeBSD Web Pages">
<!ENTITY % navinclude.docs "INCLUDE">
]>

<html>
&header;

<p>You can (and are encouraged to) mirror the FreeBSD web pages 
<tt>www.FreeBSD.org</tt>. 

To do this, you need to obtain and install
a program called <em>cvsup</em> on your web server. 

<a href="&url.doc.base;/books/handbook/cvsup.html#CVSUP-INSTALL">CVSup</a> is a software package for
distributing and updating collections of files across a network.</p>

<h2>Installing CVSup</h2>

<p>You can build and install it from source by the following commands:</p>

<pre>
 # cd /usr/ports/net/cvsup-without-gui
 # make all install clean
</pre>

<p>However, installing precompiled package from the FreeBSD
<a href="&url.doc.base;/books/handbook/packages-using.html">packages
collection</a> may be much easier.
Refer to the chapter mentioned for the details.</p>

<h2>Running CVSup</h2>

<p>If you keep your mirrored FreeBSD web pages in the directory
<tt>/usr/FreeBSD-mirror</tt> and are owned by the user `fred', then
run the following command as user `fred':</p>

<pre>
     $ cvsup supfile-www
</pre>

The file <tt>supfile-www</tt> contain:
<pre>
       *default host=cvsup.FreeBSD.org
       *default prefix=/usr/FreeBSD-mirror
       *default base=/usr/local/etc/cvsup
       www release=current delete use-rel-suffix compress
</pre>

<p>This will mirror the FreeBSD web pages into
<tt>/usr/FreeBSD-mirror</tt>. You can install this into fred's
crontab, so that it runs once a day. The pages on www.FreeBSD.org are
updated daily at about 4:30am California time.</p>

<h2>More Information on CVSup</h2>

See the <a href="&url.doc.base;/books/handbook/synching.html#CVSUP">CVSup introduction</a> in the
handbook.

<p><a href="internal.html">FreeBSD Internal Home</a></p>
&footer;

</body>
</html>
