|
1
|
<title>A Coherent Software Configuration Management System</title> |
|
2
|
|
|
3
|
<h3>What Is It?</h3> |
|
4
|
|
|
5
|
<div class="nomargins" style='float:right;border:2px solid #446979;padding:0 15px 10px 0;margin:0 50px 0 10px'> |
|
6
|
<ul> |
|
7
|
<li> [/uv/download.html | Download] |
|
8
|
<li> [./quickstart.wiki | Quick Start] |
|
9
|
<li> [./build.wiki | Install] |
|
10
|
<li> [https://fossil-scm.org/forum | Support/Forum ] |
|
11
|
<li> [./hints.wiki | Tips & Hints] |
|
12
|
<li> [./changes.wiki | Change Log] |
|
13
|
<li> [../COPYRIGHT-BSD2.txt | License] |
|
14
|
<li> [./userlinks.wiki | User Links] |
|
15
|
<li> [./hacker-howto.wiki | Hacker How-To] |
|
16
|
<li> [./fossil-v-git.wiki | Fossil vs. Git] |
|
17
|
<li> [./permutedindex.html | Doc Index] |
|
18
|
</ul> |
|
19
|
<p style="text-align:center"><img src="fossil3.gif" alt="Fossil logo"></p> |
|
20
|
</div> |
|
21
|
|
|
22
|
Fossil is a simple, high-reliability, distributed |
|
23
|
[https://en.wikipedia.org/wiki/Software_configuration_management | SCM] |
|
24
|
system with these advanced features: |
|
25
|
|
|
26
|
1. <b>Project Management</b> — |
|
27
|
In addition to doing [./concepts.wiki | distributed version control] |
|
28
|
like Git and Mercurial, |
|
29
|
Fossil also supports [./bugtheory.wiki | bug tracking], |
|
30
|
[./wikitheory.wiki | wiki], [./forum.wiki | forum], |
|
31
|
[./alerts.md|email alerts], [./chat.md | chat], and |
|
32
|
[./event.wiki | technotes]. |
|
33
|
|
|
34
|
2. <b>Built-in Web Interface</b> — |
|
35
|
Fossil has a built-in, [/skins | themeable], [./serverext.wiki | extensible], |
|
36
|
and intuitive [./webui.wiki | web interface] |
|
37
|
with a rich variety of information pages |
|
38
|
([./webpage-ex.md|examples]) promoting situational awareness. |
|
39
|
<br><br> |
|
40
|
This entire website is just a running instance of Fossil. |
|
41
|
The pages you see here are all [./wikitheory.wiki | wiki] or |
|
42
|
[./embeddeddoc.wiki | embedded documentation] or (in the case of |
|
43
|
the [/uv/download.html|download] page) |
|
44
|
[./unvers.wiki | unversioned files]. |
|
45
|
When you clone Fossil from one of its |
|
46
|
[./selfhost.wiki | self-hosting repositories], |
|
47
|
you get more than just source code — you get this entire website. |
|
48
|
|
|
49
|
3. <b>All-in-one</b> — |
|
50
|
Fossil is a single self-contained, stand-alone executable. |
|
51
|
To install, simply download a |
|
52
|
[/uv/download.html | precompiled binary] |
|
53
|
for Linux, Mac, or Windows and put it on your $PATH. |
|
54
|
[./build.wiki | Easy-to-compile source code] is also available. |
|
55
|
|
|
56
|
|
|
57
|
4. <b>Self-host Friendly</b> — Stand up a project website |
|
58
|
in minutes using [./server/ | a variety of techniques]. |
|
59
|
Fossil is CPU and memory efficient. Most projects can be |
|
60
|
hosted comfortably on a $5/month VPS or a Raspberry Pi. |
|
61
|
You can also set up an automatic |
|
62
|
[./mirrortogithub.md | GitHub mirror]. |
|
63
|
|
|
64
|
5. <b>Simple Networking</b> — |
|
65
|
Fossil uses ordinary HTTPS (or SSH if you prefer) |
|
66
|
for network communications, so it works fine from behind |
|
67
|
firewalls and [./quickstart.wiki#proxy|proxies]. |
|
68
|
The protocol is |
|
69
|
[./stats.wiki | bandwidth efficient] to the point that Fossil can be |
|
70
|
used comfortably over dial-up, weak 3G, or airliner Wifi. |
|
71
|
|
|
72
|
6. <b>Autosync</b> — |
|
73
|
Fossil supports [./concepts.wiki#workflow | "autosync" mode] |
|
74
|
which helps to keep projects moving |
|
75
|
forward by reducing the amount of needless |
|
76
|
[./branching.wiki | forking and merging] often |
|
77
|
associated with distributed projects. |
|
78
|
|
|
79
|
7. <b>Robust & Reliable</b> — |
|
80
|
Fossil stores content using an [./fileformat.wiki | enduring file format] |
|
81
|
in an SQLite database so that transactions are |
|
82
|
atomic even if interrupted by a power loss or system crash. |
|
83
|
Automatic [./selfcheck.wiki | self-checks] verify that all aspects of |
|
84
|
the repository are consistent prior to each commit. |
|
85
|
|
|
86
|
8. <b>Free and Open-Source</b> — [../COPYRIGHT-BSD2.txt|2-clause BSD license]. |
|
87
|
|
|
88
|
<hr> |
|
89
|
<h3>Latest Release: 2.28 ([/timeline?c=version-2.28|2026-03-11])</h3> |
|
90
|
|
|
91
|
* [/uv/download.html|Download] |
|
92
|
* [./changes.wiki#v2_28|Change Summary] |
|
93
|
* [/timeline?p=version-2.28&d=version-2.27&y=ci|Check-ins in version 2.28] |
|
94
|
* [/timeline?df=version-2.28&y=ci|Check-ins derived from the 2.28 release] |
|
95
|
* [/timeline?t=release|Timeline of all past releases] |
|
96
|
|
|
97
|
<hr> |
|
98
|
<h3>Quick Start</h3> |
|
99
|
|
|
100
|
1. [/uv/download.html|Download] or install using a package manager or |
|
101
|
[./build.wiki|compile from sources]. |
|
102
|
2. <tt>fossil init</tt> <i>REPOSITORY-DIR/new-repository</i> |
|
103
|
3. <tt>fossil open</tt> <i>REPOSITORY-DIR/new-repository</i> |
|
104
|
4. <tt>fossil add</tt> <i>files-or-directories</i> |
|
105
|
5. <tt>fossil commit -m</tt> "<i>commit message</i>" |
|
106
|
6. <tt>fossil ui</tt> |
|
107
|
7. Repeat steps 4, 5, and 6, in any order, as necessary. |
|
108
|
See the [./quickstart.wiki|Quick Start Guide] for more detail. |
|
109
|
|