06689854ae 2008-05-17       drh: <nowiki>
d87ca60c58 2008-05-15   stephan: <h1>Installing Fossil</h1>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <p>This page describes how to build and install Fossil.  The
d87ca60c58 2008-05-15   stephan: whole process is designed to be very easy.</p>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <h2>0.0 Using A Precompiled Binary</h2>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <p>You can skip steps 1.0 and 2.0 below by downloading
16094f7ebc 2008-05-16       drh: a <a href="http://www.fossil-scm.org/download.html">precompiled binary</a>
d87ca60c58 2008-05-15   stephan: appropriate for your platform.  If you use a precompiled binary
d87ca60c58 2008-05-15   stephan: jump immediate to step 3.0.</p>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <h2>1.0 Obtaining The Source Code</h2>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <p>Fossil is self-hosting, so you can obtain a ZIP archive containing
d87ca60c58 2008-05-15   stephan: a snapshot of the latest version directly from fossil's own fossil
d87ca60c58 2008-05-15   stephan: repository.  Follow these steps:</p>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <ol>
d87ca60c58 2008-05-15   stephan: <li><p>Pointer your webbrowser at
d87ca60c58 2008-05-15   stephan: <a href="http://www.fossil-scm.org/fossil/login">
d87ca60c58 2008-05-15   stephan: http://www.fossil-scm.org/fossil/login</a>.</p></li>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <li><p>Log in as anonymous.  The password is shown on screen.
d87ca60c58 2008-05-15   stephan: The reason for requiring this login is to prevent spiders from
d87ca60c58 2008-05-15   stephan: walking the entire website, downloading ZIP archives
d87ca60c58 2008-05-15   stephan: of every historical version, and thereby soaking up all our bandwidth.</p></li>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <li><p>Click on the
d87ca60c58 2008-05-15   stephan: <a href="http://www.fossil-scm.org/fossil/timeline">Timeline</a> or
d87ca60c58 2008-05-15   stephan: <a href="http://www.fossil-scm.org/fossil/leaves">Leaves</a> link at
d87ca60c58 2008-05-15   stephan: the top of the page.</p></li>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <li><p>Select a version of of fossil you want to download.  Click on its
d87ca60c58 2008-05-15   stephan: link.  Note that you must successfully log in as "anonymous" in step 1
d87ca60c58 2008-05-15   stephan: above in order to see the link to the detailed version information.</p></li>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <li><p>On the version information page, click on the
d87ca60c58 2008-05-15   stephan: "Zip Archive" link.  This link will build a ZIP archive of the
d87ca60c58 2008-05-15   stephan: complete source code and download it to your browser.</p></li>
d87ca60c58 2008-05-15   stephan: </ol>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <h2>2.0 Compiling</h2>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <p>Follow these steps to compile:</p>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <ol>
d87ca60c58 2008-05-15   stephan: <li value="6">
d87ca60c58 2008-05-15   stephan: <p>Create a directory to hold the source code.  Then unzip the
d87ca60c58 2008-05-15   stephan: ZIP archive you downloaded into that directory.  You should be
d87ca60c58 2008-05-15   stephan: in the top-level folder of that directory</p></li>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <li><p><b>(Optional:)</b>
d87ca60c58 2008-05-15   stephan: Edit the Makefile to set it up like you want.  You probably do not
d87ca60c58 2008-05-15   stephan: need to do anything.  Do not be intimidated:  There are only 5
d87ca60c58 2008-05-15   stephan: variables in the makefile that can be changed.  The whole Makefile
d87ca60c58 2008-05-15   stephan: is only a few dozen lines long and most of those lines are comments.</p>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <li><p>Type "<b>make</b>"
d87ca60c58 2008-05-15   stephan: </ol>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <h2>3.0 Installing</h2>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <ol>
d87ca60c58 2008-05-15   stephan: <li value="9">
d87ca60c58 2008-05-15   stephan: <p>The finished binary is named "fossil".  Put this binary in a
d87ca60c58 2008-05-15   stephan: directory that is somewhere on your PATH environment variable.
d87ca60c58 2008-05-15   stephan: It does not matter where.</p>
d87ca60c58 2008-05-15   stephan: 
d87ca60c58 2008-05-15   stephan: <li>
d87ca60c58 2008-05-15   stephan: <p><b>(Optional:)</b>
d87ca60c58 2008-05-15   stephan: To uninstall, just delete the binary.</p>
d87ca60c58 2008-05-15   stephan: </ol>