FossilRepo

fossilrepo / docs / index.md

Source Rendered

Blame History Raw 66 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 \| Mirror Fossil repos to GitHub/GitLab (read-only) \|`
29	`\| Celery workers \| Background sync, scheduled tasks \|`
30
31	`## Quick Start`
32
33	```bash
34	`# Clone the repo`
35	`git clone https://github.com/ConflictHQ/fossilrepo.git`
36	`cd fossilrepo`
37
38	`# Start the full stack`
39	`make build`
40
41	`# Seed development data`
42	`make seed`
43
44	`# Open the dashboard`
45	`open http://localhost:8000`
46	```
47
48	`## Architecture`
49
50	```
51	`Caddy (SSL termination, routing, subdomain per repo)`
52	`+-- fossil server --repolist /data/repos/`
53	`+-- /data/repos/`
54	`\|-- projecta.fossil`
55	`\|-- projectb.fossil`
56	`+-- ...`
57
58	`Litestream -> S3/MinIO (continuous replication, point-in-time recovery)`
59	```
60
61	New project = `fossil init`. No restart, no config change. Litestream picks it up automatically.
62
63	`## License`
64
65	`MIT License -- Copyright (c) 2026 CONFLICT LLC.`
66

FossilRepo

Keyboard Shortcuts