FossilRepo

fossilrepo / docs / index.md

Source Rendered

Blame History Raw 86 lines

1	`# Fossilrepo`
2
3	`Self-hosted Fossil forge. One command, full-stack code hosting.`
4
5	`![FossilRepo Tour](fossilrepo-tour.gif)`
6
7	`Fossilrepo is an omnibus-style installer for a production Fossil SCM server. It packages Fossil, Caddy (SSL/routing), Litestream (S3 backups), and a Django management layer into a single deployable unit.`
8
9	`Think GitLab Omnibus, but for Fossil.`
10
11	`## Why Fossil?`
12
13	`A Fossil repository is a single SQLite file containing the full VCS history, issue tracker, wiki, forum, and timeline. No external services. No rate limits. Portable -- hand the file to someone and they have everything.`
14
15	- Single-file repos -- each `.fossil` file is the entire project
16	`- Built-in everything -- issues, wiki, forum, timeline, web UI`
17	`- No API rate limits -- ideal for CI agents and automation`
18	`- Litestream replication -- continuous backup to S3 for free`
19
20	`## What You Get`
21
22	`\| Component \| Role \|`
23	`\|---\|---\|`
24	`\| Fossil server \| Serves all repos from a single process \|`
25	`\| Caddy \| SSL termination, subdomain-per-repo routing \|`
26	`\| Litestream \| Continuous SQLite replication to S3/MinIO \|`
27	`\| Django management UI \| Repository lifecycle, user management, dashboards \|`
28	`\| Sync bridge \| Bidirectional sync between Fossil and GitHub/GitLab \|`
29	`\| Celery workers \| Background sync, scheduled tasks \|`
30
31	`## Quick Start`
32
33	`=== "Fossil"`
34
35	```bash
36	`fossil clone https://fossilrepo.io/projects/fossilrepo/ fossilrepo.fossil`
37	`fossil open fossilrepo.fossil --workdir fossilrepo`
38	`cd fossilrepo`
39
40	`# Start the full stack`
41	`make build`
42
43	`# Seed development data`
44	`make seed`
45
46	`# Open the dashboard`
47	`open http://localhost:8000`
48	```
49
50	`=== "Git"`
51
52	```bash
53	`git clone https://github.com/ConflictHQ/fossilrepo.git`
54	`cd fossilrepo`
55
56	`# Start the full stack`
57	`make build`
58
59	`# Seed development data`
60	`make seed`
61
62	`# Open the dashboard`
63	`open http://localhost:8000`
64	```
65
66	`Both repositories are kept in sync bidirectionally via the [sync bridge](architecture/sync-bridge.md).`
67
68	`## Architecture`
69
70	```
71	`Caddy (SSL termination, routing, subdomain per repo)`
72	`+-- fossil server --repolist /data/repos/`
73	`+-- /data/repos/`
74	`\|-- projecta.fossil`
75	`\|-- projectb.fossil`
76	`+-- ...`
77
78	`Litestream -> S3/MinIO (continuous replication, point-in-time recovery)`
79	```
80
81	New project = `fossil init`. No restart, no config change. Litestream picks it up automatically.
82
83	`## License`
84
85	`MIT License -- Copyright (c) 2026 CONFLICT LLC.`
86

FossilRepo

Keyboard Shortcuts