Simple, high-reliability, distributed software configuration management

Why Use Fossil?

Download Quick Start Install License Recent changes FAQ Contributing Change Log Tip & Hints Documentation Index Jim Schimpf's book Mailing list sign-up archives

There are plenty of open-source version control systems available on the internet these days. What makes Fossil worthy of attention?

1. Bug Tracking And Wiki - In addition to doing distributed version control like Git and Mercurial, Fossil also supports distributed bug tracking, distributed wiki, and a distributed blog mechanism all in a single integrated package.

2. Web Interface - Fossil has a built-in and easy-to-use web interface that simplifies project tracking and promotes situational awareness. Simply type "fossil ui" from within any check-out and Fossil automatically opens your web browser in a page that gives detailed graphical history and status information on that project.

This entire website (except the download page) is just a running instance of Fossil. The pages you see here are all wiki or embedded documentation. When you clone Fossil from one of its self-hosting repositories, you get more than just source code - you get this entire website.

3. Autosync - Fossil supports "autosync" mode which helps to keep projects moving forward by reducing the amount of needless forking and merging often associated with distributed projects.

4. Self-Contained - Fossil is a single stand-alone executable that contains everything needed to do configuration management. Installation is trivial: simply download a precompiled binary for Linux, Mac, or Windows and put it on your $PATH. Easy-to-compile source code is available for users on other platforms. Fossil sources are also mostly self-contained, requiring only the "zlib" library and the standard C library to build.

5. Simple Networking - Fossil uses plain old HTTP (with proxy support) for all network communications, meaning that it works fine from behind restrictive firewalls. The protocol is bandwidth efficient to the point that Fossil can be used comfortably over a dial-up internet connection.

6. CGI Enabled - No server is required to use fossil. But a server does make collaboration easier. Fossil supports three different yet simple server configurations. The most popular is a 2-line CGI script. This is the approach used by the self-hosting fossil repositories.

7. Robust & Reliable - Fossil stores content using an enduring file format in an SQLite database so that transactions are atomic even if interrupted by a power loss or system crash. Furthermore, automatic self-checks verify that all aspects of the repository are consistent prior to each commit. In over three years of operation, no work has ever been lost after having been committed to a Fossil repository.

Links For Fossil Users:

• Testimonials from satisfied fossil users and Quotes about Fossil and other DVCSes.
• FAQ
• The concepts behind fossil
• Quick Start guide to using fossil
• Questions & Criticisms directed at fossil.
• Compiling and Installing
• Fossil supports embedded documentation that is versioned along with project source code.
• Fossil uses an enduring file format that is designed to be readable, searchable, and extensible by people not yet born.
• A tutorial on branching, what it means and how to do it using fossil.
• The automatic self-check mechanism helps insure project integrity.
• Fossil contains a built-in wiki.
• An Event is a special kind of wiki page associated with a point in time rather than a name.
• Settings control the behaviour of fossil.
• Use SSL to encrypt communication with the server.
• There is a mailing list (with publicly readable archives available for discussing fossil issues.
• Performance statistics taken from real-world projects hosted on fossil.
• How to delete content from a fossil repository.
• How Fossil does password management.
• On-line help.
• Documentation on the TH1 Script Language used to configure the ticketing subsystem.
• A free hosting server for Fossil repositories is available at http://chiselapp.com/.
• How to set up a server for your repository.
• Customizing the ticket system.
• Methods to identify a specific check-in.
• Import and export from and to Git.
• Fossil versus Git.
• Up and running in 5 minutes as a single user (contributed by Gilles Ganault on 2013-01-08).
• How Fossil defends against abuse by spiders and bots.

Links For Fossil Developer:

• Contributing code or documentation to the Fossil project.
• Thoughts On The Design Of Fossil.
• Principles Of Operation
• A Technical Overview Of Fossil.
• The file format used by every content file stored in the repository.
• The format of deltas used to efficiently store changes between file revisions.
• The encoder algorithm used to efficiently generate deltas.
• The synchronization protocol.