FossilRepo

Sync: sidebar split, wiki ordering, non-destructive sync script

ragelink 2026-04-07 19:58 UTC trunk
Commit 8f52aba83e8e2e433d610a9e78ae76b2668f493dbb30b030a49a065e03be56f7
Parent 6d55e0e56631c00…
16 files changed +2 +53 +73 +738 +1 +1099 +1077 +1288 +1074 +1089 +1108 +1008 +4 +1 +31
~ .gitignore + deploy.sh + scripts/sync_to_fossil.sh + site/404.html + site/CNAME + site/architecture/overview/index.html + site/architecture/sync-bridge/index.html + site/getting-started/configuration/index.html + site/getting-started/first-repo/index.html + site/getting-started/installation/index.html + site/getting-started/prerequisites/index.html + site/index.html + site/overrides/partials/logo.html + site/search/search_index.json + site/sitemap.xml + site/sitemap.xml.gz
M .gitignore
+2
--- .gitignore
+++ .gitignore
@@ -28,5 +28,7 @@
2828
 /assets/
2929
 fossilrepo.fossil
3030
 .fslckout
3131
 site/
3232
 repos/
33
+.env.deploy
34
+deploy.sh
3335
3436
ADDED deploy.sh
3537
ADDED scripts/sync_to_fossil.sh
3638
ADDED site/404.html
3739
ADDED site/CNAME
3840
ADDED site/architecture/overview/index.html
3941
ADDED site/architecture/sync-bridge/index.html
4042
ADDED site/getting-started/configuration/index.html
4143
ADDED site/getting-started/first-repo/index.html
4244
ADDED site/getting-started/installation/index.html
4345
ADDED site/getting-started/prerequisites/index.html
4446
ADDED site/index.html
4547
ADDED site/overrides/partials/logo.html
4648
ADDED site/search/search_index.json
4749
ADDED site/sitemap.xml
4850
ADDED site/sitemap.xml.gz
--- .gitignore
+++ .gitignore
@@ -28,5 +28,7 @@
28 /assets/
29 fossilrepo.fossil
30 .fslckout
31 site/
32 repos/
 
 
33
34 DDED deploy.sh
35 DDED scripts/sync_to_fossil.sh
36 DDED site/404.html
37 DDED site/CNAME
38 DDED site/architecture/overview/index.html
39 DDED site/architecture/sync-bridge/index.html
40 DDED site/getting-started/configuration/index.html
41 DDED site/getting-started/first-repo/index.html
42 DDED site/getting-started/installation/index.html
43 DDED site/getting-started/prerequisites/index.html
44 DDED site/index.html
45 DDED site/overrides/partials/logo.html
46 DDED site/search/search_index.json
47 DDED site/sitemap.xml
48 DDED site/sitemap.xml.gz
--- .gitignore
+++ .gitignore
@@ -28,5 +28,7 @@
28 /assets/
29 fossilrepo.fossil
30 .fslckout
31 site/
32 repos/
33 .env.deploy
34 deploy.sh
35
36 DDED deploy.sh
37 DDED scripts/sync_to_fossil.sh
38 DDED site/404.html
39 DDED site/CNAME
40 DDED site/architecture/overview/index.html
41 DDED site/architecture/sync-bridge/index.html
42 DDED site/getting-started/configuration/index.html
43 DDED site/getting-started/first-repo/index.html
44 DDED site/getting-started/installation/index.html
45 DDED site/getting-started/prerequisites/index.html
46 DDED site/index.html
47 DDED site/overrides/partials/logo.html
48 DDED site/search/search_index.json
49 DDED site/sitemap.xml
50 DDED site/sitemap.xml.gz
A deploy.sh
+53
--- a/deploy.sh
+++ b/deploy.sh
@@ -0,0 +1,53 @@
1
+#!/bin/bash
2
+statey.sh — push local chUsage: ./deploy.sh [message] + collectstatic + restart)
3
+#
4
+:
5
+# FOSSIL_REMOTE_URL=https://admin:[email protected]/projects/fossilrepo/fossil/xfer
6
+# EC2_INSTANCE_ID=i-xxxx
7
+# S3_BUCKET=dev-fossilrepo-storaOTE_URL and EC2_INSTANCE_ID
8
+
9
+set -euo pipefail
10
+
11
+if [[ ! -f .env.deploy ]]; then
12
+ echo "Missing .env.deploy -- copy .env.deploy.example and fill in your values"
13
+ exit 1
14
+fi
15
+
16
+source .env.deploy
17
+
18
+MSG="${1:-Deploy $(date +%Y-%m-%d-%H%M)}"
19
+
20
+echo "=== Fossil commit ==="
21
+fossil addremove 2>/dev/null || true
22
+fossil commit --no-warnings -m "$MSG" 2>&1 || echo "Nothing to commit"
23
+
24
+echo "=== Fossil push ==="
25
+fossil push "$FOSSIL_REMOTE_URL"
26
+
27
+echo "=== Deploy to server ==="
28
+AWS_PROFILE=fossiladmin aws ssm send-command \
29
+ --instance-ids "$EC2_INSTANCE_ID" \
30
+ --document-name "AWS-RunShellScript" \
31
+ --timeout-seconds 120 \
32
+ --parameters '{"commands":["export HOME=/root && fossilrepo-deploy 2>&1"]}' \
33
+ --region "${AWS_REGION:-us-west-2}" \
34
+ --query "Command.CommandId" \
35
+ --output text
36
+
37
+echo "=== Deployed ==="
38
+ssil commit --no-warnings -m "$MSG" 2>&1 || echo "Nothing to commit"
39
+
40
+echo "=== Fossil Sync repos to S3
41
+echo "=== Deploy to server ==="
42
+AW3 sync repos/ "s3://${S3_BUCKET}/sync/repos/" --region "$AWS_REGION" --exclude "*.fossil-shm" --exclude "*.fossil-wal" 2>&1 | tail -3
43
+
44
+echo "=== Sync DB to S3 ==="
45
+docker compose exec -T postgres pg_dump -U dbadmin --data-only --inserts --no-owner --no-privileges fossilrepo > /tmp/fossilrepo-data.sql
46
+AWS_PROFILE=fossiladmin aws s3 cp /tmp/fossilrepo-data.sql "s3://${S3_BUCKET}/sync/data.sql" --region "$AWS_REGION" 2>&1 | tail -1
47
+
48
+echo "=== Push code to git ==="
49
+git add -A && git commit -m "$MSG" 2>/dev/null || true
50
+git push origin main 2>&1 || echo "Git push failed (non-critical)"
51
+
52
+echo "=== Deploy to EC2
53
+echo "===
--- a/deploy.sh
+++ b/deploy.sh
@@ -0,0 +1,53 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
--- a/deploy.sh
+++ b/deploy.sh
@@ -0,0 +1,53 @@
1 #!/bin/bash
2 statey.sh — push local chUsage: ./deploy.sh [message] + collectstatic + restart)
3 #
4 :
5 # FOSSIL_REMOTE_URL=https://admin:[email protected]/projects/fossilrepo/fossil/xfer
6 # EC2_INSTANCE_ID=i-xxxx
7 # S3_BUCKET=dev-fossilrepo-storaOTE_URL and EC2_INSTANCE_ID
8
9 set -euo pipefail
10
11 if [[ ! -f .env.deploy ]]; then
12 echo "Missing .env.deploy -- copy .env.deploy.example and fill in your values"
13 exit 1
14 fi
15
16 source .env.deploy
17
18 MSG="${1:-Deploy $(date +%Y-%m-%d-%H%M)}"
19
20 echo "=== Fossil commit ==="
21 fossil addremove 2>/dev/null || true
22 fossil commit --no-warnings -m "$MSG" 2>&1 || echo "Nothing to commit"
23
24 echo "=== Fossil push ==="
25 fossil push "$FOSSIL_REMOTE_URL"
26
27 echo "=== Deploy to server ==="
28 AWS_PROFILE=fossiladmin aws ssm send-command \
29 --instance-ids "$EC2_INSTANCE_ID" \
30 --document-name "AWS-RunShellScript" \
31 --timeout-seconds 120 \
32 --parameters '{"commands":["export HOME=/root && fossilrepo-deploy 2>&1"]}' \
33 --region "${AWS_REGION:-us-west-2}" \
34 --query "Command.CommandId" \
35 --output text
36
37 echo "=== Deployed ==="
38 ssil commit --no-warnings -m "$MSG" 2>&1 || echo "Nothing to commit"
39
40 echo "=== Fossil Sync repos to S3
41 echo "=== Deploy to server ==="
42 AW3 sync repos/ "s3://${S3_BUCKET}/sync/repos/" --region "$AWS_REGION" --exclude "*.fossil-shm" --exclude "*.fossil-wal" 2>&1 | tail -3
43
44 echo "=== Sync DB to S3 ==="
45 docker compose exec -T postgres pg_dump -U dbadmin --data-only --inserts --no-owner --no-privileges fossilrepo > /tmp/fossilrepo-data.sql
46 AWS_PROFILE=fossiladmin aws s3 cp /tmp/fossilrepo-data.sql "s3://${S3_BUCKET}/sync/data.sql" --region "$AWS_REGION" 2>&1 | tail -1
47
48 echo "=== Push code to git ==="
49 git add -A && git commit -m "$MSG" 2>/dev/null || true
50 git push origin main 2>&1 || echo "Git push failed (non-critical)"
51
52 echo "=== Deploy to EC2
53 echo "===
A scripts/sync_to_fossil.sh
+73
--- a/scripts/sync_to_fossil.sh
+++ b/scripts/sync_to_fossil.sh
@@ -0,0 +1,73 @@
1
+#!/bin/bash
2
+# sync_to_fossil.sh — Commit current code into the existing .fossil repo.
3
+#
4
+# Opens a temporary checkout, rsyncs the working tree in, commits changes.
5
+# NEVER replaces or reimports the .fossil file — preserves all tickets,
6
+# wiki, forum, and other Fossil-native artifacts.
7
+#
8
+# Usage: ./scripts/sync_to_fossil.sh ["commit message"]
9
+# Run from inside the container or via:
10
+# docker compose exec backend bash scripts/sync_to_fossil.sh "message"
11
+
12
+set -euo pipefail
13
+
14
+REPO="/data/repos/fossilrepo.fossil"
15
+WORKDIR="/tmp/fossil-checkout-$$"
16
+MESSAGE="${1:-Sync from working tree}"
17
+
18
+export USER="${USER:-ragelink}"
19
+
20
+if [ ! -f "$REPO" ]; then
21
+ echo "Error: $REPO not found" >&2
22
+ exit 1
23
+fi
24
+
25
+echo "=== Committing to Fossil ==="
26
+
27
+# Create temp checkout
28
+rm -rf "$WORKDIR"
29
+mkdir -p "$WORKDIR"
30
+cd "$WORKDIR"
31
+
32
+fossil open "$REPO" --workdir "$WORKDIR" 2>/dev/null
33
+fossil update trunk 2>/dev/null || true
34
+
35
+# Sync code from /app — use tar to copy with exclusions (rsync not available)
36
+cd /app
37
+tar cf - \
38
+ --exclude='.git' \
39
+ --exclude='__pycache__' \
40
+ --exclude='*.pyc' \
41
+ --exclude='.ruff_cache' \
42
+ --exclude='node_modules' \
43
+ --exclude='assets' \
44
+ --exclude='.env' \
45
+ --exclude='repos' \
46
+ --exclude='.fslckout' \
47
+ --exclude='_FOSSIL_' \
48
+ --exclude='*.fossil' \
49
+ --exclude='.claude' \
50
+ . | (cd "$WORKDIR" && tar xf -)
51
+cd "$WORKDIR"
52
+
53
+# Register new/deleted files
54
+fossil addremove 2>/dev/null || true
55
+
56
+# Commit if there are changes
57
+CHANGES=$(fossil changes 2>/dev/null | wc -l | tr -d ' ')
58
+if [ "$CHANGES" -gt 0 ]; then
59
+ fossil commit -m "$MESSAGE" --no-warnings 2>&1 | tail -3
60
+ echo "Committed $CHANGES changed files."
61
+else
62
+ echo "No changes to commit."
63
+fi
64
+
65
+# Cleanup
66
+fossil close --force 2>/dev/null || true
67
+cd /
68
+rm -rf "$WORKDIR"
69
+
70
+echo "=== Status ==="
71
+echo "Checkins: $(fossil sql -R "$REPO" "SELECT count(*) FROM event WHERE type='ci';" | tr -d "' ")"
72
+echo "Wiki: $(fossil wiki list -R "$REPO" | wc -l) pages"
73
+echo "Tickets: $(fossil sql -R "$REPO" "SELECT count(*) FROM ticket;" | tr -d "' ")"
--- a/scripts/sync_to_fossil.sh
+++ b/scripts/sync_to_fossil.sh
@@ -0,0 +1,73 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
--- a/scripts/sync_to_fossil.sh
+++ b/scripts/sync_to_fossil.sh
@@ -0,0 +1,73 @@
1 #!/bin/bash
2 # sync_to_fossil.sh — Commit current code into the existing .fossil repo.
3 #
4 # Opens a temporary checkout, rsyncs the working tree in, commits changes.
5 # NEVER replaces or reimports the .fossil file — preserves all tickets,
6 # wiki, forum, and other Fossil-native artifacts.
7 #
8 # Usage: ./scripts/sync_to_fossil.sh ["commit message"]
9 # Run from inside the container or via:
10 # docker compose exec backend bash scripts/sync_to_fossil.sh "message"
11
12 set -euo pipefail
13
14 REPO="/data/repos/fossilrepo.fossil"
15 WORKDIR="/tmp/fossil-checkout-$$"
16 MESSAGE="${1:-Sync from working tree}"
17
18 export USER="${USER:-ragelink}"
19
20 if [ ! -f "$REPO" ]; then
21 echo "Error: $REPO not found" >&2
22 exit 1
23 fi
24
25 echo "=== Committing to Fossil ==="
26
27 # Create temp checkout
28 rm -rf "$WORKDIR"
29 mkdir -p "$WORKDIR"
30 cd "$WORKDIR"
31
32 fossil open "$REPO" --workdir "$WORKDIR" 2>/dev/null
33 fossil update trunk 2>/dev/null || true
34
35 # Sync code from /app — use tar to copy with exclusions (rsync not available)
36 cd /app
37 tar cf - \
38 --exclude='.git' \
39 --exclude='__pycache__' \
40 --exclude='*.pyc' \
41 --exclude='.ruff_cache' \
42 --exclude='node_modules' \
43 --exclude='assets' \
44 --exclude='.env' \
45 --exclude='repos' \
46 --exclude='.fslckout' \
47 --exclude='_FOSSIL_' \
48 --exclude='*.fossil' \
49 --exclude='.claude' \
50 . | (cd "$WORKDIR" && tar xf -)
51 cd "$WORKDIR"
52
53 # Register new/deleted files
54 fossil addremove 2>/dev/null || true
55
56 # Commit if there are changes
57 CHANGES=$(fossil changes 2>/dev/null | wc -l | tr -d ' ')
58 if [ "$CHANGES" -gt 0 ]; then
59 fossil commit -m "$MESSAGE" --no-warnings 2>&1 | tail -3
60 echo "Committed $CHANGES changed files."
61 else
62 echo "No changes to commit."
63 fi
64
65 # Cleanup
66 fossil close --force 2>/dev/null || true
67 cd /
68 rm -rf "$WORKDIR"
69
70 echo "=== Status ==="
71 echo "Checkins: $(fossil sql -R "$REPO" "SELECT count(*) FROM event WHERE type='ci';" | tr -d "' ")"
72 echo "Wiki: $(fossil wiki list -R "$REPO" | wc -l) pages"
73 echo "Tickets: $(fossil sql -R "$REPO" "SELECT count(*) FROM ticket;" | tr -d "' ")"
A site/404.html
+738
--- a/site/404.html
+++ b/site/404.html
@@ -0,0 +1,738 @@
1
+
2
+<!doctype html>
3
+<html lang="en" class="no-js">
4
+ <head>
5
+
6
+ <meta charset="utf-8">
7
+ <meta name="viewport" content="width=device-width,initial-scale=1">
8
+
9
+ <meta name="description" content="Self-hosted Fossil forge -- omnibus installer for production Fossil SCM hosting">
10
+
11
+
12
+ <meta name="author" content="CONFLICT LLC">
13
+
14
+
15
+
16
+
17
+
18
+
19
+
20
+
21
+ <link rel="icon" href="/assets/images/favicon.png">
22
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
23
+
24
+
25
+
26
+ <title>Fossilrepo</title>
27
+
28
+
29
+
30
+ <link rel="stylesheet" href="/assets/stylesheets/main.484c7ddc.min.css">
31
+
32
+
33
+ <link rel="stylesheet" href="/assets/stylesheets/palette.ab4e12ef.min.css">
34
+
35
+
36
+
37
+
38
+
39
+
40
+
41
+
42
+
43
+
44
+
45
+
46
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
47
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
48
+ <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
49
+
50
+
51
+
52
+ <link rel="stylesheet" href="/assets/css/custom.css">
53
+
54
+ <script>__md_scope=new URL("/",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
55
+
56
+
57
+
58
+
59
+
60
+ </head>
61
+
62
+
63
+
64
+
65
+
66
+
67
+
68
+
69
+
70
+ <body dir="ltr" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom">
71
+
72
+
73
+ <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
74
+ <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
75
+ <label class="md-overlay" for="__drawer"></label>
76
+ <div data-md-component="skip">
77
+
78
+ </div>
79
+ <div data-md-component="announce">
80
+
81
+ </div>
82
+
83
+
84
+
85
+
86
+<header class="md-header" data-md-component="header">
87
+ <nav class="md-header__inner md-grid" aria-label="Header">
88
+ <a href="/." title="Fossilrepo" class="md-header__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
89
+ <div style="display: flex; align-items: center; gap: 0.6rem;">
90
+ <img src="/assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
91
+ <img src="/assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
92
+</div>
93
+ </a>
94
+ <label class="md-header__button md-icon" for="__drawer">
95
+
96
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
97
+ </label>
98
+ <div class="md-header__title" data-md-component="header-title">
99
+ <div class="md-header__ellipsis">
100
+ <div class="md-header__topic">
101
+ <span class="md-ellipsis">
102
+ Fossilrepo
103
+ </span>
104
+ </div>
105
+ <div class="md-header__topic" data-md-component="header-topic">
106
+ <span class="md-ellipsis">
107
+
108
+
109
+
110
+ </span>
111
+ </div>
112
+ </div>
113
+ </div>
114
+
115
+
116
+ <form class="md-header__option" data-md-component="palette">
117
+
118
+
119
+
120
+
121
+ <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">
122
+
123
+ <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
124
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
125
+ </label>
126
+
127
+
128
+
129
+
130
+
131
+ <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
132
+
133
+ <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>
134
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
135
+ </label>
136
+
137
+
138
+</form>
139
+
140
+
141
+
142
+ <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
143
+
144
+
145
+
146
+
147
+
148
+ <label class="md-header__button md-icon" for="__search">
149
+
150
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
151
+ </label>
152
+ <div class="md-search" data-md-component="search" role="dialog">
153
+ <label class="md-search__overlay" for="__search"></label>
154
+ <div class="md-search__inner" role="search">
155
+ <form class="md-search__form" name="search">
156
+ <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
157
+ <label class="md-search__icon md-icon" for="__search">
158
+
159
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
160
+
161
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
162
+ </label>
163
+ <nav class="md-search__options" aria-label="Search">
164
+
165
+ <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
166
+
167
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
168
+ </button>
169
+ </nav>
170
+
171
+ <div class="md-search__suggest" data-md-component="search-suggest"></div>
172
+
173
+ </form>
174
+ <div class="md-search__output">
175
+ <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
176
+ <div class="md-search-result" data-md-component="search-result">
177
+ <div class="md-search-result__meta">
178
+ Initializing search
179
+ </div>
180
+ <ol class="md-search-result__list" role="presentation"></ol>
181
+ </div>
182
+ </div>
183
+ </div>
184
+ </div>
185
+</div>
186
+
187
+
188
+
189
+ <div class="md-header__source">
190
+ <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
191
+ <div class="md-source__icon md-icon">
192
+
193
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
194
+ </div>
195
+ <div class="md-source__repository">
196
+ ConflictHQ/fossilrepo
197
+ </div>
198
+</a>
199
+ </div>
200
+
201
+ </nav>
202
+
203
+</header>
204
+
205
+ <div class="md-container" data-md-component="container">
206
+
207
+
208
+
209
+
210
+
211
+<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
212
+ <div class="md-grid">
213
+ <ul class="md-tabs__list">
214
+
215
+
216
+
217
+
218
+
219
+
220
+ <li class="md-tabs__item">
221
+ <a href="/." class="md-tabs__link">
222
+
223
+
224
+
225
+
226
+
227
+ Home
228
+
229
+ </a>
230
+ </li>
231
+
232
+
233
+
234
+
235
+
236
+
237
+
238
+
239
+
240
+
241
+ <li class="md-tabs__item">
242
+ <a href="/getting-started/prerequisites/" class="md-tabs__link">
243
+
244
+
245
+
246
+ Getting Started
247
+
248
+ </a>
249
+ </li>
250
+
251
+
252
+
253
+
254
+
255
+
256
+
257
+
258
+
259
+
260
+
261
+ <li class="md-tabs__item">
262
+ <a href="/architecture/overview/" class="md-tabs__link">
263
+
264
+
265
+
266
+ Architecture
267
+
268
+ </a>
269
+ </li>
270
+
271
+
272
+
273
+
274
+ </ul>
275
+ </div>
276
+</nav>
277
+
278
+
279
+
280
+ <main class="md-main" data-md-component="main">
281
+ <div class="md-main__inner md-grid">
282
+
283
+
284
+
285
+ <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
286
+ <div class="md-sidebar__scrollwrap">
287
+ <div class="md-sidebar__inner">
288
+
289
+
290
+
291
+
292
+
293
+
294
+<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
295
+ <label class="md-nav__title" for="__drawer">
296
+ <a href="/." title="Fossilrepo" class="md-nav__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
297
+ <div style="display: flex; align-items: center; gap: 0.6rem;">
298
+ <img src="/assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
299
+ <img src="/assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
300
+</div>
301
+ </a>
302
+ Fossilrepo
303
+ </label>
304
+
305
+ <div class="md-nav__source">
306
+ <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
307
+ <div class="md-source__icon md-icon">
308
+
309
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
310
+ </div>
311
+ <div class="md-source__repository">
312
+ ConflictHQ/fossilrepo
313
+ </div>
314
+</a>
315
+ </div>
316
+
317
+ <ul class="md-nav__list" data-md-scrollfix>
318
+
319
+
320
+
321
+
322
+
323
+
324
+
325
+ <li class="md-nav__item">
326
+ <a href="/." class="md-nav__link">
327
+
328
+
329
+
330
+ <span class="md-ellipsis">
331
+
332
+
333
+ Home
334
+
335
+
336
+
337
+ </span>
338
+
339
+
340
+
341
+ </a>
342
+ </li>
343
+
344
+
345
+
346
+
347
+
348
+
349
+
350
+
351
+
352
+
353
+
354
+
355
+
356
+
357
+
358
+
359
+
360
+
361
+
362
+ <li class="md-nav__item md-nav__item--nested">
363
+
364
+
365
+
366
+
367
+
368
+ <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
369
+
370
+
371
+ <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
372
+
373
+
374
+
375
+ <span class="md-ellipsis">
376
+
377
+
378
+ Getting Started
379
+
380
+
381
+
382
+ </span>
383
+
384
+
385
+
386
+ <span class="md-nav__icon md-icon"></span>
387
+ </label>
388
+
389
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
390
+ <label class="md-nav__title" for="__nav_2">
391
+ <span class="md-nav__icon md-icon"></span>
392
+
393
+
394
+ Getting Started
395
+
396
+
397
+ </label>
398
+ <ul class="md-nav__list" data-md-scrollfix>
399
+
400
+
401
+
402
+
403
+
404
+
405
+
406
+ <li class="md-nav__item">
407
+ <a href="/getting-started/prerequisites/" class="md-nav__link">
408
+
409
+
410
+
411
+ <span class="md-ellipsis">
412
+
413
+
414
+ Prerequisites
415
+
416
+
417
+
418
+ </span>
419
+
420
+
421
+
422
+ </a>
423
+ </li>
424
+
425
+
426
+
427
+
428
+
429
+
430
+
431
+
432
+
433
+
434
+ <li class="md-nav__item">
435
+ <a href="/getting-started/installation/" class="md-nav__link">
436
+
437
+
438
+
439
+ <span class="md-ellipsis">
440
+
441
+
442
+ Installation
443
+
444
+
445
+
446
+ </span>
447
+
448
+
449
+
450
+ </a>
451
+ </li>
452
+
453
+
454
+
455
+
456
+
457
+
458
+
459
+
460
+
461
+
462
+ <li class="md-nav__item">
463
+ <a href="/getting-started/configuration/" class="md-nav__link">
464
+
465
+
466
+
467
+ <span class="md-ellipsis">
468
+
469
+
470
+ Configuration
471
+
472
+
473
+
474
+ </span>
475
+
476
+
477
+
478
+ </a>
479
+ </li>
480
+
481
+
482
+
483
+
484
+
485
+
486
+
487
+
488
+
489
+
490
+ <li class="md-nav__item">
491
+ <a href="/getting-started/first-repo/" class="md-nav__link">
492
+
493
+
494
+
495
+ <span class="md-ellipsis">
496
+
497
+
498
+ First Repository
499
+
500
+
501
+
502
+ </span>
503
+
504
+
505
+
506
+ </a>
507
+ </li>
508
+
509
+
510
+
511
+
512
+ </ul>
513
+ </nav>
514
+
515
+ </li>
516
+
517
+
518
+
519
+
520
+
521
+
522
+
523
+
524
+
525
+
526
+
527
+
528
+
529
+
530
+
531
+
532
+
533
+
534
+
535
+ <li class="md-nav__item md-nav__item--nested">
536
+
537
+
538
+
539
+
540
+
541
+ <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
542
+
543
+
544
+ <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
545
+
546
+
547
+
548
+ <span class="md-ellipsis">
549
+
550
+
551
+ Architecture
552
+
553
+
554
+
555
+ </span>
556
+
557
+
558
+
559
+ <span class="md-nav__icon md-icon"></span>
560
+ </label>
561
+
562
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
563
+ <label class="md-nav__title" for="__nav_3">
564
+ <span class="md-nav__icon md-icon"></span>
565
+
566
+
567
+ Architecture
568
+
569
+
570
+ </label>
571
+ <ul class="md-nav__list" data-md-scrollfix>
572
+
573
+
574
+
575
+
576
+
577
+
578
+
579
+ <li class="md-nav__item">
580
+ <a href="/architecture/overview/" class="md-nav__link">
581
+
582
+
583
+
584
+ <span class="md-ellipsis">
585
+
586
+
587
+ Overview
588
+
589
+
590
+
591
+ </span>
592
+
593
+
594
+
595
+ </a>
596
+ </li>
597
+
598
+
599
+
600
+
601
+
602
+
603
+
604
+
605
+
606
+
607
+ <li class="md-nav__item">
608
+ <a href="/architecture/sync-bridge/" class="md-nav__link">
609
+
610
+
611
+
612
+ <span class="md-ellipsis">
613
+
614
+
615
+ Sync Bridge
616
+
617
+
618
+
619
+ </span>
620
+
621
+
622
+
623
+ </a>
624
+ </li>
625
+
626
+
627
+
628
+
629
+ </ul>
630
+ </nav>
631
+
632
+ </li>
633
+
634
+
635
+
636
+ </ul>
637
+</nav>
638
+ </div>
639
+ </div>
640
+ </div>
641
+
642
+
643
+
644
+ <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
645
+ <div class="md-sidebar__scrollwrap">
646
+ <div class="md-sidebar__inner">
647
+
648
+
649
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
650
+
651
+
652
+
653
+
654
+</nav>
655
+ </div>
656
+ </div>
657
+ </div>
658
+
659
+
660
+
661
+ <div class="md-content" data-md-component="content">
662
+
663
+ <article class="md-content__inner md-typeset">
664
+
665
+ <h1>404 - Not found</h1>
666
+
667
+ </article>
668
+ </div>
669
+
670
+
671
+ <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
672
+
673
+<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
674
+ </div>
675
+
676
+ <button type="button" class="md-top md-icon" data-md-component="top" hidden>
677
+
678
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
679
+ Back to top
680
+</button>
681
+
682
+ </main>
683
+
684
+ <footer class="md-footer">
685
+
686
+ <div class="md-footer-meta md-typeset">
687
+ <div class="md-footer-meta__inner md-grid">
688
+ <div class="md-copyright">
689
+
690
+ <div class="md-copyright__highlight">
691
+ Copyright &copy; 2026 CONFLICT LLC
692
+ </div>
693
+
694
+
695
+ Made with
696
+ <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
697
+ Material for MkDocs
698
+ </a>
699
+
700
+</div>
701
+
702
+
703
+<div class="md-social">
704
+
705
+
706
+
707
+
708
+
709
+
710
+
711
+
712
+ <a href="https://github.com/ConflictHQ/fossilrepo" target="_blank" rel="noopener" title="github.com" class="md-social__link">
713
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
714
+ </a>
715
+
716
+</div>
717
+
718
+ </div>
719
+ </div>
720
+</footer>
721
+
722
+ </div>
723
+ <div class="md-dialog" data-md-component="dialog">
724
+ <div class="md-dialog__inner md-typeset"></div>
725
+ </div>
726
+
727
+
728
+
729
+
730
+
731
+ <script id="__config" type="application/json">{"annotate": null, "base": "/", "features": ["navigation.instant", "navigation.tabs", "navigation.sections", "navigation.expand", "navigation.top", "search.suggest", "search.highlight", "content.code.copy", "content.tabs.link", "header.autohide"], "search": "/assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
732
+
733
+
734
+ <script src="/assets/javascripts/bundle.79ae519e.min.js"></script>
735
+
736
+
737
+ </body>
738
+</html>
--- a/site/404.html
+++ b/site/404.html
@@ -0,0 +1,738 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
--- a/site/404.html
+++ b/site/404.html
@@ -0,0 +1,738 @@
1
2 <!doctype html>
3 <html lang="en" class="no-js">
4 <head>
5
6 <meta charset="utf-8">
7 <meta name="viewport" content="width=device-width,initial-scale=1">
8
9 <meta name="description" content="Self-hosted Fossil forge -- omnibus installer for production Fossil SCM hosting">
10
11
12 <meta name="author" content="CONFLICT LLC">
13
14
15
16
17
18
19
20
21 <link rel="icon" href="/assets/images/favicon.png">
22 <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
23
24
25
26 <title>Fossilrepo</title>
27
28
29
30 <link rel="stylesheet" href="/assets/stylesheets/main.484c7ddc.min.css">
31
32
33 <link rel="stylesheet" href="/assets/stylesheets/palette.ab4e12ef.min.css">
34
35
36
37
38
39
40
41
42
43
44
45
46 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
47 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
48 <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
49
50
51
52 <link rel="stylesheet" href="/assets/css/custom.css">
53
54 <script>__md_scope=new URL("/",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
55
56
57
58
59
60 </head>
61
62
63
64
65
66
67
68
69
70 <body dir="ltr" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom">
71
72
73 <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
74 <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
75 <label class="md-overlay" for="__drawer"></label>
76 <div data-md-component="skip">
77
78 </div>
79 <div data-md-component="announce">
80
81 </div>
82
83
84
85
86 <header class="md-header" data-md-component="header">
87 <nav class="md-header__inner md-grid" aria-label="Header">
88 <a href="/." title="Fossilrepo" class="md-header__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
89 <div style="display: flex; align-items: center; gap: 0.6rem;">
90 <img src="/assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
91 <img src="/assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
92 </div>
93 </a>
94 <label class="md-header__button md-icon" for="__drawer">
95
96 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
97 </label>
98 <div class="md-header__title" data-md-component="header-title">
99 <div class="md-header__ellipsis">
100 <div class="md-header__topic">
101 <span class="md-ellipsis">
102 Fossilrepo
103 </span>
104 </div>
105 <div class="md-header__topic" data-md-component="header-topic">
106 <span class="md-ellipsis">
107
108
109
110 </span>
111 </div>
112 </div>
113 </div>
114
115
116 <form class="md-header__option" data-md-component="palette">
117
118
119
120
121 <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">
122
123 <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
124 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
125 </label>
126
127
128
129
130
131 <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
132
133 <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>
134 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
135 </label>
136
137
138 </form>
139
140
141
142 <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
143
144
145
146
147
148 <label class="md-header__button md-icon" for="__search">
149
150 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
151 </label>
152 <div class="md-search" data-md-component="search" role="dialog">
153 <label class="md-search__overlay" for="__search"></label>
154 <div class="md-search__inner" role="search">
155 <form class="md-search__form" name="search">
156 <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
157 <label class="md-search__icon md-icon" for="__search">
158
159 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
160
161 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
162 </label>
163 <nav class="md-search__options" aria-label="Search">
164
165 <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
166
167 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
168 </button>
169 </nav>
170
171 <div class="md-search__suggest" data-md-component="search-suggest"></div>
172
173 </form>
174 <div class="md-search__output">
175 <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
176 <div class="md-search-result" data-md-component="search-result">
177 <div class="md-search-result__meta">
178 Initializing search
179 </div>
180 <ol class="md-search-result__list" role="presentation"></ol>
181 </div>
182 </div>
183 </div>
184 </div>
185 </div>
186
187
188
189 <div class="md-header__source">
190 <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
191 <div class="md-source__icon md-icon">
192
193 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
194 </div>
195 <div class="md-source__repository">
196 ConflictHQ/fossilrepo
197 </div>
198 </a>
199 </div>
200
201 </nav>
202
203 </header>
204
205 <div class="md-container" data-md-component="container">
206
207
208
209
210
211 <nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
212 <div class="md-grid">
213 <ul class="md-tabs__list">
214
215
216
217
218
219
220 <li class="md-tabs__item">
221 <a href="/." class="md-tabs__link">
222
223
224
225
226
227 Home
228
229 </a>
230 </li>
231
232
233
234
235
236
237
238
239
240
241 <li class="md-tabs__item">
242 <a href="/getting-started/prerequisites/" class="md-tabs__link">
243
244
245
246 Getting Started
247
248 </a>
249 </li>
250
251
252
253
254
255
256
257
258
259
260
261 <li class="md-tabs__item">
262 <a href="/architecture/overview/" class="md-tabs__link">
263
264
265
266 Architecture
267
268 </a>
269 </li>
270
271
272
273
274 </ul>
275 </div>
276 </nav>
277
278
279
280 <main class="md-main" data-md-component="main">
281 <div class="md-main__inner md-grid">
282
283
284
285 <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
286 <div class="md-sidebar__scrollwrap">
287 <div class="md-sidebar__inner">
288
289
290
291
292
293
294 <nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
295 <label class="md-nav__title" for="__drawer">
296 <a href="/." title="Fossilrepo" class="md-nav__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
297 <div style="display: flex; align-items: center; gap: 0.6rem;">
298 <img src="/assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
299 <img src="/assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
300 </div>
301 </a>
302 Fossilrepo
303 </label>
304
305 <div class="md-nav__source">
306 <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
307 <div class="md-source__icon md-icon">
308
309 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
310 </div>
311 <div class="md-source__repository">
312 ConflictHQ/fossilrepo
313 </div>
314 </a>
315 </div>
316
317 <ul class="md-nav__list" data-md-scrollfix>
318
319
320
321
322
323
324
325 <li class="md-nav__item">
326 <a href="/." class="md-nav__link">
327
328
329
330 <span class="md-ellipsis">
331
332
333 Home
334
335
336
337 </span>
338
339
340
341 </a>
342 </li>
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362 <li class="md-nav__item md-nav__item--nested">
363
364
365
366
367
368 <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
369
370
371 <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
372
373
374
375 <span class="md-ellipsis">
376
377
378 Getting Started
379
380
381
382 </span>
383
384
385
386 <span class="md-nav__icon md-icon"></span>
387 </label>
388
389 <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
390 <label class="md-nav__title" for="__nav_2">
391 <span class="md-nav__icon md-icon"></span>
392
393
394 Getting Started
395
396
397 </label>
398 <ul class="md-nav__list" data-md-scrollfix>
399
400
401
402
403
404
405
406 <li class="md-nav__item">
407 <a href="/getting-started/prerequisites/" class="md-nav__link">
408
409
410
411 <span class="md-ellipsis">
412
413
414 Prerequisites
415
416
417
418 </span>
419
420
421
422 </a>
423 </li>
424
425
426
427
428
429
430
431
432
433
434 <li class="md-nav__item">
435 <a href="/getting-started/installation/" class="md-nav__link">
436
437
438
439 <span class="md-ellipsis">
440
441
442 Installation
443
444
445
446 </span>
447
448
449
450 </a>
451 </li>
452
453
454
455
456
457
458
459
460
461
462 <li class="md-nav__item">
463 <a href="/getting-started/configuration/" class="md-nav__link">
464
465
466
467 <span class="md-ellipsis">
468
469
470 Configuration
471
472
473
474 </span>
475
476
477
478 </a>
479 </li>
480
481
482
483
484
485
486
487
488
489
490 <li class="md-nav__item">
491 <a href="/getting-started/first-repo/" class="md-nav__link">
492
493
494
495 <span class="md-ellipsis">
496
497
498 First Repository
499
500
501
502 </span>
503
504
505
506 </a>
507 </li>
508
509
510
511
512 </ul>
513 </nav>
514
515 </li>
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535 <li class="md-nav__item md-nav__item--nested">
536
537
538
539
540
541 <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
542
543
544 <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
545
546
547
548 <span class="md-ellipsis">
549
550
551 Architecture
552
553
554
555 </span>
556
557
558
559 <span class="md-nav__icon md-icon"></span>
560 </label>
561
562 <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
563 <label class="md-nav__title" for="__nav_3">
564 <span class="md-nav__icon md-icon"></span>
565
566
567 Architecture
568
569
570 </label>
571 <ul class="md-nav__list" data-md-scrollfix>
572
573
574
575
576
577
578
579 <li class="md-nav__item">
580 <a href="/architecture/overview/" class="md-nav__link">
581
582
583
584 <span class="md-ellipsis">
585
586
587 Overview
588
589
590
591 </span>
592
593
594
595 </a>
596 </li>
597
598
599
600
601
602
603
604
605
606
607 <li class="md-nav__item">
608 <a href="/architecture/sync-bridge/" class="md-nav__link">
609
610
611
612 <span class="md-ellipsis">
613
614
615 Sync Bridge
616
617
618
619 </span>
620
621
622
623 </a>
624 </li>
625
626
627
628
629 </ul>
630 </nav>
631
632 </li>
633
634
635
636 </ul>
637 </nav>
638 </div>
639 </div>
640 </div>
641
642
643
644 <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
645 <div class="md-sidebar__scrollwrap">
646 <div class="md-sidebar__inner">
647
648
649 <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
650
651
652
653
654 </nav>
655 </div>
656 </div>
657 </div>
658
659
660
661 <div class="md-content" data-md-component="content">
662
663 <article class="md-content__inner md-typeset">
664
665 <h1>404 - Not found</h1>
666
667 </article>
668 </div>
669
670
671 <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
672
673 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
674 </div>
675
676 <button type="button" class="md-top md-icon" data-md-component="top" hidden>
677
678 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
679 Back to top
680 </button>
681
682 </main>
683
684 <footer class="md-footer">
685
686 <div class="md-footer-meta md-typeset">
687 <div class="md-footer-meta__inner md-grid">
688 <div class="md-copyright">
689
690 <div class="md-copyright__highlight">
691 Copyright &copy; 2026 CONFLICT LLC
692 </div>
693
694
695 Made with
696 <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
697 Material for MkDocs
698 </a>
699
700 </div>
701
702
703 <div class="md-social">
704
705
706
707
708
709
710
711
712 <a href="https://github.com/ConflictHQ/fossilrepo" target="_blank" rel="noopener" title="github.com" class="md-social__link">
713 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
714 </a>
715
716 </div>
717
718 </div>
719 </div>
720 </footer>
721
722 </div>
723 <div class="md-dialog" data-md-component="dialog">
724 <div class="md-dialog__inner md-typeset"></div>
725 </div>
726
727
728
729
730
731 <script id="__config" type="application/json">{"annotate": null, "base": "/", "features": ["navigation.instant", "navigation.tabs", "navigation.sections", "navigation.expand", "navigation.top", "search.suggest", "search.highlight", "content.code.copy", "content.tabs.link", "header.autohide"], "search": "/assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
732
733
734 <script src="/assets/javascripts/bundle.79ae519e.min.js"></script>
735
736
737 </body>
738 </html>
A site/CNAME
+1
--- a/site/CNAME
+++ b/site/CNAME
@@ -0,0 +1 @@
1
+fossilrepo.dev
--- a/site/CNAME
+++ b/site/CNAME
@@ -0,0 +1 @@
 
--- a/site/CNAME
+++ b/site/CNAME
@@ -0,0 +1 @@
1 fossilrepo.dev
A site/architecture/overview/index.html
+1099
--- a/site/architecture/overview/index.html
+++ b/site/architecture/overview/index.html
@@ -0,0 +1,1099 @@
1
+
2
+<!doctype html>
3
+<html lang="en" class="no-js">
4
+ <head>
5
+
6
+ <meta charset="utf-8">
7
+ <meta name="viewport" content="width=device-width,initial-scale=1">
8
+
9
+ <meta name="description" content="Self-hosted Fossil forge -- omnibus installer for production Fossil SCM hosting">
10
+
11
+
12
+ <meta name="author" content="CONFLICT LLC">
13
+
14
+
15
+ <link rel="canonical" href="https://fossilrepo.dev/architecture/overview/">
16
+
17
+
18
+ <link rel="prev" href="../../getting-started/first-repo/">
19
+
20
+
21
+ <link rel="next" href="../sync-bridge/">
22
+
23
+
24
+
25
+
26
+
27
+ <link rel="icon" href="../../assets/images/favicon.png">
28
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
29
+
30
+
31
+
32
+ <title>Overview - Fossilrepo</title>
33
+
34
+
35
+
36
+ <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
37
+
38
+
39
+ <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
40
+
41
+
42
+
43
+
44
+
45
+
46
+
47
+
48
+
49
+
50
+
51
+
52
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
53
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
54
+ <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
55
+
56
+
57
+
58
+ <link rel="stylesheet" href="../../assets/css/custom.css">
59
+
60
+ <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
61
+
62
+
63
+
64
+
65
+
66
+ </head>
67
+
68
+
69
+
70
+
71
+
72
+
73
+
74
+
75
+
76
+ <body dir="ltr" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom">
77
+
78
+
79
+ <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
80
+ <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
81
+ <label class="md-overlay" for="__drawer"></label>
82
+ <div data-md-component="skip">
83
+
84
+
85
+ <a href="#architecture-overview" class="md-skip">
86
+ Skip to content
87
+ </a>
88
+
89
+ </div>
90
+ <div data-md-component="announce">
91
+
92
+ </div>
93
+
94
+
95
+
96
+
97
+<header class="md-header" data-md-component="header">
98
+ <nav class="md-header__inner md-grid" aria-label="Header">
99
+ <a href="../.." title="Fossilrepo" class="md-header__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
100
+ <div style="display: flex; align-items: center; gap: 0.6rem;">
101
+ <img src="../../assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
102
+ <img src="../../assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
103
+</div>
104
+ </a>
105
+ <label class="md-header__button md-icon" for="__drawer">
106
+
107
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
108
+ </label>
109
+ <div class="md-header__title" data-md-component="header-title">
110
+ <div class="md-header__ellipsis">
111
+ <div class="md-header__topic">
112
+ <span class="md-ellipsis">
113
+ Fossilrepo
114
+ </span>
115
+ </div>
116
+ <div class="md-header__topic" data-md-component="header-topic">
117
+ <span class="md-ellipsis">
118
+
119
+ Overview
120
+
121
+ </span>
122
+ </div>
123
+ </div>
124
+ </div>
125
+
126
+
127
+ <form class="md-header__option" data-md-component="palette">
128
+
129
+
130
+
131
+
132
+ <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">
133
+
134
+ <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
135
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
136
+ </label>
137
+
138
+
139
+
140
+
141
+
142
+ <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
143
+
144
+ <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>
145
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
146
+ </label>
147
+
148
+
149
+</form>
150
+
151
+
152
+
153
+ <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
154
+
155
+
156
+
157
+
158
+
159
+ <label class="md-header__button md-icon" for="__search">
160
+
161
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
162
+ </label>
163
+ <div class="md-search" data-md-component="search" role="dialog">
164
+ <label class="md-search__overlay" for="__search"></label>
165
+ <div class="md-search__inner" role="search">
166
+ <form class="md-search__form" name="search">
167
+ <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
168
+ <label class="md-search__icon md-icon" for="__search">
169
+
170
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
171
+
172
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
173
+ </label>
174
+ <nav class="md-search__options" aria-label="Search">
175
+
176
+ <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
177
+
178
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
179
+ </button>
180
+ </nav>
181
+
182
+ <div class="md-search__suggest" data-md-component="search-suggest"></div>
183
+
184
+ </form>
185
+ <div class="md-search__output">
186
+ <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
187
+ <div class="md-search-result" data-md-component="search-result">
188
+ <div class="md-search-result__meta">
189
+ Initializing search
190
+ </div>
191
+ <ol class="md-search-result__list" role="presentation"></ol>
192
+ </div>
193
+ </div>
194
+ </div>
195
+ </div>
196
+</div>
197
+
198
+
199
+
200
+ <div class="md-header__source">
201
+ <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
202
+ <div class="md-source__icon md-icon">
203
+
204
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
205
+ </div>
206
+ <div class="md-source__repository">
207
+ ConflictHQ/fossilrepo
208
+ </div>
209
+</a>
210
+ </div>
211
+
212
+ </nav>
213
+
214
+</header>
215
+
216
+ <div class="md-container" data-md-component="container">
217
+
218
+
219
+
220
+
221
+
222
+<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
223
+ <div class="md-grid">
224
+ <ul class="md-tabs__list">
225
+
226
+
227
+
228
+
229
+
230
+
231
+ <li class="md-tabs__item">
232
+ <a href="../.." class="md-tabs__link">
233
+
234
+
235
+
236
+
237
+
238
+ Home
239
+
240
+ </a>
241
+ </li>
242
+
243
+
244
+
245
+
246
+
247
+
248
+
249
+
250
+
251
+
252
+ <li class="md-tabs__item">
253
+ <a href="../../getting-started/prerequisites/" class="md-tabs__link">
254
+
255
+
256
+
257
+ Getting Started
258
+
259
+ </a>
260
+ </li>
261
+
262
+
263
+
264
+
265
+
266
+
267
+
268
+
269
+
270
+
271
+
272
+
273
+
274
+ <li class="md-tabs__item md-tabs__item--active">
275
+ <a href="./" class="md-tabs__link">
276
+
277
+
278
+
279
+ Architecture
280
+
281
+ </a>
282
+ </li>
283
+
284
+
285
+
286
+
287
+ </ul>
288
+ </div>
289
+</nav>
290
+
291
+
292
+
293
+ <main class="md-main" data-md-component="main">
294
+ <div class="md-main__inner md-grid">
295
+
296
+
297
+
298
+ <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
299
+ <div class="md-sidebar__scrollwrap">
300
+ <div class="md-sidebar__inner">
301
+
302
+
303
+
304
+
305
+
306
+
307
+<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
308
+ <label class="md-nav__title" for="__drawer">
309
+ <a href="../.." title="Fossilrepo" class="md-nav__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
310
+ <div style="display: flex; align-items: center; gap: 0.6rem;">
311
+ <img src="../../assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
312
+ <img src="../../assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
313
+</div>
314
+ </a>
315
+ Fossilrepo
316
+ </label>
317
+
318
+ <div class="md-nav__source">
319
+ <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
320
+ <div class="md-source__icon md-icon">
321
+
322
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
323
+ </div>
324
+ <div class="md-source__repository">
325
+ ConflictHQ/fossilrepo
326
+ </div>
327
+</a>
328
+ </div>
329
+
330
+ <ul class="md-nav__list" data-md-scrollfix>
331
+
332
+
333
+
334
+
335
+
336
+
337
+
338
+ <li class="md-nav__item">
339
+ <a href="../.." class="md-nav__link">
340
+
341
+
342
+
343
+ <span class="md-ellipsis">
344
+
345
+
346
+ Home
347
+
348
+
349
+
350
+ </span>
351
+
352
+
353
+
354
+ </a>
355
+ </li>
356
+
357
+
358
+
359
+
360
+
361
+
362
+
363
+
364
+
365
+
366
+
367
+
368
+
369
+
370
+
371
+
372
+
373
+
374
+
375
+ <li class="md-nav__item md-nav__item--nested">
376
+
377
+
378
+
379
+
380
+
381
+ <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
382
+
383
+
384
+ <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
385
+
386
+
387
+
388
+ <span class="md-ellipsis">
389
+
390
+
391
+ Getting Started
392
+
393
+
394
+
395
+ </span>
396
+
397
+
398
+
399
+ <span class="md-nav__icon md-icon"></span>
400
+ </label>
401
+
402
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
403
+ <label class="md-nav__title" for="__nav_2">
404
+ <span class="md-nav__icon md-icon"></span>
405
+
406
+
407
+ Getting Started
408
+
409
+
410
+ </label>
411
+ <ul class="md-nav__list" data-md-scrollfix>
412
+
413
+
414
+
415
+
416
+
417
+
418
+
419
+ <li class="md-nav__item">
420
+ <a href="../../getting-started/prerequisites/" class="md-nav__link">
421
+
422
+
423
+
424
+ <span class="md-ellipsis">
425
+
426
+
427
+ Prerequisites
428
+
429
+
430
+
431
+ </span>
432
+
433
+
434
+
435
+ </a>
436
+ </li>
437
+
438
+
439
+
440
+
441
+
442
+
443
+
444
+
445
+
446
+
447
+ <li class="md-nav__item">
448
+ <a href="../../getting-started/installation/" class="md-nav__link">
449
+
450
+
451
+
452
+ <span class="md-ellipsis">
453
+
454
+
455
+ Installation
456
+
457
+
458
+
459
+ </span>
460
+
461
+
462
+
463
+ </a>
464
+ </li>
465
+
466
+
467
+
468
+
469
+
470
+
471
+
472
+
473
+
474
+
475
+ <li class="md-nav__item">
476
+ <a href="../../getting-started/configuration/" class="md-nav__link">
477
+
478
+
479
+
480
+ <span class="md-ellipsis">
481
+
482
+
483
+ Configuration
484
+
485
+
486
+
487
+ </span>
488
+
489
+
490
+
491
+ </a>
492
+ </li>
493
+
494
+
495
+
496
+
497
+
498
+
499
+
500
+
501
+
502
+
503
+ <li class="md-nav__item">
504
+ <a href="../../getting-started/first-repo/" class="md-nav__link">
505
+
506
+
507
+
508
+ <span class="md-ellipsis">
509
+
510
+
511
+ First Repository
512
+
513
+
514
+
515
+ </span>
516
+
517
+
518
+
519
+ </a>
520
+ </li>
521
+
522
+
523
+
524
+
525
+ </ul>
526
+ </nav>
527
+
528
+ </li>
529
+
530
+
531
+
532
+
533
+
534
+
535
+
536
+
537
+
538
+
539
+
540
+
541
+
542
+
543
+
544
+
545
+
546
+
547
+
548
+
549
+
550
+
551
+
552
+
553
+ <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
554
+
555
+
556
+
557
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
558
+
559
+
560
+ <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
561
+
562
+
563
+
564
+ <span class="md-ellipsis">
565
+
566
+
567
+ Architecture
568
+
569
+
570
+
571
+ </span>
572
+
573
+
574
+
575
+ <span class="md-nav__icon md-icon"></span>
576
+ </label>
577
+
578
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
579
+ <label class="md-nav__title" for="__nav_3">
580
+ <span class="md-nav__icon md-icon"></span>
581
+
582
+
583
+ Architecture
584
+
585
+
586
+ </label>
587
+ <ul class="md-nav__list" data-md-scrollfix>
588
+
589
+
590
+
591
+
592
+
593
+
594
+
595
+
596
+
597
+ <li class="md-nav__item md-nav__item--active">
598
+
599
+ <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
600
+
601
+
602
+
603
+
604
+
605
+ <label class="md-nav__link md-nav__link--active" for="__toc">
606
+
607
+
608
+
609
+ <span class="md-ellipsis">
610
+
611
+
612
+ Overview
613
+
614
+
615
+
616
+ </span>
617
+
618
+
619
+
620
+ <span class="md-nav__icon md-icon"></span>
621
+ </label>
622
+
623
+ <a href="./" class="md-nav__link md-nav__link--active">
624
+
625
+
626
+
627
+ <span class="md-ellipsis">
628
+
629
+
630
+ Overview
631
+
632
+
633
+
634
+ </span>
635
+
636
+
637
+
638
+ </a>
639
+
640
+
641
+
642
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
643
+
644
+
645
+
646
+
647
+
648
+
649
+ <label class="md-nav__title" for="__toc">
650
+ <span class="md-nav__icon md-icon"></span>
651
+ Table of contents
652
+ </label>
653
+ <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
654
+
655
+ <li class="md-nav__item">
656
+ <a href="#system-diagram" class="md-nav__link">
657
+ <span class="md-ellipsis">
658
+
659
+ System Diagram
660
+
661
+ </span>
662
+ </a>
663
+
664
+</li>
665
+
666
+ <li class="md-nav__item">
667
+ <a href="#components" class="md-nav__link">
668
+ <span class="md-ellipsis">
669
+
670
+ Components
671
+
672
+ </span>
673
+ </a>
674
+
675
+ <nav class="md-nav" aria-label="Components">
676
+ <ul class="md-nav__list">
677
+
678
+ <li class="md-nav__item">
679
+ <a href="#fossil-server" class="md-nav__link">
680
+ <span class="md-ellipsis">
681
+
682
+ Fossil Server
683
+
684
+ </span>
685
+ </a>
686
+
687
+</li>
688
+
689
+ <li class="md-nav__item">
690
+ <a href="#caddy" class="md-nav__link">
691
+ <span class="md-ellipsis">
692
+
693
+ Caddy
694
+
695
+ </span>
696
+ </a>
697
+
698
+</li>
699
+
700
+ <li class="md-nav__item">
701
+ <a href="#django-management-layer" class="md-nav__link">
702
+ <span class="md-ellipsis">
703
+
704
+ Django Management Layer
705
+
706
+ </span>
707
+ </a>
708
+
709
+</li>
710
+
711
+ <li class="md-nav__item">
712
+ <a href="#litestream" class="md-nav__link">
713
+ <span class="md-ellipsis">
714
+
715
+ Litestream
716
+
717
+ </span>
718
+ </a>
719
+
720
+</li>
721
+
722
+ <li class="md-nav__item">
723
+ <a href="#celery-workers" class="md-nav__link">
724
+ <span class="md-ellipsis">
725
+
726
+ Celery Workers
727
+
728
+ </span>
729
+ </a>
730
+
731
+</li>
732
+
733
+ </ul>
734
+ </nav>
735
+
736
+</li>
737
+
738
+ <li class="md-nav__item">
739
+ <a href="#data-flow" class="md-nav__link">
740
+ <span class="md-ellipsis">
741
+
742
+ Data Flow
743
+
744
+ </span>
745
+ </a>
746
+
747
+</li>
748
+
749
+ </ul>
750
+
751
+</nav>
752
+
753
+ </li>
754
+
755
+
756
+
757
+
758
+
759
+
760
+
761
+
762
+
763
+
764
+ <li class="md-nav__item">
765
+ <a href="../sync-bridge/" class="md-nav__link">
766
+
767
+
768
+
769
+ <span class="md-ellipsis">
770
+
771
+
772
+ Sync Bridge
773
+
774
+
775
+
776
+ </span>
777
+
778
+
779
+
780
+ </a>
781
+ </li>
782
+
783
+
784
+
785
+
786
+ </ul>
787
+ </nav>
788
+
789
+ </li>
790
+
791
+
792
+
793
+ </ul>
794
+</nav>
795
+ </div>
796
+ </div>
797
+ </div>
798
+
799
+
800
+
801
+ <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
802
+ <div class="md-sidebar__scrollwrap">
803
+ <div class="md-sidebar__inner">
804
+
805
+
806
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
807
+
808
+
809
+
810
+
811
+
812
+
813
+ <label class="md-nav__title" for="__toc">
814
+ <span class="md-nav__icon md-icon"></span>
815
+ Table of contents
816
+ </label>
817
+ <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
818
+
819
+ <li class="md-nav__item">
820
+ <a href="#system-diagram" class="md-nav__link">
821
+ <span class="md-ellipsis">
822
+
823
+ System Diagram
824
+
825
+ </span>
826
+ </a>
827
+
828
+</li>
829
+
830
+ <li class="md-nav__item">
831
+ <a href="#components" class="md-nav__link">
832
+ <span class="md-ellipsis">
833
+
834
+ Components
835
+
836
+ </span>
837
+ </a>
838
+
839
+ <nav class="md-nav" aria-label="Components">
840
+ <ul class="md-nav__list">
841
+
842
+ <li class="md-nav__item">
843
+ <a href="#fossil-server" class="md-nav__link">
844
+ <span class="md-ellipsis">
845
+
846
+ Fossil Server
847
+
848
+ </span>
849
+ </a>
850
+
851
+</li>
852
+
853
+ <li class="md-nav__item">
854
+ <a href="#caddy" class="md-nav__link">
855
+ <span class="md-ellipsis">
856
+
857
+ Caddy
858
+
859
+ </span>
860
+ </a>
861
+
862
+</li>
863
+
864
+ <li class="md-nav__item">
865
+ <a href="#django-management-layer" class="md-nav__link">
866
+ <span class="md-ellipsis">
867
+
868
+ Django Management Layer
869
+
870
+ </span>
871
+ </a>
872
+
873
+</li>
874
+
875
+ <li class="md-nav__item">
876
+ <a href="#litestream" class="md-nav__link">
877
+ <span class="md-ellipsis">
878
+
879
+ Litestream
880
+
881
+ </span>
882
+ </a>
883
+
884
+</li>
885
+
886
+ <li class="md-nav__item">
887
+ <a href="#celery-workers" class="md-nav__link">
888
+ <span class="md-ellipsis">
889
+
890
+ Celery Workers
891
+
892
+ </span>
893
+ </a>
894
+
895
+</li>
896
+
897
+ </ul>
898
+ </nav>
899
+
900
+</li>
901
+
902
+ <li class="md-nav__item">
903
+ <a href="#data-flow" class="md-nav__link">
904
+ <span class="md-ellipsis">
905
+
906
+ Data Flow
907
+
908
+ </span>
909
+ </a>
910
+
911
+</li>
912
+
913
+ </ul>
914
+
915
+</nav>
916
+ </div>
917
+ </div>
918
+ </div>
919
+
920
+
921
+
922
+ <div class="md-content" data-md-component="content">
923
+
924
+ <article class="md-content__inner md-typeset">
925
+
926
+
927
+
928
+
929
+
930
+
931
+
932
+
933
+<h1 id="architecture-overview">Architecture Overview<a class="headerlink" href="#architecture-overview" title="Permanent link">&para;</a></h1>
934
+<p>Fossilrepo is a thin orchestration layer around Fossil SCM. Fossil does the heavy lifting -- fossilrepo handles provisioning, routing, backups, and the management UI.</p>
935
+<h2 id="system-diagram">System Diagram<a class="headerlink" href="#system-diagram" title="Permanent link">&para;</a></h2>
936
+<pre class="mermaid"><code>graph TB
937
+ subgraph Internet
938
+ User[User / Browser]
939
+ end
940
+
941
+ subgraph Fossilrepo Server
942
+ Caddy[Caddy&lt;br/&gt;SSL + Routing]
943
+ Django[Django&lt;br/&gt;Management UI]
944
+ Fossil[Fossil Server&lt;br/&gt;--repolist]
945
+ Celery[Celery Workers]
946
+ Redis[Redis]
947
+ Postgres[(PostgreSQL)]
948
+ Litestream[Litestream]
949
+ end
950
+
951
+ subgraph Storage
952
+ Repos["/data/repos/&lt;br/&gt;*.fossil files"]
953
+ S3[(S3 / MinIO)]
954
+ end
955
+
956
+ subgraph Mirrors
957
+ GitHub[GitHub]
958
+ GitLab[GitLab]
959
+ end
960
+
961
+ User --&gt; Caddy
962
+ Caddy --&gt;|"app.domain.com"| Django
963
+ Caddy --&gt;|"repo.domain.com"| Fossil
964
+ Django --&gt; Postgres
965
+ Django --&gt; Redis
966
+ Celery --&gt; Redis
967
+ Celery --&gt;|sync bridge| GitHub
968
+ Celery --&gt;|sync bridge| GitLab
969
+ Fossil --&gt; Repos
970
+ Litestream --&gt; Repos
971
+ Litestream --&gt; S3</code></pre>
972
+<h2 id="components">Components<a class="headerlink" href="#components" title="Permanent link">&para;</a></h2>
973
+<h3 id="fossil-server">Fossil Server<a class="headerlink" href="#fossil-server" title="Permanent link">&para;</a></h3>
974
+<p>A single <code>fossil server --repolist /data/repos/</code> process serves all repositories. Each <code>.fossil</code> file is a self-contained SQLite database with VCS history, issues, wiki, and forum.</p>
975
+<p>Adding a new repo is just <code>fossil init /data/repos/name.fossil</code> -- no restart needed.</p>
976
+<h3 id="caddy">Caddy<a class="headerlink" href="#caddy" title="Permanent link">&para;</a></h3>
977
+<p>Handles SSL termination and subdomain routing:</p>
978
+<ul>
979
+<li><code>your-domain.com</code> routes to the Django management UI</li>
980
+<li><code>reponame.your-domain.com</code> routes directly to Fossil's web UI</li>
981
+</ul>
982
+<p>Caddy automatically provisions and renews Let's Encrypt certificates.</p>
983
+<h3 id="django-management-layer">Django Management Layer<a class="headerlink" href="#django-management-layer" title="Permanent link">&para;</a></h3>
984
+<p>Provides the administrative interface:</p>
985
+<ul>
986
+<li>Repository lifecycle (create, configure, archive)</li>
987
+<li>User and organization management</li>
988
+<li>Dashboard and analytics</li>
989
+<li>Sync bridge configuration</li>
990
+</ul>
991
+<p>Django uses HTMX for interactive UI without a JavaScript framework.</p>
992
+<h3 id="litestream">Litestream<a class="headerlink" href="#litestream" title="Permanent link">&para;</a></h3>
993
+<p>Continuously replicates every <code>.fossil</code> SQLite file to S3-compatible storage. Provides:</p>
994
+<ul>
995
+<li><strong>Continuous backup</strong> -- WAL frames replicated in near-real-time</li>
996
+<li><strong>Point-in-time recovery</strong> -- restore to any moment, not just snapshots</li>
997
+<li><strong>Zero-config per repo</strong> -- new <code>.fossil</code> files are picked up automatically</li>
998
+</ul>
999
+<h3 id="celery-workers">Celery Workers<a class="headerlink" href="#celery-workers" title="Permanent link">&para;</a></h3>
1000
+<p>Handle background tasks:</p>
1001
+<ul>
1002
+<li>Sync bridge execution (Fossil to Git mirroring)</li>
1003
+<li>Scheduled sync jobs</li>
1004
+<li>Upstream pull operations</li>
1005
+</ul>
1006
+<h2 id="data-flow">Data Flow<a class="headerlink" href="#data-flow" title="Permanent link">&para;</a></h2>
1007
+<ol>
1008
+<li><strong>User pushes to Fossil</strong> -- standard <code>fossil push</code> or <code>fossil sync</code></li>
1009
+<li><strong>Fossil writes to <code>.fossil</code> file</strong> -- SQLite transactions</li>
1010
+<li><strong>Litestream replicates</strong> -- WAL frames streamed to S3</li>
1011
+<li><strong>Sync bridge runs</strong> -- Celery task mirrors changes to Git remotes</li>
1012
+<li><strong>Django reflects state</strong> -- reads from Fossil SQLite for dashboards</li>
1013
+</ol>
1014
+<p>Fossil is always the source of truth. Everything else is derived.</p>
1015
+
1016
+
1017
+
1018
+
1019
+
1020
+
1021
+
1022
+
1023
+
1024
+
1025
+
1026
+
1027
+
1028
+ </article>
1029
+ </div>
1030
+
1031
+
1032
+ <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
1033
+
1034
+<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
1035
+ </div>
1036
+
1037
+ <button type="button" class="md-top md-icon" data-md-component="top" hidden>
1038
+
1039
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
1040
+ Back to top
1041
+</button>
1042
+
1043
+ </main>
1044
+
1045
+ <footer class="md-footer">
1046
+
1047
+ <div class="md-footer-meta md-typeset">
1048
+ <div class="md-footer-meta__inner md-grid">
1049
+ <div class="md-copyright">
1050
+
1051
+ <div class="md-copyright__highlight">
1052
+ Copyright &copy; 2026 CONFLICT LLC
1053
+ </div>
1054
+
1055
+
1056
+ Made with
1057
+ <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
1058
+ Material for MkDocs
1059
+ </a>
1060
+
1061
+</div>
1062
+
1063
+
1064
+<div class="md-social">
1065
+
1066
+
1067
+
1068
+
1069
+
1070
+
1071
+
1072
+
1073
+ <a href="https://github.com/ConflictHQ/fossilrepo" target="_blank" rel="noopener" title="github.com" class="md-social__link">
1074
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
1075
+ </a>
1076
+
1077
+</div>
1078
+
1079
+ </div>
1080
+ </div>
1081
+</footer>
1082
+
1083
+ </div>
1084
+ <div class="md-dialog" data-md-component="dialog">
1085
+ <div class="md-dialog__inner md-typeset"></div>
1086
+ </div>
1087
+
1088
+
1089
+
1090
+
1091
+
1092
+ <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.instant", "navigation.tabs", "navigation.sections", "navigation.expand", "navigation.top", "search.suggest", "search.highlight", "content.code.copy", "content.tabs.link", "header.autohide"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
1093
+
1094
+
1095
+ <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
1096
+
1097
+
1098
+ </body>
1099
+</html>
--- a/site/architecture/overview/index.html
+++ b/site/architecture/overview/index.html
@@ -0,0 +1,1099 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
--- a/site/architecture/overview/index.html
+++ b/site/architecture/overview/index.html
@@ -0,0 +1,1099 @@
1
2 <!doctype html>
3 <html lang="en" class="no-js">
4 <head>
5
6 <meta charset="utf-8">
7 <meta name="viewport" content="width=device-width,initial-scale=1">
8
9 <meta name="description" content="Self-hosted Fossil forge -- omnibus installer for production Fossil SCM hosting">
10
11
12 <meta name="author" content="CONFLICT LLC">
13
14
15 <link rel="canonical" href="https://fossilrepo.dev/architecture/overview/">
16
17
18 <link rel="prev" href="../../getting-started/first-repo/">
19
20
21 <link rel="next" href="../sync-bridge/">
22
23
24
25
26
27 <link rel="icon" href="../../assets/images/favicon.png">
28 <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
29
30
31
32 <title>Overview - Fossilrepo</title>
33
34
35
36 <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
37
38
39 <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
40
41
42
43
44
45
46
47
48
49
50
51
52 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
53 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
54 <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
55
56
57
58 <link rel="stylesheet" href="../../assets/css/custom.css">
59
60 <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
61
62
63
64
65
66 </head>
67
68
69
70
71
72
73
74
75
76 <body dir="ltr" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom">
77
78
79 <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
80 <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
81 <label class="md-overlay" for="__drawer"></label>
82 <div data-md-component="skip">
83
84
85 <a href="#architecture-overview" class="md-skip">
86 Skip to content
87 </a>
88
89 </div>
90 <div data-md-component="announce">
91
92 </div>
93
94
95
96
97 <header class="md-header" data-md-component="header">
98 <nav class="md-header__inner md-grid" aria-label="Header">
99 <a href="../.." title="Fossilrepo" class="md-header__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
100 <div style="display: flex; align-items: center; gap: 0.6rem;">
101 <img src="../../assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
102 <img src="../../assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
103 </div>
104 </a>
105 <label class="md-header__button md-icon" for="__drawer">
106
107 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
108 </label>
109 <div class="md-header__title" data-md-component="header-title">
110 <div class="md-header__ellipsis">
111 <div class="md-header__topic">
112 <span class="md-ellipsis">
113 Fossilrepo
114 </span>
115 </div>
116 <div class="md-header__topic" data-md-component="header-topic">
117 <span class="md-ellipsis">
118
119 Overview
120
121 </span>
122 </div>
123 </div>
124 </div>
125
126
127 <form class="md-header__option" data-md-component="palette">
128
129
130
131
132 <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">
133
134 <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
135 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
136 </label>
137
138
139
140
141
142 <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
143
144 <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>
145 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
146 </label>
147
148
149 </form>
150
151
152
153 <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
154
155
156
157
158
159 <label class="md-header__button md-icon" for="__search">
160
161 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
162 </label>
163 <div class="md-search" data-md-component="search" role="dialog">
164 <label class="md-search__overlay" for="__search"></label>
165 <div class="md-search__inner" role="search">
166 <form class="md-search__form" name="search">
167 <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
168 <label class="md-search__icon md-icon" for="__search">
169
170 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
171
172 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
173 </label>
174 <nav class="md-search__options" aria-label="Search">
175
176 <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
177
178 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
179 </button>
180 </nav>
181
182 <div class="md-search__suggest" data-md-component="search-suggest"></div>
183
184 </form>
185 <div class="md-search__output">
186 <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
187 <div class="md-search-result" data-md-component="search-result">
188 <div class="md-search-result__meta">
189 Initializing search
190 </div>
191 <ol class="md-search-result__list" role="presentation"></ol>
192 </div>
193 </div>
194 </div>
195 </div>
196 </div>
197
198
199
200 <div class="md-header__source">
201 <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
202 <div class="md-source__icon md-icon">
203
204 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
205 </div>
206 <div class="md-source__repository">
207 ConflictHQ/fossilrepo
208 </div>
209 </a>
210 </div>
211
212 </nav>
213
214 </header>
215
216 <div class="md-container" data-md-component="container">
217
218
219
220
221
222 <nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
223 <div class="md-grid">
224 <ul class="md-tabs__list">
225
226
227
228
229
230
231 <li class="md-tabs__item">
232 <a href="../.." class="md-tabs__link">
233
234
235
236
237
238 Home
239
240 </a>
241 </li>
242
243
244
245
246
247
248
249
250
251
252 <li class="md-tabs__item">
253 <a href="../../getting-started/prerequisites/" class="md-tabs__link">
254
255
256
257 Getting Started
258
259 </a>
260 </li>
261
262
263
264
265
266
267
268
269
270
271
272
273
274 <li class="md-tabs__item md-tabs__item--active">
275 <a href="./" class="md-tabs__link">
276
277
278
279 Architecture
280
281 </a>
282 </li>
283
284
285
286
287 </ul>
288 </div>
289 </nav>
290
291
292
293 <main class="md-main" data-md-component="main">
294 <div class="md-main__inner md-grid">
295
296
297
298 <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
299 <div class="md-sidebar__scrollwrap">
300 <div class="md-sidebar__inner">
301
302
303
304
305
306
307 <nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
308 <label class="md-nav__title" for="__drawer">
309 <a href="../.." title="Fossilrepo" class="md-nav__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
310 <div style="display: flex; align-items: center; gap: 0.6rem;">
311 <img src="../../assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
312 <img src="../../assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
313 </div>
314 </a>
315 Fossilrepo
316 </label>
317
318 <div class="md-nav__source">
319 <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
320 <div class="md-source__icon md-icon">
321
322 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
323 </div>
324 <div class="md-source__repository">
325 ConflictHQ/fossilrepo
326 </div>
327 </a>
328 </div>
329
330 <ul class="md-nav__list" data-md-scrollfix>
331
332
333
334
335
336
337
338 <li class="md-nav__item">
339 <a href="../.." class="md-nav__link">
340
341
342
343 <span class="md-ellipsis">
344
345
346 Home
347
348
349
350 </span>
351
352
353
354 </a>
355 </li>
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375 <li class="md-nav__item md-nav__item--nested">
376
377
378
379
380
381 <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
382
383
384 <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
385
386
387
388 <span class="md-ellipsis">
389
390
391 Getting Started
392
393
394
395 </span>
396
397
398
399 <span class="md-nav__icon md-icon"></span>
400 </label>
401
402 <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
403 <label class="md-nav__title" for="__nav_2">
404 <span class="md-nav__icon md-icon"></span>
405
406
407 Getting Started
408
409
410 </label>
411 <ul class="md-nav__list" data-md-scrollfix>
412
413
414
415
416
417
418
419 <li class="md-nav__item">
420 <a href="../../getting-started/prerequisites/" class="md-nav__link">
421
422
423
424 <span class="md-ellipsis">
425
426
427 Prerequisites
428
429
430
431 </span>
432
433
434
435 </a>
436 </li>
437
438
439
440
441
442
443
444
445
446
447 <li class="md-nav__item">
448 <a href="../../getting-started/installation/" class="md-nav__link">
449
450
451
452 <span class="md-ellipsis">
453
454
455 Installation
456
457
458
459 </span>
460
461
462
463 </a>
464 </li>
465
466
467
468
469
470
471
472
473
474
475 <li class="md-nav__item">
476 <a href="../../getting-started/configuration/" class="md-nav__link">
477
478
479
480 <span class="md-ellipsis">
481
482
483 Configuration
484
485
486
487 </span>
488
489
490
491 </a>
492 </li>
493
494
495
496
497
498
499
500
501
502
503 <li class="md-nav__item">
504 <a href="../../getting-started/first-repo/" class="md-nav__link">
505
506
507
508 <span class="md-ellipsis">
509
510
511 First Repository
512
513
514
515 </span>
516
517
518
519 </a>
520 </li>
521
522
523
524
525 </ul>
526 </nav>
527
528 </li>
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553 <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
554
555
556
557 <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
558
559
560 <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
561
562
563
564 <span class="md-ellipsis">
565
566
567 Architecture
568
569
570
571 </span>
572
573
574
575 <span class="md-nav__icon md-icon"></span>
576 </label>
577
578 <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
579 <label class="md-nav__title" for="__nav_3">
580 <span class="md-nav__icon md-icon"></span>
581
582
583 Architecture
584
585
586 </label>
587 <ul class="md-nav__list" data-md-scrollfix>
588
589
590
591
592
593
594
595
596
597 <li class="md-nav__item md-nav__item--active">
598
599 <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
600
601
602
603
604
605 <label class="md-nav__link md-nav__link--active" for="__toc">
606
607
608
609 <span class="md-ellipsis">
610
611
612 Overview
613
614
615
616 </span>
617
618
619
620 <span class="md-nav__icon md-icon"></span>
621 </label>
622
623 <a href="./" class="md-nav__link md-nav__link--active">
624
625
626
627 <span class="md-ellipsis">
628
629
630 Overview
631
632
633
634 </span>
635
636
637
638 </a>
639
640
641
642 <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
643
644
645
646
647
648
649 <label class="md-nav__title" for="__toc">
650 <span class="md-nav__icon md-icon"></span>
651 Table of contents
652 </label>
653 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
654
655 <li class="md-nav__item">
656 <a href="#system-diagram" class="md-nav__link">
657 <span class="md-ellipsis">
658
659 System Diagram
660
661 </span>
662 </a>
663
664 </li>
665
666 <li class="md-nav__item">
667 <a href="#components" class="md-nav__link">
668 <span class="md-ellipsis">
669
670 Components
671
672 </span>
673 </a>
674
675 <nav class="md-nav" aria-label="Components">
676 <ul class="md-nav__list">
677
678 <li class="md-nav__item">
679 <a href="#fossil-server" class="md-nav__link">
680 <span class="md-ellipsis">
681
682 Fossil Server
683
684 </span>
685 </a>
686
687 </li>
688
689 <li class="md-nav__item">
690 <a href="#caddy" class="md-nav__link">
691 <span class="md-ellipsis">
692
693 Caddy
694
695 </span>
696 </a>
697
698 </li>
699
700 <li class="md-nav__item">
701 <a href="#django-management-layer" class="md-nav__link">
702 <span class="md-ellipsis">
703
704 Django Management Layer
705
706 </span>
707 </a>
708
709 </li>
710
711 <li class="md-nav__item">
712 <a href="#litestream" class="md-nav__link">
713 <span class="md-ellipsis">
714
715 Litestream
716
717 </span>
718 </a>
719
720 </li>
721
722 <li class="md-nav__item">
723 <a href="#celery-workers" class="md-nav__link">
724 <span class="md-ellipsis">
725
726 Celery Workers
727
728 </span>
729 </a>
730
731 </li>
732
733 </ul>
734 </nav>
735
736 </li>
737
738 <li class="md-nav__item">
739 <a href="#data-flow" class="md-nav__link">
740 <span class="md-ellipsis">
741
742 Data Flow
743
744 </span>
745 </a>
746
747 </li>
748
749 </ul>
750
751 </nav>
752
753 </li>
754
755
756
757
758
759
760
761
762
763
764 <li class="md-nav__item">
765 <a href="../sync-bridge/" class="md-nav__link">
766
767
768
769 <span class="md-ellipsis">
770
771
772 Sync Bridge
773
774
775
776 </span>
777
778
779
780 </a>
781 </li>
782
783
784
785
786 </ul>
787 </nav>
788
789 </li>
790
791
792
793 </ul>
794 </nav>
795 </div>
796 </div>
797 </div>
798
799
800
801 <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
802 <div class="md-sidebar__scrollwrap">
803 <div class="md-sidebar__inner">
804
805
806 <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
807
808
809
810
811
812
813 <label class="md-nav__title" for="__toc">
814 <span class="md-nav__icon md-icon"></span>
815 Table of contents
816 </label>
817 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
818
819 <li class="md-nav__item">
820 <a href="#system-diagram" class="md-nav__link">
821 <span class="md-ellipsis">
822
823 System Diagram
824
825 </span>
826 </a>
827
828 </li>
829
830 <li class="md-nav__item">
831 <a href="#components" class="md-nav__link">
832 <span class="md-ellipsis">
833
834 Components
835
836 </span>
837 </a>
838
839 <nav class="md-nav" aria-label="Components">
840 <ul class="md-nav__list">
841
842 <li class="md-nav__item">
843 <a href="#fossil-server" class="md-nav__link">
844 <span class="md-ellipsis">
845
846 Fossil Server
847
848 </span>
849 </a>
850
851 </li>
852
853 <li class="md-nav__item">
854 <a href="#caddy" class="md-nav__link">
855 <span class="md-ellipsis">
856
857 Caddy
858
859 </span>
860 </a>
861
862 </li>
863
864 <li class="md-nav__item">
865 <a href="#django-management-layer" class="md-nav__link">
866 <span class="md-ellipsis">
867
868 Django Management Layer
869
870 </span>
871 </a>
872
873 </li>
874
875 <li class="md-nav__item">
876 <a href="#litestream" class="md-nav__link">
877 <span class="md-ellipsis">
878
879 Litestream
880
881 </span>
882 </a>
883
884 </li>
885
886 <li class="md-nav__item">
887 <a href="#celery-workers" class="md-nav__link">
888 <span class="md-ellipsis">
889
890 Celery Workers
891
892 </span>
893 </a>
894
895 </li>
896
897 </ul>
898 </nav>
899
900 </li>
901
902 <li class="md-nav__item">
903 <a href="#data-flow" class="md-nav__link">
904 <span class="md-ellipsis">
905
906 Data Flow
907
908 </span>
909 </a>
910
911 </li>
912
913 </ul>
914
915 </nav>
916 </div>
917 </div>
918 </div>
919
920
921
922 <div class="md-content" data-md-component="content">
923
924 <article class="md-content__inner md-typeset">
925
926
927
928
929
930
931
932
933 <h1 id="architecture-overview">Architecture Overview<a class="headerlink" href="#architecture-overview" title="Permanent link">&para;</a></h1>
934 <p>Fossilrepo is a thin orchestration layer around Fossil SCM. Fossil does the heavy lifting -- fossilrepo handles provisioning, routing, backups, and the management UI.</p>
935 <h2 id="system-diagram">System Diagram<a class="headerlink" href="#system-diagram" title="Permanent link">&para;</a></h2>
936 <pre class="mermaid"><code>graph TB
937 subgraph Internet
938 User[User / Browser]
939 end
940
941 subgraph Fossilrepo Server
942 Caddy[Caddy&lt;br/&gt;SSL + Routing]
943 Django[Django&lt;br/&gt;Management UI]
944 Fossil[Fossil Server&lt;br/&gt;--repolist]
945 Celery[Celery Workers]
946 Redis[Redis]
947 Postgres[(PostgreSQL)]
948 Litestream[Litestream]
949 end
950
951 subgraph Storage
952 Repos["/data/repos/&lt;br/&gt;*.fossil files"]
953 S3[(S3 / MinIO)]
954 end
955
956 subgraph Mirrors
957 GitHub[GitHub]
958 GitLab[GitLab]
959 end
960
961 User --&gt; Caddy
962 Caddy --&gt;|"app.domain.com"| Django
963 Caddy --&gt;|"repo.domain.com"| Fossil
964 Django --&gt; Postgres
965 Django --&gt; Redis
966 Celery --&gt; Redis
967 Celery --&gt;|sync bridge| GitHub
968 Celery --&gt;|sync bridge| GitLab
969 Fossil --&gt; Repos
970 Litestream --&gt; Repos
971 Litestream --&gt; S3</code></pre>
972 <h2 id="components">Components<a class="headerlink" href="#components" title="Permanent link">&para;</a></h2>
973 <h3 id="fossil-server">Fossil Server<a class="headerlink" href="#fossil-server" title="Permanent link">&para;</a></h3>
974 <p>A single <code>fossil server --repolist /data/repos/</code> process serves all repositories. Each <code>.fossil</code> file is a self-contained SQLite database with VCS history, issues, wiki, and forum.</p>
975 <p>Adding a new repo is just <code>fossil init /data/repos/name.fossil</code> -- no restart needed.</p>
976 <h3 id="caddy">Caddy<a class="headerlink" href="#caddy" title="Permanent link">&para;</a></h3>
977 <p>Handles SSL termination and subdomain routing:</p>
978 <ul>
979 <li><code>your-domain.com</code> routes to the Django management UI</li>
980 <li><code>reponame.your-domain.com</code> routes directly to Fossil's web UI</li>
981 </ul>
982 <p>Caddy automatically provisions and renews Let's Encrypt certificates.</p>
983 <h3 id="django-management-layer">Django Management Layer<a class="headerlink" href="#django-management-layer" title="Permanent link">&para;</a></h3>
984 <p>Provides the administrative interface:</p>
985 <ul>
986 <li>Repository lifecycle (create, configure, archive)</li>
987 <li>User and organization management</li>
988 <li>Dashboard and analytics</li>
989 <li>Sync bridge configuration</li>
990 </ul>
991 <p>Django uses HTMX for interactive UI without a JavaScript framework.</p>
992 <h3 id="litestream">Litestream<a class="headerlink" href="#litestream" title="Permanent link">&para;</a></h3>
993 <p>Continuously replicates every <code>.fossil</code> SQLite file to S3-compatible storage. Provides:</p>
994 <ul>
995 <li><strong>Continuous backup</strong> -- WAL frames replicated in near-real-time</li>
996 <li><strong>Point-in-time recovery</strong> -- restore to any moment, not just snapshots</li>
997 <li><strong>Zero-config per repo</strong> -- new <code>.fossil</code> files are picked up automatically</li>
998 </ul>
999 <h3 id="celery-workers">Celery Workers<a class="headerlink" href="#celery-workers" title="Permanent link">&para;</a></h3>
1000 <p>Handle background tasks:</p>
1001 <ul>
1002 <li>Sync bridge execution (Fossil to Git mirroring)</li>
1003 <li>Scheduled sync jobs</li>
1004 <li>Upstream pull operations</li>
1005 </ul>
1006 <h2 id="data-flow">Data Flow<a class="headerlink" href="#data-flow" title="Permanent link">&para;</a></h2>
1007 <ol>
1008 <li><strong>User pushes to Fossil</strong> -- standard <code>fossil push</code> or <code>fossil sync</code></li>
1009 <li><strong>Fossil writes to <code>.fossil</code> file</strong> -- SQLite transactions</li>
1010 <li><strong>Litestream replicates</strong> -- WAL frames streamed to S3</li>
1011 <li><strong>Sync bridge runs</strong> -- Celery task mirrors changes to Git remotes</li>
1012 <li><strong>Django reflects state</strong> -- reads from Fossil SQLite for dashboards</li>
1013 </ol>
1014 <p>Fossil is always the source of truth. Everything else is derived.</p>
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028 </article>
1029 </div>
1030
1031
1032 <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
1033
1034 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
1035 </div>
1036
1037 <button type="button" class="md-top md-icon" data-md-component="top" hidden>
1038
1039 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
1040 Back to top
1041 </button>
1042
1043 </main>
1044
1045 <footer class="md-footer">
1046
1047 <div class="md-footer-meta md-typeset">
1048 <div class="md-footer-meta__inner md-grid">
1049 <div class="md-copyright">
1050
1051 <div class="md-copyright__highlight">
1052 Copyright &copy; 2026 CONFLICT LLC
1053 </div>
1054
1055
1056 Made with
1057 <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
1058 Material for MkDocs
1059 </a>
1060
1061 </div>
1062
1063
1064 <div class="md-social">
1065
1066
1067
1068
1069
1070
1071
1072
1073 <a href="https://github.com/ConflictHQ/fossilrepo" target="_blank" rel="noopener" title="github.com" class="md-social__link">
1074 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
1075 </a>
1076
1077 </div>
1078
1079 </div>
1080 </div>
1081 </footer>
1082
1083 </div>
1084 <div class="md-dialog" data-md-component="dialog">
1085 <div class="md-dialog__inner md-typeset"></div>
1086 </div>
1087
1088
1089
1090
1091
1092 <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.instant", "navigation.tabs", "navigation.sections", "navigation.expand", "navigation.top", "search.suggest", "search.highlight", "content.code.copy", "content.tabs.link", "header.autohide"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
1093
1094
1095 <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
1096
1097
1098 </body>
1099 </html>
A site/architecture/sync-bridge/index.html
+1077
--- a/site/architecture/sync-bridge/index.html
+++ b/site/architecture/sync-bridge/index.html
@@ -0,0 +1,1077 @@
1
+
2
+<!doctype html>
3
+<html lang="en" class="no-js">
4
+ <head>
5
+
6
+ <meta charset="utf-8">
7
+ <meta name="viewport" content="width=device-width,initial-scale=1">
8
+
9
+ <meta name="description" content="Self-hosted Fossil forge -- omnibus installer for production Fossil SCM hosting">
10
+
11
+
12
+ <meta name="author" content="CONFLICT LLC">
13
+
14
+
15
+ <link rel="canonical" href="https://fossilrepo.dev/architecture/sync-bridge/">
16
+
17
+
18
+ <link rel="prev" href="../overview/">
19
+
20
+
21
+
22
+
23
+
24
+
25
+ <link rel="icon" href="../../assets/images/favicon.png">
26
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
27
+
28
+
29
+
30
+ <title>Sync Bridge - Fossilrepo</title>
31
+
32
+
33
+
34
+ <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
35
+
36
+
37
+ <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
38
+
39
+
40
+
41
+
42
+
43
+
44
+
45
+
46
+
47
+
48
+
49
+
50
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
51
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
52
+ <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
53
+
54
+
55
+
56
+ <link rel="stylesheet" href="../../assets/css/custom.css">
57
+
58
+ <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
59
+
60
+
61
+
62
+
63
+
64
+ </head>
65
+
66
+
67
+
68
+
69
+
70
+
71
+
72
+
73
+
74
+ <body dir="ltr" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom">
75
+
76
+
77
+ <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
78
+ <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
79
+ <label class="md-overlay" for="__drawer"></label>
80
+ <div data-md-component="skip">
81
+
82
+
83
+ <a href="#sync-bridge" class="md-skip">
84
+ Skip to content
85
+ </a>
86
+
87
+ </div>
88
+ <div data-md-component="announce">
89
+
90
+ </div>
91
+
92
+
93
+
94
+
95
+<header class="md-header" data-md-component="header">
96
+ <nav class="md-header__inner md-grid" aria-label="Header">
97
+ <a href="../.." title="Fossilrepo" class="md-header__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
98
+ <div style="display: flex; align-items: center; gap: 0.6rem;">
99
+ <img src="../../assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
100
+ <img src="../../assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
101
+</div>
102
+ </a>
103
+ <label class="md-header__button md-icon" for="__drawer">
104
+
105
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
106
+ </label>
107
+ <div class="md-header__title" data-md-component="header-title">
108
+ <div class="md-header__ellipsis">
109
+ <div class="md-header__topic">
110
+ <span class="md-ellipsis">
111
+ Fossilrepo
112
+ </span>
113
+ </div>
114
+ <div class="md-header__topic" data-md-component="header-topic">
115
+ <span class="md-ellipsis">
116
+
117
+ Sync Bridge
118
+
119
+ </span>
120
+ </div>
121
+ </div>
122
+ </div>
123
+
124
+
125
+ <form class="md-header__option" data-md-component="palette">
126
+
127
+
128
+
129
+
130
+ <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">
131
+
132
+ <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
133
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
134
+ </label>
135
+
136
+
137
+
138
+
139
+
140
+ <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
141
+
142
+ <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>
143
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
144
+ </label>
145
+
146
+
147
+</form>
148
+
149
+
150
+
151
+ <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
152
+
153
+
154
+
155
+
156
+
157
+ <label class="md-header__button md-icon" for="__search">
158
+
159
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
160
+ </label>
161
+ <div class="md-search" data-md-component="search" role="dialog">
162
+ <label class="md-search__overlay" for="__search"></label>
163
+ <div class="md-search__inner" role="search">
164
+ <form class="md-search__form" name="search">
165
+ <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
166
+ <label class="md-search__icon md-icon" for="__search">
167
+
168
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
169
+
170
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
171
+ </label>
172
+ <nav class="md-search__options" aria-label="Search">
173
+
174
+ <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
175
+
176
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
177
+ </button>
178
+ </nav>
179
+
180
+ <div class="md-search__suggest" data-md-component="search-suggest"></div>
181
+
182
+ </form>
183
+ <div class="md-search__output">
184
+ <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
185
+ <div class="md-search-result" data-md-component="search-result">
186
+ <div class="md-search-result__meta">
187
+ Initializing search
188
+ </div>
189
+ <ol class="md-search-result__list" role="presentation"></ol>
190
+ </div>
191
+ </div>
192
+ </div>
193
+ </div>
194
+</div>
195
+
196
+
197
+
198
+ <div class="md-header__source">
199
+ <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
200
+ <div class="md-source__icon md-icon">
201
+
202
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
203
+ </div>
204
+ <div class="md-source__repository">
205
+ ConflictHQ/fossilrepo
206
+ </div>
207
+</a>
208
+ </div>
209
+
210
+ </nav>
211
+
212
+</header>
213
+
214
+ <div class="md-container" data-md-component="container">
215
+
216
+
217
+
218
+
219
+
220
+<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
221
+ <div class="md-grid">
222
+ <ul class="md-tabs__list">
223
+
224
+
225
+
226
+
227
+
228
+
229
+ <li class="md-tabs__item">
230
+ <a href="../.." class="md-tabs__link">
231
+
232
+
233
+
234
+
235
+
236
+ Home
237
+
238
+ </a>
239
+ </li>
240
+
241
+
242
+
243
+
244
+
245
+
246
+
247
+
248
+
249
+
250
+ <li class="md-tabs__item">
251
+ <a href="../../getting-started/prerequisites/" class="md-tabs__link">
252
+
253
+
254
+
255
+ Getting Started
256
+
257
+ </a>
258
+ </li>
259
+
260
+
261
+
262
+
263
+
264
+
265
+
266
+
267
+
268
+
269
+
270
+
271
+
272
+ <li class="md-tabs__item md-tabs__item--active">
273
+ <a href="../overview/" class="md-tabs__link">
274
+
275
+
276
+
277
+ Architecture
278
+
279
+ </a>
280
+ </li>
281
+
282
+
283
+
284
+
285
+ </ul>
286
+ </div>
287
+</nav>
288
+
289
+
290
+
291
+ <main class="md-main" data-md-component="main">
292
+ <div class="md-main__inner md-grid">
293
+
294
+
295
+
296
+ <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
297
+ <div class="md-sidebar__scrollwrap">
298
+ <div class="md-sidebar__inner">
299
+
300
+
301
+
302
+
303
+
304
+
305
+<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
306
+ <label class="md-nav__title" for="__drawer">
307
+ <a href="../.." title="Fossilrepo" class="md-nav__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
308
+ <div style="display: flex; align-items: center; gap: 0.6rem;">
309
+ <img src="../../assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
310
+ <img src="../../assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
311
+</div>
312
+ </a>
313
+ Fossilrepo
314
+ </label>
315
+
316
+ <div class="md-nav__source">
317
+ <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
318
+ <div class="md-source__icon md-icon">
319
+
320
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
321
+ </div>
322
+ <div class="md-source__repository">
323
+ ConflictHQ/fossilrepo
324
+ </div>
325
+</a>
326
+ </div>
327
+
328
+ <ul class="md-nav__list" data-md-scrollfix>
329
+
330
+
331
+
332
+
333
+
334
+
335
+
336
+ <li class="md-nav__item">
337
+ <a href="../.." class="md-nav__link">
338
+
339
+
340
+
341
+ <span class="md-ellipsis">
342
+
343
+
344
+ Home
345
+
346
+
347
+
348
+ </span>
349
+
350
+
351
+
352
+ </a>
353
+ </li>
354
+
355
+
356
+
357
+
358
+
359
+
360
+
361
+
362
+
363
+
364
+
365
+
366
+
367
+
368
+
369
+
370
+
371
+
372
+
373
+ <li class="md-nav__item md-nav__item--nested">
374
+
375
+
376
+
377
+
378
+
379
+ <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
380
+
381
+
382
+ <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
383
+
384
+
385
+
386
+ <span class="md-ellipsis">
387
+
388
+
389
+ Getting Started
390
+
391
+
392
+
393
+ </span>
394
+
395
+
396
+
397
+ <span class="md-nav__icon md-icon"></span>
398
+ </label>
399
+
400
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
401
+ <label class="md-nav__title" for="__nav_2">
402
+ <span class="md-nav__icon md-icon"></span>
403
+
404
+
405
+ Getting Started
406
+
407
+
408
+ </label>
409
+ <ul class="md-nav__list" data-md-scrollfix>
410
+
411
+
412
+
413
+
414
+
415
+
416
+
417
+ <li class="md-nav__item">
418
+ <a href="../../getting-started/prerequisites/" class="md-nav__link">
419
+
420
+
421
+
422
+ <span class="md-ellipsis">
423
+
424
+
425
+ Prerequisites
426
+
427
+
428
+
429
+ </span>
430
+
431
+
432
+
433
+ </a>
434
+ </li>
435
+
436
+
437
+
438
+
439
+
440
+
441
+
442
+
443
+
444
+
445
+ <li class="md-nav__item">
446
+ <a href="../../getting-started/installation/" class="md-nav__link">
447
+
448
+
449
+
450
+ <span class="md-ellipsis">
451
+
452
+
453
+ Installation
454
+
455
+
456
+
457
+ </span>
458
+
459
+
460
+
461
+ </a>
462
+ </li>
463
+
464
+
465
+
466
+
467
+
468
+
469
+
470
+
471
+
472
+
473
+ <li class="md-nav__item">
474
+ <a href="../../getting-started/configuration/" class="md-nav__link">
475
+
476
+
477
+
478
+ <span class="md-ellipsis">
479
+
480
+
481
+ Configuration
482
+
483
+
484
+
485
+ </span>
486
+
487
+
488
+
489
+ </a>
490
+ </li>
491
+
492
+
493
+
494
+
495
+
496
+
497
+
498
+
499
+
500
+
501
+ <li class="md-nav__item">
502
+ <a href="../../getting-started/first-repo/" class="md-nav__link">
503
+
504
+
505
+
506
+ <span class="md-ellipsis">
507
+
508
+
509
+ First Repository
510
+
511
+
512
+
513
+ </span>
514
+
515
+
516
+
517
+ </a>
518
+ </li>
519
+
520
+
521
+
522
+
523
+ </ul>
524
+ </nav>
525
+
526
+ </li>
527
+
528
+
529
+
530
+
531
+
532
+
533
+
534
+
535
+
536
+
537
+
538
+
539
+
540
+
541
+
542
+
543
+
544
+
545
+
546
+
547
+
548
+
549
+
550
+
551
+ <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
552
+
553
+
554
+
555
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
556
+
557
+
558
+ <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
559
+
560
+
561
+
562
+ <span class="md-ellipsis">
563
+
564
+
565
+ Architecture
566
+
567
+
568
+
569
+ </span>
570
+
571
+
572
+
573
+ <span class="md-nav__icon md-icon"></span>
574
+ </label>
575
+
576
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
577
+ <label class="md-nav__title" for="__nav_3">
578
+ <span class="md-nav__icon md-icon"></span>
579
+
580
+
581
+ Architecture
582
+
583
+
584
+ </label>
585
+ <ul class="md-nav__list" data-md-scrollfix>
586
+
587
+
588
+
589
+
590
+
591
+
592
+
593
+ <li class="md-nav__item">
594
+ <a href="../overview/" class="md-nav__link">
595
+
596
+
597
+
598
+ <span class="md-ellipsis">
599
+
600
+
601
+ Overview
602
+
603
+
604
+
605
+ </span>
606
+
607
+
608
+
609
+ </a>
610
+ </li>
611
+
612
+
613
+
614
+
615
+
616
+
617
+
618
+
619
+
620
+
621
+
622
+
623
+ <li class="md-nav__item md-nav__item--active">
624
+
625
+ <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
626
+
627
+
628
+
629
+
630
+
631
+ <label class="md-nav__link md-nav__link--active" for="__toc">
632
+
633
+
634
+
635
+ <span class="md-ellipsis">
636
+
637
+
638
+ Sync Bridge
639
+
640
+
641
+
642
+ </span>
643
+
644
+
645
+
646
+ <span class="md-nav__icon md-icon"></span>
647
+ </label>
648
+
649
+ <a href="./" class="md-nav__link md-nav__link--active">
650
+
651
+
652
+
653
+ <span class="md-ellipsis">
654
+
655
+
656
+ Sync Bridge
657
+
658
+
659
+
660
+ </span>
661
+
662
+
663
+
664
+ </a>
665
+
666
+
667
+
668
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
669
+
670
+
671
+
672
+
673
+
674
+
675
+ <label class="md-nav__title" for="__toc">
676
+ <span class="md-nav__icon md-icon"></span>
677
+ Table of contents
678
+ </label>
679
+ <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
680
+
681
+ <li class="md-nav__item">
682
+ <a href="#how-it-works" class="md-nav__link">
683
+ <span class="md-ellipsis">
684
+
685
+ How It Works
686
+
687
+ </span>
688
+ </a>
689
+
690
+</li>
691
+
692
+ <li class="md-nav__item">
693
+ <a href="#what-gets-synced" class="md-nav__link">
694
+ <span class="md-ellipsis">
695
+
696
+ What Gets Synced
697
+
698
+ </span>
699
+ </a>
700
+
701
+</li>
702
+
703
+ <li class="md-nav__item">
704
+ <a href="#configuration" class="md-nav__link">
705
+ <span class="md-ellipsis">
706
+
707
+ Configuration
708
+
709
+ </span>
710
+ </a>
711
+
712
+</li>
713
+
714
+ <li class="md-nav__item">
715
+ <a href="#sync-modes" class="md-nav__link">
716
+ <span class="md-ellipsis">
717
+
718
+ Sync Modes
719
+
720
+ </span>
721
+ </a>
722
+
723
+ <nav class="md-nav" aria-label="Sync Modes">
724
+ <ul class="md-nav__list">
725
+
726
+ <li class="md-nav__item">
727
+ <a href="#on-demand" class="md-nav__link">
728
+ <span class="md-ellipsis">
729
+
730
+ On-Demand
731
+
732
+ </span>
733
+ </a>
734
+
735
+</li>
736
+
737
+ <li class="md-nav__item">
738
+ <a href="#scheduled" class="md-nav__link">
739
+ <span class="md-ellipsis">
740
+
741
+ Scheduled
742
+
743
+ </span>
744
+ </a>
745
+
746
+</li>
747
+
748
+ <li class="md-nav__item">
749
+ <a href="#upstream-pull" class="md-nav__link">
750
+ <span class="md-ellipsis">
751
+
752
+ Upstream Pull
753
+
754
+ </span>
755
+ </a>
756
+
757
+</li>
758
+
759
+ </ul>
760
+ </nav>
761
+
762
+</li>
763
+
764
+ </ul>
765
+
766
+</nav>
767
+
768
+ </li>
769
+
770
+
771
+
772
+
773
+ </ul>
774
+ </nav>
775
+
776
+ </li>
777
+
778
+
779
+
780
+ </ul>
781
+</nav>
782
+ </div>
783
+ </div>
784
+ </div>
785
+
786
+
787
+
788
+ <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
789
+ <div class="md-sidebar__scrollwrap">
790
+ <div class="md-sidebar__inner">
791
+
792
+
793
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
794
+
795
+
796
+
797
+
798
+
799
+
800
+ <label class="md-nav__title" for="__toc">
801
+ <span class="md-nav__icon md-icon"></span>
802
+ Table of contents
803
+ </label>
804
+ <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
805
+
806
+ <li class="md-nav__item">
807
+ <a href="#how-it-works" class="md-nav__link">
808
+ <span class="md-ellipsis">
809
+
810
+ How It Works
811
+
812
+ </span>
813
+ </a>
814
+
815
+</li>
816
+
817
+ <li class="md-nav__item">
818
+ <a href="#what-gets-synced" class="md-nav__link">
819
+ <span class="md-ellipsis">
820
+
821
+ What Gets Synced
822
+
823
+ </span>
824
+ </a>
825
+
826
+</li>
827
+
828
+ <li class="md-nav__item">
829
+ <a href="#configuration" class="md-nav__link">
830
+ <span class="md-ellipsis">
831
+
832
+ Configuration
833
+
834
+ </span>
835
+ </a>
836
+
837
+</li>
838
+
839
+ <li class="md-nav__item">
840
+ <a href="#sync-modes" class="md-nav__link">
841
+ <span class="md-ellipsis">
842
+
843
+ Sync Modes
844
+
845
+ </span>
846
+ </a>
847
+
848
+ <nav class="md-nav" aria-label="Sync Modes">
849
+ <ul class="md-nav__list">
850
+
851
+ <li class="md-nav__item">
852
+ <a href="#on-demand" class="md-nav__link">
853
+ <span class="md-ellipsis">
854
+
855
+ On-Demand
856
+
857
+ </span>
858
+ </a>
859
+
860
+</li>
861
+
862
+ <li class="md-nav__item">
863
+ <a href="#scheduled" class="md-nav__link">
864
+ <span class="md-ellipsis">
865
+
866
+ Scheduled
867
+
868
+ </span>
869
+ </a>
870
+
871
+</li>
872
+
873
+ <li class="md-nav__item">
874
+ <a href="#upstream-pull" class="md-nav__link">
875
+ <span class="md-ellipsis">
876
+
877
+ Upstream Pull
878
+
879
+ </span>
880
+ </a>
881
+
882
+</li>
883
+
884
+ </ul>
885
+ </nav>
886
+
887
+</li>
888
+
889
+ </ul>
890
+
891
+</nav>
892
+ </div>
893
+ </div>
894
+ </div>
895
+
896
+
897
+
898
+ <div class="md-content" data-md-component="content">
899
+
900
+ <article class="md-content__inner md-typeset">
901
+
902
+
903
+
904
+
905
+
906
+
907
+
908
+
909
+<h1 id="sync-bridge">Sync Bridge<a class="headerlink" href="#sync-bridge" title="Permanent link">&para;</a></h1>
910
+<p>The sync bridge mirrors Fossil repositories to GitHub and GitLab as downstream read-only copies.</p>
911
+<h2 id="how-it-works">How It Works<a class="headerlink" href="#how-it-works" title="Permanent link">&para;</a></h2>
912
+<pre class="mermaid"><code>flowchart LR
913
+ Fossil["Fossil Repo&lt;br/&gt;(source of truth)"] --&gt; Bridge["Sync Bridge&lt;br/&gt;(Celery task)"]
914
+ Bridge --&gt; Git["Git Export"]
915
+ Git --&gt; GitHub["GitHub Mirror"]
916
+ Git --&gt; GitLab["GitLab Mirror"]</code></pre>
917
+<p>The bridge:</p>
918
+<ol>
919
+<li>Exports Fossil commits as Git commits</li>
920
+<li>Pushes to configured Git remotes</li>
921
+<li>Optionally syncs tickets to GitHub/GitLab Issues</li>
922
+<li>Optionally syncs wiki pages to repo docs</li>
923
+</ol>
924
+<h2 id="what-gets-synced">What Gets Synced<a class="headerlink" href="#what-gets-synced" title="Permanent link">&para;</a></h2>
925
+<table>
926
+<thead>
927
+<tr>
928
+<th>Fossil Artifact</th>
929
+<th>Git Target</th>
930
+<th>Configurable</th>
931
+</tr>
932
+</thead>
933
+<tbody>
934
+<tr>
935
+<td>Commits</td>
936
+<td>Git commits</td>
937
+<td>Always</td>
938
+</tr>
939
+<tr>
940
+<td>Tags</td>
941
+<td>Git tags</td>
942
+<td>Always</td>
943
+</tr>
944
+<tr>
945
+<td>Branches</td>
946
+<td>Git branches</td>
947
+<td>Always</td>
948
+</tr>
949
+<tr>
950
+<td>Tickets</td>
951
+<td>GitHub/GitLab Issues</td>
952
+<td>Optional</td>
953
+</tr>
954
+<tr>
955
+<td>Wiki</td>
956
+<td>Repository docs</td>
957
+<td>Optional</td>
958
+</tr>
959
+</tbody>
960
+</table>
961
+<h2 id="configuration">Configuration<a class="headerlink" href="#configuration" title="Permanent link">&para;</a></h2>
962
+<p>Set up mirroring through the Django management UI or environment variables:</p>
963
+<div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="c1"># GitHub mirror</span>
964
+<a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nv">GITHUB_TOKEN</span><span class="o">=</span>ghp_xxxxxxxxxxxx
965
+<a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>
966
+<a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="c1"># GitLab mirror</span>
967
+<a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="nv">GITLAB_TOKEN</span><span class="o">=</span>glpat-xxxxxxxxxxxx
968
+</code></pre></div>
969
+<p>Per-repository mirror configuration is managed in the dashboard under <strong>Repository Settings &gt; Sync</strong>.</p>
970
+<h2 id="sync-modes">Sync Modes<a class="headerlink" href="#sync-modes" title="Permanent link">&para;</a></h2>
971
+<h3 id="on-demand">On-Demand<a class="headerlink" href="#on-demand" title="Permanent link">&para;</a></h3>
972
+<p>Trigger a sync manually from the dashboard or CLI:</p>
973
+<div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>docker<span class="w"> </span>compose<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>django<span class="w"> </span>python<span class="w"> </span>manage.py<span class="w"> </span>fossil_sync<span class="w"> </span>my-project
974
+</code></pre></div>
975
+<h3 id="scheduled">Scheduled<a class="headerlink" href="#scheduled" title="Permanent link">&para;</a></h3>
976
+<p>Configure a Celery Beat schedule to sync at regular intervals:</p>
977
+<div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="c1"># Runs every 15 minutes</span>
978
+<a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="n">CELERY_BEAT_SCHEDULE</span> <span class="o">=</span> <span class="p">{</span>
979
+<a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a> <span class="s1">&#39;sync-all-repos&#39;</span><span class="p">:</span> <span class="p">{</span>
980
+<a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a> <span class="s1">&#39;task&#39;</span><span class="p">:</span> <span class="s1">&#39;fossil.tasks.sync_all&#39;</span><span class="p">,</span>
981
+<a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a> <span class="s1">&#39;schedule&#39;</span><span class="p">:</span> <span class="mf">900.0</span><span class="p">,</span>
982
+<a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a> <span class="p">},</span>
983
+<a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="p">}</span>
984
+</code></pre></div>
985
+<h3 id="upstream-pull">Upstream Pull<a class="headerlink" href="#upstream-pull" title="Permanent link">&para;</a></h3>
986
+<p>Pull updates from a remote Fossil server into your local instance:</p>
987
+<div class="highlight"><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>docker<span class="w"> </span>compose<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>django<span class="w"> </span>python<span class="w"> </span>manage.py<span class="w"> </span>fossil_pull<span class="w"> </span>my-project
988
+</code></pre></div>
989
+<div class="admonition warning">
990
+<p class="admonition-title">Direction matters</p>
991
+<p>The sync bridge is <strong>one-way</strong>: Fossil to Git. Changes pushed directly to a Git mirror will be overwritten on the next sync. Always push to the Fossil repo.</p>
992
+</div>
993
+
994
+
995
+
996
+
997
+
998
+
999
+
1000
+
1001
+
1002
+
1003
+
1004
+
1005
+
1006
+ </article>
1007
+ </div>
1008
+
1009
+
1010
+ <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
1011
+
1012
+<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
1013
+ </div>
1014
+
1015
+ <button type="button" class="md-top md-icon" data-md-component="top" hidden>
1016
+
1017
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
1018
+ Back to top
1019
+</button>
1020
+
1021
+ </main>
1022
+
1023
+ <footer class="md-footer">
1024
+
1025
+ <div class="md-footer-meta md-typeset">
1026
+ <div class="md-footer-meta__inner md-grid">
1027
+ <div class="md-copyright">
1028
+
1029
+ <div class="md-copyright__highlight">
1030
+ Copyright &copy; 2026 CONFLICT LLC
1031
+ </div>
1032
+
1033
+
1034
+ Made with
1035
+ <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
1036
+ Material for MkDocs
1037
+ </a>
1038
+
1039
+</div>
1040
+
1041
+
1042
+<div class="md-social">
1043
+
1044
+
1045
+
1046
+
1047
+
1048
+
1049
+
1050
+
1051
+ <a href="https://github.com/ConflictHQ/fossilrepo" target="_blank" rel="noopener" title="github.com" class="md-social__link">
1052
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
1053
+ </a>
1054
+
1055
+</div>
1056
+
1057
+ </div>
1058
+ </div>
1059
+</footer>
1060
+
1061
+ </div>
1062
+ <div class="md-dialog" data-md-component="dialog">
1063
+ <div class="md-dialog__inner md-typeset"></div>
1064
+ </div>
1065
+
1066
+
1067
+
1068
+
1069
+
1070
+ <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.instant", "navigation.tabs", "navigation.sections", "navigation.expand", "navigation.top", "search.suggest", "search.highlight", "content.code.copy", "content.tabs.link", "header.autohide"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
1071
+
1072
+
1073
+ <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
1074
+
1075
+
1076
+ </body>
1077
+</html>
--- a/site/architecture/sync-bridge/index.html
+++ b/site/architecture/sync-bridge/index.html
@@ -0,0 +1,1077 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
--- a/site/architecture/sync-bridge/index.html
+++ b/site/architecture/sync-bridge/index.html
@@ -0,0 +1,1077 @@
1
2 <!doctype html>
3 <html lang="en" class="no-js">
4 <head>
5
6 <meta charset="utf-8">
7 <meta name="viewport" content="width=device-width,initial-scale=1">
8
9 <meta name="description" content="Self-hosted Fossil forge -- omnibus installer for production Fossil SCM hosting">
10
11
12 <meta name="author" content="CONFLICT LLC">
13
14
15 <link rel="canonical" href="https://fossilrepo.dev/architecture/sync-bridge/">
16
17
18 <link rel="prev" href="../overview/">
19
20
21
22
23
24
25 <link rel="icon" href="../../assets/images/favicon.png">
26 <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
27
28
29
30 <title>Sync Bridge - Fossilrepo</title>
31
32
33
34 <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
35
36
37 <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
38
39
40
41
42
43
44
45
46
47
48
49
50 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
51 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
52 <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
53
54
55
56 <link rel="stylesheet" href="../../assets/css/custom.css">
57
58 <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
59
60
61
62
63
64 </head>
65
66
67
68
69
70
71
72
73
74 <body dir="ltr" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom">
75
76
77 <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
78 <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
79 <label class="md-overlay" for="__drawer"></label>
80 <div data-md-component="skip">
81
82
83 <a href="#sync-bridge" class="md-skip">
84 Skip to content
85 </a>
86
87 </div>
88 <div data-md-component="announce">
89
90 </div>
91
92
93
94
95 <header class="md-header" data-md-component="header">
96 <nav class="md-header__inner md-grid" aria-label="Header">
97 <a href="../.." title="Fossilrepo" class="md-header__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
98 <div style="display: flex; align-items: center; gap: 0.6rem;">
99 <img src="../../assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
100 <img src="../../assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
101 </div>
102 </a>
103 <label class="md-header__button md-icon" for="__drawer">
104
105 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
106 </label>
107 <div class="md-header__title" data-md-component="header-title">
108 <div class="md-header__ellipsis">
109 <div class="md-header__topic">
110 <span class="md-ellipsis">
111 Fossilrepo
112 </span>
113 </div>
114 <div class="md-header__topic" data-md-component="header-topic">
115 <span class="md-ellipsis">
116
117 Sync Bridge
118
119 </span>
120 </div>
121 </div>
122 </div>
123
124
125 <form class="md-header__option" data-md-component="palette">
126
127
128
129
130 <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">
131
132 <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
133 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
134 </label>
135
136
137
138
139
140 <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
141
142 <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>
143 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
144 </label>
145
146
147 </form>
148
149
150
151 <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
152
153
154
155
156
157 <label class="md-header__button md-icon" for="__search">
158
159 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
160 </label>
161 <div class="md-search" data-md-component="search" role="dialog">
162 <label class="md-search__overlay" for="__search"></label>
163 <div class="md-search__inner" role="search">
164 <form class="md-search__form" name="search">
165 <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
166 <label class="md-search__icon md-icon" for="__search">
167
168 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
169
170 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
171 </label>
172 <nav class="md-search__options" aria-label="Search">
173
174 <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
175
176 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
177 </button>
178 </nav>
179
180 <div class="md-search__suggest" data-md-component="search-suggest"></div>
181
182 </form>
183 <div class="md-search__output">
184 <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
185 <div class="md-search-result" data-md-component="search-result">
186 <div class="md-search-result__meta">
187 Initializing search
188 </div>
189 <ol class="md-search-result__list" role="presentation"></ol>
190 </div>
191 </div>
192 </div>
193 </div>
194 </div>
195
196
197
198 <div class="md-header__source">
199 <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
200 <div class="md-source__icon md-icon">
201
202 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
203 </div>
204 <div class="md-source__repository">
205 ConflictHQ/fossilrepo
206 </div>
207 </a>
208 </div>
209
210 </nav>
211
212 </header>
213
214 <div class="md-container" data-md-component="container">
215
216
217
218
219
220 <nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
221 <div class="md-grid">
222 <ul class="md-tabs__list">
223
224
225
226
227
228
229 <li class="md-tabs__item">
230 <a href="../.." class="md-tabs__link">
231
232
233
234
235
236 Home
237
238 </a>
239 </li>
240
241
242
243
244
245
246
247
248
249
250 <li class="md-tabs__item">
251 <a href="../../getting-started/prerequisites/" class="md-tabs__link">
252
253
254
255 Getting Started
256
257 </a>
258 </li>
259
260
261
262
263
264
265
266
267
268
269
270
271
272 <li class="md-tabs__item md-tabs__item--active">
273 <a href="../overview/" class="md-tabs__link">
274
275
276
277 Architecture
278
279 </a>
280 </li>
281
282
283
284
285 </ul>
286 </div>
287 </nav>
288
289
290
291 <main class="md-main" data-md-component="main">
292 <div class="md-main__inner md-grid">
293
294
295
296 <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
297 <div class="md-sidebar__scrollwrap">
298 <div class="md-sidebar__inner">
299
300
301
302
303
304
305 <nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
306 <label class="md-nav__title" for="__drawer">
307 <a href="../.." title="Fossilrepo" class="md-nav__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
308 <div style="display: flex; align-items: center; gap: 0.6rem;">
309 <img src="../../assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
310 <img src="../../assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
311 </div>
312 </a>
313 Fossilrepo
314 </label>
315
316 <div class="md-nav__source">
317 <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
318 <div class="md-source__icon md-icon">
319
320 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
321 </div>
322 <div class="md-source__repository">
323 ConflictHQ/fossilrepo
324 </div>
325 </a>
326 </div>
327
328 <ul class="md-nav__list" data-md-scrollfix>
329
330
331
332
333
334
335
336 <li class="md-nav__item">
337 <a href="../.." class="md-nav__link">
338
339
340
341 <span class="md-ellipsis">
342
343
344 Home
345
346
347
348 </span>
349
350
351
352 </a>
353 </li>
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373 <li class="md-nav__item md-nav__item--nested">
374
375
376
377
378
379 <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
380
381
382 <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
383
384
385
386 <span class="md-ellipsis">
387
388
389 Getting Started
390
391
392
393 </span>
394
395
396
397 <span class="md-nav__icon md-icon"></span>
398 </label>
399
400 <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
401 <label class="md-nav__title" for="__nav_2">
402 <span class="md-nav__icon md-icon"></span>
403
404
405 Getting Started
406
407
408 </label>
409 <ul class="md-nav__list" data-md-scrollfix>
410
411
412
413
414
415
416
417 <li class="md-nav__item">
418 <a href="../../getting-started/prerequisites/" class="md-nav__link">
419
420
421
422 <span class="md-ellipsis">
423
424
425 Prerequisites
426
427
428
429 </span>
430
431
432
433 </a>
434 </li>
435
436
437
438
439
440
441
442
443
444
445 <li class="md-nav__item">
446 <a href="../../getting-started/installation/" class="md-nav__link">
447
448
449
450 <span class="md-ellipsis">
451
452
453 Installation
454
455
456
457 </span>
458
459
460
461 </a>
462 </li>
463
464
465
466
467
468
469
470
471
472
473 <li class="md-nav__item">
474 <a href="../../getting-started/configuration/" class="md-nav__link">
475
476
477
478 <span class="md-ellipsis">
479
480
481 Configuration
482
483
484
485 </span>
486
487
488
489 </a>
490 </li>
491
492
493
494
495
496
497
498
499
500
501 <li class="md-nav__item">
502 <a href="../../getting-started/first-repo/" class="md-nav__link">
503
504
505
506 <span class="md-ellipsis">
507
508
509 First Repository
510
511
512
513 </span>
514
515
516
517 </a>
518 </li>
519
520
521
522
523 </ul>
524 </nav>
525
526 </li>
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551 <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
552
553
554
555 <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
556
557
558 <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
559
560
561
562 <span class="md-ellipsis">
563
564
565 Architecture
566
567
568
569 </span>
570
571
572
573 <span class="md-nav__icon md-icon"></span>
574 </label>
575
576 <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
577 <label class="md-nav__title" for="__nav_3">
578 <span class="md-nav__icon md-icon"></span>
579
580
581 Architecture
582
583
584 </label>
585 <ul class="md-nav__list" data-md-scrollfix>
586
587
588
589
590
591
592
593 <li class="md-nav__item">
594 <a href="../overview/" class="md-nav__link">
595
596
597
598 <span class="md-ellipsis">
599
600
601 Overview
602
603
604
605 </span>
606
607
608
609 </a>
610 </li>
611
612
613
614
615
616
617
618
619
620
621
622
623 <li class="md-nav__item md-nav__item--active">
624
625 <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
626
627
628
629
630
631 <label class="md-nav__link md-nav__link--active" for="__toc">
632
633
634
635 <span class="md-ellipsis">
636
637
638 Sync Bridge
639
640
641
642 </span>
643
644
645
646 <span class="md-nav__icon md-icon"></span>
647 </label>
648
649 <a href="./" class="md-nav__link md-nav__link--active">
650
651
652
653 <span class="md-ellipsis">
654
655
656 Sync Bridge
657
658
659
660 </span>
661
662
663
664 </a>
665
666
667
668 <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
669
670
671
672
673
674
675 <label class="md-nav__title" for="__toc">
676 <span class="md-nav__icon md-icon"></span>
677 Table of contents
678 </label>
679 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
680
681 <li class="md-nav__item">
682 <a href="#how-it-works" class="md-nav__link">
683 <span class="md-ellipsis">
684
685 How It Works
686
687 </span>
688 </a>
689
690 </li>
691
692 <li class="md-nav__item">
693 <a href="#what-gets-synced" class="md-nav__link">
694 <span class="md-ellipsis">
695
696 What Gets Synced
697
698 </span>
699 </a>
700
701 </li>
702
703 <li class="md-nav__item">
704 <a href="#configuration" class="md-nav__link">
705 <span class="md-ellipsis">
706
707 Configuration
708
709 </span>
710 </a>
711
712 </li>
713
714 <li class="md-nav__item">
715 <a href="#sync-modes" class="md-nav__link">
716 <span class="md-ellipsis">
717
718 Sync Modes
719
720 </span>
721 </a>
722
723 <nav class="md-nav" aria-label="Sync Modes">
724 <ul class="md-nav__list">
725
726 <li class="md-nav__item">
727 <a href="#on-demand" class="md-nav__link">
728 <span class="md-ellipsis">
729
730 On-Demand
731
732 </span>
733 </a>
734
735 </li>
736
737 <li class="md-nav__item">
738 <a href="#scheduled" class="md-nav__link">
739 <span class="md-ellipsis">
740
741 Scheduled
742
743 </span>
744 </a>
745
746 </li>
747
748 <li class="md-nav__item">
749 <a href="#upstream-pull" class="md-nav__link">
750 <span class="md-ellipsis">
751
752 Upstream Pull
753
754 </span>
755 </a>
756
757 </li>
758
759 </ul>
760 </nav>
761
762 </li>
763
764 </ul>
765
766 </nav>
767
768 </li>
769
770
771
772
773 </ul>
774 </nav>
775
776 </li>
777
778
779
780 </ul>
781 </nav>
782 </div>
783 </div>
784 </div>
785
786
787
788 <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
789 <div class="md-sidebar__scrollwrap">
790 <div class="md-sidebar__inner">
791
792
793 <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
794
795
796
797
798
799
800 <label class="md-nav__title" for="__toc">
801 <span class="md-nav__icon md-icon"></span>
802 Table of contents
803 </label>
804 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
805
806 <li class="md-nav__item">
807 <a href="#how-it-works" class="md-nav__link">
808 <span class="md-ellipsis">
809
810 How It Works
811
812 </span>
813 </a>
814
815 </li>
816
817 <li class="md-nav__item">
818 <a href="#what-gets-synced" class="md-nav__link">
819 <span class="md-ellipsis">
820
821 What Gets Synced
822
823 </span>
824 </a>
825
826 </li>
827
828 <li class="md-nav__item">
829 <a href="#configuration" class="md-nav__link">
830 <span class="md-ellipsis">
831
832 Configuration
833
834 </span>
835 </a>
836
837 </li>
838
839 <li class="md-nav__item">
840 <a href="#sync-modes" class="md-nav__link">
841 <span class="md-ellipsis">
842
843 Sync Modes
844
845 </span>
846 </a>
847
848 <nav class="md-nav" aria-label="Sync Modes">
849 <ul class="md-nav__list">
850
851 <li class="md-nav__item">
852 <a href="#on-demand" class="md-nav__link">
853 <span class="md-ellipsis">
854
855 On-Demand
856
857 </span>
858 </a>
859
860 </li>
861
862 <li class="md-nav__item">
863 <a href="#scheduled" class="md-nav__link">
864 <span class="md-ellipsis">
865
866 Scheduled
867
868 </span>
869 </a>
870
871 </li>
872
873 <li class="md-nav__item">
874 <a href="#upstream-pull" class="md-nav__link">
875 <span class="md-ellipsis">
876
877 Upstream Pull
878
879 </span>
880 </a>
881
882 </li>
883
884 </ul>
885 </nav>
886
887 </li>
888
889 </ul>
890
891 </nav>
892 </div>
893 </div>
894 </div>
895
896
897
898 <div class="md-content" data-md-component="content">
899
900 <article class="md-content__inner md-typeset">
901
902
903
904
905
906
907
908
909 <h1 id="sync-bridge">Sync Bridge<a class="headerlink" href="#sync-bridge" title="Permanent link">&para;</a></h1>
910 <p>The sync bridge mirrors Fossil repositories to GitHub and GitLab as downstream read-only copies.</p>
911 <h2 id="how-it-works">How It Works<a class="headerlink" href="#how-it-works" title="Permanent link">&para;</a></h2>
912 <pre class="mermaid"><code>flowchart LR
913 Fossil["Fossil Repo&lt;br/&gt;(source of truth)"] --&gt; Bridge["Sync Bridge&lt;br/&gt;(Celery task)"]
914 Bridge --&gt; Git["Git Export"]
915 Git --&gt; GitHub["GitHub Mirror"]
916 Git --&gt; GitLab["GitLab Mirror"]</code></pre>
917 <p>The bridge:</p>
918 <ol>
919 <li>Exports Fossil commits as Git commits</li>
920 <li>Pushes to configured Git remotes</li>
921 <li>Optionally syncs tickets to GitHub/GitLab Issues</li>
922 <li>Optionally syncs wiki pages to repo docs</li>
923 </ol>
924 <h2 id="what-gets-synced">What Gets Synced<a class="headerlink" href="#what-gets-synced" title="Permanent link">&para;</a></h2>
925 <table>
926 <thead>
927 <tr>
928 <th>Fossil Artifact</th>
929 <th>Git Target</th>
930 <th>Configurable</th>
931 </tr>
932 </thead>
933 <tbody>
934 <tr>
935 <td>Commits</td>
936 <td>Git commits</td>
937 <td>Always</td>
938 </tr>
939 <tr>
940 <td>Tags</td>
941 <td>Git tags</td>
942 <td>Always</td>
943 </tr>
944 <tr>
945 <td>Branches</td>
946 <td>Git branches</td>
947 <td>Always</td>
948 </tr>
949 <tr>
950 <td>Tickets</td>
951 <td>GitHub/GitLab Issues</td>
952 <td>Optional</td>
953 </tr>
954 <tr>
955 <td>Wiki</td>
956 <td>Repository docs</td>
957 <td>Optional</td>
958 </tr>
959 </tbody>
960 </table>
961 <h2 id="configuration">Configuration<a class="headerlink" href="#configuration" title="Permanent link">&para;</a></h2>
962 <p>Set up mirroring through the Django management UI or environment variables:</p>
963 <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="c1"># GitHub mirror</span>
964 <a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nv">GITHUB_TOKEN</span><span class="o">=</span>ghp_xxxxxxxxxxxx
965 <a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>
966 <a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="c1"># GitLab mirror</span>
967 <a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="nv">GITLAB_TOKEN</span><span class="o">=</span>glpat-xxxxxxxxxxxx
968 </code></pre></div>
969 <p>Per-repository mirror configuration is managed in the dashboard under <strong>Repository Settings &gt; Sync</strong>.</p>
970 <h2 id="sync-modes">Sync Modes<a class="headerlink" href="#sync-modes" title="Permanent link">&para;</a></h2>
971 <h3 id="on-demand">On-Demand<a class="headerlink" href="#on-demand" title="Permanent link">&para;</a></h3>
972 <p>Trigger a sync manually from the dashboard or CLI:</p>
973 <div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>docker<span class="w"> </span>compose<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>django<span class="w"> </span>python<span class="w"> </span>manage.py<span class="w"> </span>fossil_sync<span class="w"> </span>my-project
974 </code></pre></div>
975 <h3 id="scheduled">Scheduled<a class="headerlink" href="#scheduled" title="Permanent link">&para;</a></h3>
976 <p>Configure a Celery Beat schedule to sync at regular intervals:</p>
977 <div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="c1"># Runs every 15 minutes</span>
978 <a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="n">CELERY_BEAT_SCHEDULE</span> <span class="o">=</span> <span class="p">{</span>
979 <a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a> <span class="s1">&#39;sync-all-repos&#39;</span><span class="p">:</span> <span class="p">{</span>
980 <a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a> <span class="s1">&#39;task&#39;</span><span class="p">:</span> <span class="s1">&#39;fossil.tasks.sync_all&#39;</span><span class="p">,</span>
981 <a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a> <span class="s1">&#39;schedule&#39;</span><span class="p">:</span> <span class="mf">900.0</span><span class="p">,</span>
982 <a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a> <span class="p">},</span>
983 <a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="p">}</span>
984 </code></pre></div>
985 <h3 id="upstream-pull">Upstream Pull<a class="headerlink" href="#upstream-pull" title="Permanent link">&para;</a></h3>
986 <p>Pull updates from a remote Fossil server into your local instance:</p>
987 <div class="highlight"><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>docker<span class="w"> </span>compose<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>django<span class="w"> </span>python<span class="w"> </span>manage.py<span class="w"> </span>fossil_pull<span class="w"> </span>my-project
988 </code></pre></div>
989 <div class="admonition warning">
990 <p class="admonition-title">Direction matters</p>
991 <p>The sync bridge is <strong>one-way</strong>: Fossil to Git. Changes pushed directly to a Git mirror will be overwritten on the next sync. Always push to the Fossil repo.</p>
992 </div>
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006 </article>
1007 </div>
1008
1009
1010 <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
1011
1012 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
1013 </div>
1014
1015 <button type="button" class="md-top md-icon" data-md-component="top" hidden>
1016
1017 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
1018 Back to top
1019 </button>
1020
1021 </main>
1022
1023 <footer class="md-footer">
1024
1025 <div class="md-footer-meta md-typeset">
1026 <div class="md-footer-meta__inner md-grid">
1027 <div class="md-copyright">
1028
1029 <div class="md-copyright__highlight">
1030 Copyright &copy; 2026 CONFLICT LLC
1031 </div>
1032
1033
1034 Made with
1035 <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
1036 Material for MkDocs
1037 </a>
1038
1039 </div>
1040
1041
1042 <div class="md-social">
1043
1044
1045
1046
1047
1048
1049
1050
1051 <a href="https://github.com/ConflictHQ/fossilrepo" target="_blank" rel="noopener" title="github.com" class="md-social__link">
1052 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
1053 </a>
1054
1055 </div>
1056
1057 </div>
1058 </div>
1059 </footer>
1060
1061 </div>
1062 <div class="md-dialog" data-md-component="dialog">
1063 <div class="md-dialog__inner md-typeset"></div>
1064 </div>
1065
1066
1067
1068
1069
1070 <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.instant", "navigation.tabs", "navigation.sections", "navigation.expand", "navigation.top", "search.suggest", "search.highlight", "content.code.copy", "content.tabs.link", "header.autohide"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
1071
1072
1073 <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
1074
1075
1076 </body>
1077 </html>
A site/getting-started/configuration/index.html
+1288
--- a/site/getting-started/configuration/index.html
+++ b/site/getting-started/configuration/index.html
@@ -0,0 +1,1288 @@
1
+
2
+<!doctype html>
3
+<html lang="en" class="no-js">
4
+ <head>
5
+
6
+ <meta charset="utf-8">
7
+ <meta name="viewport" content="width=device-width,initial-scale=1">
8
+
9
+ <meta name="description" content="Self-hosted Fossil forge -- omnibus installer for production Fossil SCM hosting">
10
+
11
+
12
+ <meta name="author" content="CONFLICT LLC">
13
+
14
+
15
+ <link rel="canonical" href="https://fossilrepo.dev/getting-started/configuration/">
16
+
17
+
18
+ <link rel="prev" href="../installation/">
19
+
20
+
21
+ <link rel="next" href="../first-repo/">
22
+
23
+
24
+
25
+
26
+
27
+ <link rel="icon" href="../../assets/images/favicon.png">
28
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
29
+
30
+
31
+
32
+ <title>Configuration - Fossilrepo</title>
33
+
34
+
35
+
36
+ <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
37
+
38
+
39
+ <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
40
+
41
+
42
+
43
+
44
+
45
+
46
+
47
+
48
+
49
+
50
+
51
+
52
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
53
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
54
+ <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
55
+
56
+
57
+
58
+ <link rel="stylesheet" href="../../assets/css/custom.css">
59
+
60
+ <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
61
+
62
+
63
+
64
+
65
+
66
+ </head>
67
+
68
+
69
+
70
+
71
+
72
+
73
+
74
+
75
+
76
+ <body dir="ltr" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom">
77
+
78
+
79
+ <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
80
+ <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
81
+ <label class="md-overlay" for="__drawer"></label>
82
+ <div data-md-component="skip">
83
+
84
+
85
+ <a href="#configuration" class="md-skip">
86
+ Skip to content
87
+ </a>
88
+
89
+ </div>
90
+ <div data-md-component="announce">
91
+
92
+ </div>
93
+
94
+
95
+
96
+
97
+<header class="md-header" data-md-component="header">
98
+ <nav class="md-header__inner md-grid" aria-label="Header">
99
+ <a href="../.." title="Fossilrepo" class="md-header__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
100
+ <div style="display: flex; align-items: center; gap: 0.6rem;">
101
+ <img src="../../assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
102
+ <img src="../../assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
103
+</div>
104
+ </a>
105
+ <label class="md-header__button md-icon" for="__drawer">
106
+
107
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
108
+ </label>
109
+ <div class="md-header__title" data-md-component="header-title">
110
+ <div class="md-header__ellipsis">
111
+ <div class="md-header__topic">
112
+ <span class="md-ellipsis">
113
+ Fossilrepo
114
+ </span>
115
+ </div>
116
+ <div class="md-header__topic" data-md-component="header-topic">
117
+ <span class="md-ellipsis">
118
+
119
+ Configuration
120
+
121
+ </span>
122
+ </div>
123
+ </div>
124
+ </div>
125
+
126
+
127
+ <form class="md-header__option" data-md-component="palette">
128
+
129
+
130
+
131
+
132
+ <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">
133
+
134
+ <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
135
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
136
+ </label>
137
+
138
+
139
+
140
+
141
+
142
+ <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
143
+
144
+ <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>
145
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
146
+ </label>
147
+
148
+
149
+</form>
150
+
151
+
152
+
153
+ <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
154
+
155
+
156
+
157
+
158
+
159
+ <label class="md-header__button md-icon" for="__search">
160
+
161
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
162
+ </label>
163
+ <div class="md-search" data-md-component="search" role="dialog">
164
+ <label class="md-search__overlay" for="__search"></label>
165
+ <div class="md-search__inner" role="search">
166
+ <form class="md-search__form" name="search">
167
+ <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
168
+ <label class="md-search__icon md-icon" for="__search">
169
+
170
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
171
+
172
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
173
+ </label>
174
+ <nav class="md-search__options" aria-label="Search">
175
+
176
+ <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
177
+
178
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
179
+ </button>
180
+ </nav>
181
+
182
+ <div class="md-search__suggest" data-md-component="search-suggest"></div>
183
+
184
+ </form>
185
+ <div class="md-search__output">
186
+ <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
187
+ <div class="md-search-result" data-md-component="search-result">
188
+ <div class="md-search-result__meta">
189
+ Initializing search
190
+ </div>
191
+ <ol class="md-search-result__list" role="presentation"></ol>
192
+ </div>
193
+ </div>
194
+ </div>
195
+ </div>
196
+</div>
197
+
198
+
199
+
200
+ <div class="md-header__source">
201
+ <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
202
+ <div class="md-source__icon md-icon">
203
+
204
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
205
+ </div>
206
+ <div class="md-source__repository">
207
+ ConflictHQ/fossilrepo
208
+ </div>
209
+</a>
210
+ </div>
211
+
212
+ </nav>
213
+
214
+</header>
215
+
216
+ <div class="md-container" data-md-component="container">
217
+
218
+
219
+
220
+
221
+
222
+<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
223
+ <div class="md-grid">
224
+ <ul class="md-tabs__list">
225
+
226
+
227
+
228
+
229
+
230
+
231
+ <li class="md-tabs__item">
232
+ <a href="../.." class="md-tabs__link">
233
+
234
+
235
+
236
+
237
+
238
+ Home
239
+
240
+ </a>
241
+ </li>
242
+
243
+
244
+
245
+
246
+
247
+
248
+
249
+
250
+
251
+
252
+
253
+
254
+ <li class="md-tabs__item md-tabs__item--active">
255
+ <a href="../prerequisites/" class="md-tabs__link">
256
+
257
+
258
+
259
+ Getting Started
260
+
261
+ </a>
262
+ </li>
263
+
264
+
265
+
266
+
267
+
268
+
269
+
270
+
271
+
272
+
273
+
274
+ <li class="md-tabs__item">
275
+ <a href="../../architecture/overview/" class="md-tabs__link">
276
+
277
+
278
+
279
+ Architecture
280
+
281
+ </a>
282
+ </li>
283
+
284
+
285
+
286
+
287
+ </ul>
288
+ </div>
289
+</nav>
290
+
291
+
292
+
293
+ <main class="md-main" data-md-component="main">
294
+ <div class="md-main__inner md-grid">
295
+
296
+
297
+
298
+ <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
299
+ <div class="md-sidebar__scrollwrap">
300
+ <div class="md-sidebar__inner">
301
+
302
+
303
+
304
+
305
+
306
+
307
+<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
308
+ <label class="md-nav__title" for="__drawer">
309
+ <a href="../.." title="Fossilrepo" class="md-nav__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
310
+ <div style="display: flex; align-items: center; gap: 0.6rem;">
311
+ <img src="../../assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
312
+ <img src="../../assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
313
+</div>
314
+ </a>
315
+ Fossilrepo
316
+ </label>
317
+
318
+ <div class="md-nav__source">
319
+ <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
320
+ <div class="md-source__icon md-icon">
321
+
322
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
323
+ </div>
324
+ <div class="md-source__repository">
325
+ ConflictHQ/fossilrepo
326
+ </div>
327
+</a>
328
+ </div>
329
+
330
+ <ul class="md-nav__list" data-md-scrollfix>
331
+
332
+
333
+
334
+
335
+
336
+
337
+
338
+ <li class="md-nav__item">
339
+ <a href="../.." class="md-nav__link">
340
+
341
+
342
+
343
+ <span class="md-ellipsis">
344
+
345
+
346
+ Home
347
+
348
+
349
+
350
+ </span>
351
+
352
+
353
+
354
+ </a>
355
+ </li>
356
+
357
+
358
+
359
+
360
+
361
+
362
+
363
+
364
+
365
+
366
+
367
+
368
+
369
+
370
+
371
+
372
+
373
+
374
+
375
+
376
+
377
+
378
+
379
+
380
+ <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
381
+
382
+
383
+
384
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" checked>
385
+
386
+
387
+ <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="">
388
+
389
+
390
+
391
+ <span class="md-ellipsis">
392
+
393
+
394
+ Getting Started
395
+
396
+
397
+
398
+ </span>
399
+
400
+
401
+
402
+ <span class="md-nav__icon md-icon"></span>
403
+ </label>
404
+
405
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="true">
406
+ <label class="md-nav__title" for="__nav_2">
407
+ <span class="md-nav__icon md-icon"></span>
408
+
409
+
410
+ Getting Started
411
+
412
+
413
+ </label>
414
+ <ul class="md-nav__list" data-md-scrollfix>
415
+
416
+
417
+
418
+
419
+
420
+
421
+
422
+ <li class="md-nav__item">
423
+ <a href="../prerequisites/" class="md-nav__link">
424
+
425
+
426
+
427
+ <span class="md-ellipsis">
428
+
429
+
430
+ Prerequisites
431
+
432
+
433
+
434
+ </span>
435
+
436
+
437
+
438
+ </a>
439
+ </li>
440
+
441
+
442
+
443
+
444
+
445
+
446
+
447
+
448
+
449
+
450
+ <li class="md-nav__item">
451
+ <a href="../installation/" class="md-nav__link">
452
+
453
+
454
+
455
+ <span class="md-ellipsis">
456
+
457
+
458
+ Installation
459
+
460
+
461
+
462
+ </span>
463
+
464
+
465
+
466
+ </a>
467
+ </li>
468
+
469
+
470
+
471
+
472
+
473
+
474
+
475
+
476
+
477
+
478
+
479
+
480
+ <li class="md-nav__item md-nav__item--active">
481
+
482
+ <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
483
+
484
+
485
+
486
+
487
+
488
+ <label class="md-nav__link md-nav__link--active" for="__toc">
489
+
490
+
491
+
492
+ <span class="md-ellipsis">
493
+
494
+
495
+ Configuration
496
+
497
+
498
+
499
+ </span>
500
+
501
+
502
+
503
+ <span class="md-nav__icon md-icon"></span>
504
+ </label>
505
+
506
+ <a href="./" class="md-nav__link md-nav__link--active">
507
+
508
+
509
+
510
+ <span class="md-ellipsis">
511
+
512
+
513
+ Configuration
514
+
515
+
516
+
517
+ </span>
518
+
519
+
520
+
521
+ </a>
522
+
523
+
524
+
525
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
526
+
527
+
528
+
529
+
530
+
531
+
532
+ <label class="md-nav__title" for="__toc">
533
+ <span class="md-nav__icon md-icon"></span>
534
+ Table of contents
535
+ </label>
536
+ <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
537
+
538
+ <li class="md-nav__item">
539
+ <a href="#environment-variables" class="md-nav__link">
540
+ <span class="md-ellipsis">
541
+
542
+ Environment Variables
543
+
544
+ </span>
545
+ </a>
546
+
547
+ <nav class="md-nav" aria-label="Environment Variables">
548
+ <ul class="md-nav__list">
549
+
550
+ <li class="md-nav__item">
551
+ <a href="#django-settings" class="md-nav__link">
552
+ <span class="md-ellipsis">
553
+
554
+ Django Settings
555
+
556
+ </span>
557
+ </a>
558
+
559
+</li>
560
+
561
+ <li class="md-nav__item">
562
+ <a href="#database" class="md-nav__link">
563
+ <span class="md-ellipsis">
564
+
565
+ Database
566
+
567
+ </span>
568
+ </a>
569
+
570
+</li>
571
+
572
+ <li class="md-nav__item">
573
+ <a href="#redis-celery" class="md-nav__link">
574
+ <span class="md-ellipsis">
575
+
576
+ Redis &amp; Celery
577
+
578
+ </span>
579
+ </a>
580
+
581
+</li>
582
+
583
+ <li class="md-nav__item">
584
+ <a href="#fossil" class="md-nav__link">
585
+ <span class="md-ellipsis">
586
+
587
+ Fossil
588
+
589
+ </span>
590
+ </a>
591
+
592
+</li>
593
+
594
+ <li class="md-nav__item">
595
+ <a href="#caddy-production" class="md-nav__link">
596
+ <span class="md-ellipsis">
597
+
598
+ Caddy (Production)
599
+
600
+ </span>
601
+ </a>
602
+
603
+</li>
604
+
605
+ <li class="md-nav__item">
606
+ <a href="#litestream-backups" class="md-nav__link">
607
+ <span class="md-ellipsis">
608
+
609
+ Litestream (Backups)
610
+
611
+ </span>
612
+ </a>
613
+
614
+</li>
615
+
616
+ <li class="md-nav__item">
617
+ <a href="#sync-bridge" class="md-nav__link">
618
+ <span class="md-ellipsis">
619
+
620
+ Sync Bridge
621
+
622
+ </span>
623
+ </a>
624
+
625
+</li>
626
+
627
+ </ul>
628
+ </nav>
629
+
630
+</li>
631
+
632
+ <li class="md-nav__item">
633
+ <a href="#caddy-configuration" class="md-nav__link">
634
+ <span class="md-ellipsis">
635
+
636
+ Caddy Configuration
637
+
638
+ </span>
639
+ </a>
640
+
641
+</li>
642
+
643
+ <li class="md-nav__item">
644
+ <a href="#litestream-configuration" class="md-nav__link">
645
+ <span class="md-ellipsis">
646
+
647
+ Litestream Configuration
648
+
649
+ </span>
650
+ </a>
651
+
652
+</li>
653
+
654
+ </ul>
655
+
656
+</nav>
657
+
658
+ </li>
659
+
660
+
661
+
662
+
663
+
664
+
665
+
666
+
667
+
668
+
669
+ <li class="md-nav__item">
670
+ <a href="../first-repo/" class="md-nav__link">
671
+
672
+
673
+
674
+ <span class="md-ellipsis">
675
+
676
+
677
+ First Repository
678
+
679
+
680
+
681
+ </span>
682
+
683
+
684
+
685
+ </a>
686
+ </li>
687
+
688
+
689
+
690
+
691
+ </ul>
692
+ </nav>
693
+
694
+ </li>
695
+
696
+
697
+
698
+
699
+
700
+
701
+
702
+
703
+
704
+
705
+
706
+
707
+
708
+
709
+
710
+
711
+
712
+
713
+
714
+ <li class="md-nav__item md-nav__item--nested">
715
+
716
+
717
+
718
+
719
+
720
+ <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
721
+
722
+
723
+ <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
724
+
725
+
726
+
727
+ <span class="md-ellipsis">
728
+
729
+
730
+ Architecture
731
+
732
+
733
+
734
+ </span>
735
+
736
+
737
+
738
+ <span class="md-nav__icon md-icon"></span>
739
+ </label>
740
+
741
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
742
+ <label class="md-nav__title" for="__nav_3">
743
+ <span class="md-nav__icon md-icon"></span>
744
+
745
+
746
+ Architecture
747
+
748
+
749
+ </label>
750
+ <ul class="md-nav__list" data-md-scrollfix>
751
+
752
+
753
+
754
+
755
+
756
+
757
+
758
+ <li class="md-nav__item">
759
+ <a href="../../architecture/overview/" class="md-nav__link">
760
+
761
+
762
+
763
+ <span class="md-ellipsis">
764
+
765
+
766
+ Overview
767
+
768
+
769
+
770
+ </span>
771
+
772
+
773
+
774
+ </a>
775
+ </li>
776
+
777
+
778
+
779
+
780
+
781
+
782
+
783
+
784
+
785
+
786
+ <li class="md-nav__item">
787
+ <a href="../../architecture/sync-bridge/" class="md-nav__link">
788
+
789
+
790
+
791
+ <span class="md-ellipsis">
792
+
793
+
794
+ Sync Bridge
795
+
796
+
797
+
798
+ </span>
799
+
800
+
801
+
802
+ </a>
803
+ </li>
804
+
805
+
806
+
807
+
808
+ </ul>
809
+ </nav>
810
+
811
+ </li>
812
+
813
+
814
+
815
+ </ul>
816
+</nav>
817
+ </div>
818
+ </div>
819
+ </div>
820
+
821
+
822
+
823
+ <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
824
+ <div class="md-sidebar__scrollwrap">
825
+ <div class="md-sidebar__inner">
826
+
827
+
828
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
829
+
830
+
831
+
832
+
833
+
834
+
835
+ <label class="md-nav__title" for="__toc">
836
+ <span class="md-nav__icon md-icon"></span>
837
+ Table of contents
838
+ </label>
839
+ <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
840
+
841
+ <li class="md-nav__item">
842
+ <a href="#environment-variables" class="md-nav__link">
843
+ <span class="md-ellipsis">
844
+
845
+ Environment Variables
846
+
847
+ </span>
848
+ </a>
849
+
850
+ <nav class="md-nav" aria-label="Environment Variables">
851
+ <ul class="md-nav__list">
852
+
853
+ <li class="md-nav__item">
854
+ <a href="#django-settings" class="md-nav__link">
855
+ <span class="md-ellipsis">
856
+
857
+ Django Settings
858
+
859
+ </span>
860
+ </a>
861
+
862
+</li>
863
+
864
+ <li class="md-nav__item">
865
+ <a href="#database" class="md-nav__link">
866
+ <span class="md-ellipsis">
867
+
868
+ Database
869
+
870
+ </span>
871
+ </a>
872
+
873
+</li>
874
+
875
+ <li class="md-nav__item">
876
+ <a href="#redis-celery" class="md-nav__link">
877
+ <span class="md-ellipsis">
878
+
879
+ Redis &amp; Celery
880
+
881
+ </span>
882
+ </a>
883
+
884
+</li>
885
+
886
+ <li class="md-nav__item">
887
+ <a href="#fossil" class="md-nav__link">
888
+ <span class="md-ellipsis">
889
+
890
+ Fossil
891
+
892
+ </span>
893
+ </a>
894
+
895
+</li>
896
+
897
+ <li class="md-nav__item">
898
+ <a href="#caddy-production" class="md-nav__link">
899
+ <span class="md-ellipsis">
900
+
901
+ Caddy (Production)
902
+
903
+ </span>
904
+ </a>
905
+
906
+</li>
907
+
908
+ <li class="md-nav__item">
909
+ <a href="#litestream-backups" class="md-nav__link">
910
+ <span class="md-ellipsis">
911
+
912
+ Litestream (Backups)
913
+
914
+ </span>
915
+ </a>
916
+
917
+</li>
918
+
919
+ <li class="md-nav__item">
920
+ <a href="#sync-bridge" class="md-nav__link">
921
+ <span class="md-ellipsis">
922
+
923
+ Sync Bridge
924
+
925
+ </span>
926
+ </a>
927
+
928
+</li>
929
+
930
+ </ul>
931
+ </nav>
932
+
933
+</li>
934
+
935
+ <li class="md-nav__item">
936
+ <a href="#caddy-configuration" class="md-nav__link">
937
+ <span class="md-ellipsis">
938
+
939
+ Caddy Configuration
940
+
941
+ </span>
942
+ </a>
943
+
944
+</li>
945
+
946
+ <li class="md-nav__item">
947
+ <a href="#litestream-configuration" class="md-nav__link">
948
+ <span class="md-ellipsis">
949
+
950
+ Litestream Configuration
951
+
952
+ </span>
953
+ </a>
954
+
955
+</li>
956
+
957
+ </ul>
958
+
959
+</nav>
960
+ </div>
961
+ </div>
962
+ </div>
963
+
964
+
965
+
966
+ <div class="md-content" data-md-component="content">
967
+
968
+ <article class="md-content__inner md-typeset">
969
+
970
+
971
+
972
+
973
+
974
+
975
+
976
+
977
+<h1 id="configuration">Configuration<a class="headerlink" href="#configuration" title="Permanent link">&para;</a></h1>
978
+<h2 id="environment-variables">Environment Variables<a class="headerlink" href="#environment-variables" title="Permanent link">&para;</a></h2>
979
+<p>All configuration is done through environment variables, loaded from <code>.env</code> in development.</p>
980
+<h3 id="django-settings">Django Settings<a class="headerlink" href="#django-settings" title="Permanent link">&para;</a></h3>
981
+<table>
982
+<thead>
983
+<tr>
984
+<th>Variable</th>
985
+<th>Default</th>
986
+<th>Description</th>
987
+</tr>
988
+</thead>
989
+<tbody>
990
+<tr>
991
+<td><code>SECRET_KEY</code></td>
992
+<td>--</td>
993
+<td>Django secret key (required)</td>
994
+</tr>
995
+<tr>
996
+<td><code>DEBUG</code></td>
997
+<td><code>False</code></td>
998
+<td>Enable debug mode</td>
999
+</tr>
1000
+<tr>
1001
+<td><code>ALLOWED_HOSTS</code></td>
1002
+<td><code>localhost</code></td>
1003
+<td>Comma-separated list of allowed hosts</td>
1004
+</tr>
1005
+<tr>
1006
+<td><code>TIME_ZONE</code></td>
1007
+<td><code>UTC</code></td>
1008
+<td>Server timezone</td>
1009
+</tr>
1010
+</tbody>
1011
+</table>
1012
+<h3 id="database">Database<a class="headerlink" href="#database" title="Permanent link">&para;</a></h3>
1013
+<table>
1014
+<thead>
1015
+<tr>
1016
+<th>Variable</th>
1017
+<th>Default</th>
1018
+<th>Description</th>
1019
+</tr>
1020
+</thead>
1021
+<tbody>
1022
+<tr>
1023
+<td><code>POSTGRES_DB</code></td>
1024
+<td><code>fossilrepo</code></td>
1025
+<td>Database name</td>
1026
+</tr>
1027
+<tr>
1028
+<td><code>POSTGRES_USER</code></td>
1029
+<td><code>fossilrepo</code></td>
1030
+<td>Database user</td>
1031
+</tr>
1032
+<tr>
1033
+<td><code>POSTGRES_PASSWORD</code></td>
1034
+<td>--</td>
1035
+<td>Database password (required)</td>
1036
+</tr>
1037
+<tr>
1038
+<td><code>POSTGRES_HOST</code></td>
1039
+<td><code>postgres</code></td>
1040
+<td>Database host</td>
1041
+</tr>
1042
+<tr>
1043
+<td><code>POSTGRES_PORT</code></td>
1044
+<td><code>5432</code></td>
1045
+<td>Database port</td>
1046
+</tr>
1047
+</tbody>
1048
+</table>
1049
+<h3 id="redis-celery">Redis &amp; Celery<a class="headerlink" href="#redis-celery" title="Permanent link">&para;</a></h3>
1050
+<table>
1051
+<thead>
1052
+<tr>
1053
+<th>Variable</th>
1054
+<th>Default</th>
1055
+<th>Description</th>
1056
+</tr>
1057
+</thead>
1058
+<tbody>
1059
+<tr>
1060
+<td><code>REDIS_URL</code></td>
1061
+<td><code>redis://redis:6379/0</code></td>
1062
+<td>Redis connection URL</td>
1063
+</tr>
1064
+<tr>
1065
+<td><code>CELERY_BROKER_URL</code></td>
1066
+<td><code>$REDIS_URL</code></td>
1067
+<td>Celery broker (defaults to Redis URL)</td>
1068
+</tr>
1069
+</tbody>
1070
+</table>
1071
+<h3 id="fossil">Fossil<a class="headerlink" href="#fossil" title="Permanent link">&para;</a></h3>
1072
+<table>
1073
+<thead>
1074
+<tr>
1075
+<th>Variable</th>
1076
+<th>Default</th>
1077
+<th>Description</th>
1078
+</tr>
1079
+</thead>
1080
+<tbody>
1081
+<tr>
1082
+<td><code>FOSSIL_REPO_DIR</code></td>
1083
+<td><code>/data/repos</code></td>
1084
+<td>Directory where <code>.fossil</code> files are stored</td>
1085
+</tr>
1086
+<tr>
1087
+<td><code>FOSSIL_BASE_URL</code></td>
1088
+<td>--</td>
1089
+<td>Base URL for Fossil web UI (e.g., <code>https://code.example.com</code>)</td>
1090
+</tr>
1091
+<tr>
1092
+<td><code>FOSSIL_BINARY</code></td>
1093
+<td><code>fossil</code></td>
1094
+<td>Path to the Fossil binary</td>
1095
+</tr>
1096
+</tbody>
1097
+</table>
1098
+<h3 id="caddy-production">Caddy (Production)<a class="headerlink" href="#caddy-production" title="Permanent link">&para;</a></h3>
1099
+<table>
1100
+<thead>
1101
+<tr>
1102
+<th>Variable</th>
1103
+<th>Default</th>
1104
+<th>Description</th>
1105
+</tr>
1106
+</thead>
1107
+<tbody>
1108
+<tr>
1109
+<td><code>CADDY_DOMAIN</code></td>
1110
+<td>--</td>
1111
+<td>Your domain (e.g., <code>example.com</code>)</td>
1112
+</tr>
1113
+<tr>
1114
+<td><code>CADDY_EMAIL</code></td>
1115
+<td>--</td>
1116
+<td>Email for Let's Encrypt certificates</td>
1117
+</tr>
1118
+</tbody>
1119
+</table>
1120
+<h3 id="litestream-backups">Litestream (Backups)<a class="headerlink" href="#litestream-backups" title="Permanent link">&para;</a></h3>
1121
+<table>
1122
+<thead>
1123
+<tr>
1124
+<th>Variable</th>
1125
+<th>Default</th>
1126
+<th>Description</th>
1127
+</tr>
1128
+</thead>
1129
+<tbody>
1130
+<tr>
1131
+<td><code>LITESTREAM_ACCESS_KEY_ID</code></td>
1132
+<td>--</td>
1133
+<td>S3 access key</td>
1134
+</tr>
1135
+<tr>
1136
+<td><code>LITESTREAM_SECRET_ACCESS_KEY</code></td>
1137
+<td>--</td>
1138
+<td>S3 secret key</td>
1139
+</tr>
1140
+<tr>
1141
+<td><code>LITESTREAM_BUCKET</code></td>
1142
+<td>--</td>
1143
+<td>S3 bucket name</td>
1144
+</tr>
1145
+<tr>
1146
+<td><code>LITESTREAM_ENDPOINT</code></td>
1147
+<td>--</td>
1148
+<td>S3 endpoint (for MinIO/B2)</td>
1149
+</tr>
1150
+<tr>
1151
+<td><code>LITESTREAM_REGION</code></td>
1152
+<td><code>us-east-1</code></td>
1153
+<td>S3 region</td>
1154
+</tr>
1155
+</tbody>
1156
+</table>
1157
+<h3 id="sync-bridge">Sync Bridge<a class="headerlink" href="#sync-bridge" title="Permanent link">&para;</a></h3>
1158
+<table>
1159
+<thead>
1160
+<tr>
1161
+<th>Variable</th>
1162
+<th>Default</th>
1163
+<th>Description</th>
1164
+</tr>
1165
+</thead>
1166
+<tbody>
1167
+<tr>
1168
+<td><code>GITHUB_TOKEN</code></td>
1169
+<td>--</td>
1170
+<td>GitHub personal access token (for mirroring)</td>
1171
+</tr>
1172
+<tr>
1173
+<td><code>GITLAB_TOKEN</code></td>
1174
+<td>--</td>
1175
+<td>GitLab personal access token (for mirroring)</td>
1176
+</tr>
1177
+</tbody>
1178
+</table>
1179
+<h2 id="caddy-configuration">Caddy Configuration<a class="headerlink" href="#caddy-configuration" title="Permanent link">&para;</a></h2>
1180
+<p>The Caddyfile controls SSL termination and subdomain routing. Each Fossil repo gets its own subdomain:</p>
1181
+<div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>{$CADDY_DOMAIN} {
1182
+<a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a> reverse_proxy django:8000
1183
+<a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>}
1184
+<a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>
1185
+<a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>*.{$CADDY_DOMAIN} {
1186
+<a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a> reverse_proxy fossil:8080
1187
+<a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a>}
1188
+</code></pre></div>
1189
+<p>Caddy automatically provisions Let's Encrypt certificates for all subdomains.</p>
1190
+<h2 id="litestream-configuration">Litestream Configuration<a class="headerlink" href="#litestream-configuration" title="Permanent link">&para;</a></h2>
1191
+<p>Litestream continuously replicates every <code>.fossil</code> SQLite file to S3:</p>
1192
+<div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">dbs</span><span class="p">:</span>
1193
+<a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/data/repos/*.fossil</span>
1194
+<a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="w"> </span><span class="nt">replicas</span><span class="p">:</span>
1195
+<a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">s3</span>
1196
+<a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w"> </span><span class="nt">bucket</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">${LITESTREAM_BUCKET}</span>
1197
+<a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w"> </span><span class="nt">endpoint</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">${LITESTREAM_ENDPOINT}</span>
1198
+<a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w"> </span><span class="nt">region</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">${LITESTREAM_REGION}</span>
1199
+</code></pre></div>
1200
+<div class="admonition tip">
1201
+<p class="admonition-title">Point-in-time recovery</p>
1202
+<p>Litestream replicates WAL frames continuously. You can restore any <code>.fossil</code> file to any point in time, not just the latest snapshot.</p>
1203
+</div>
1204
+
1205
+
1206
+
1207
+
1208
+
1209
+
1210
+
1211
+
1212
+
1213
+
1214
+
1215
+
1216
+
1217
+ </article>
1218
+ </div>
1219
+
1220
+
1221
+ <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
1222
+
1223
+<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
1224
+ </div>
1225
+
1226
+ <button type="button" class="md-top md-icon" data-md-component="top" hidden>
1227
+
1228
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
1229
+ Back to top
1230
+</button>
1231
+
1232
+ </main>
1233
+
1234
+ <footer class="md-footer">
1235
+
1236
+ <div class="md-footer-meta md-typeset">
1237
+ <div class="md-footer-meta__inner md-grid">
1238
+ <div class="md-copyright">
1239
+
1240
+ <div class="md-copyright__highlight">
1241
+ Copyright &copy; 2026 CONFLICT LLC
1242
+ </div>
1243
+
1244
+
1245
+ Made with
1246
+ <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
1247
+ Material for MkDocs
1248
+ </a>
1249
+
1250
+</div>
1251
+
1252
+
1253
+<div class="md-social">
1254
+
1255
+
1256
+
1257
+
1258
+
1259
+
1260
+
1261
+
1262
+ <a href="https://github.com/ConflictHQ/fossilrepo" target="_blank" rel="noopener" title="github.com" class="md-social__link">
1263
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
1264
+ </a>
1265
+
1266
+</div>
1267
+
1268
+ </div>
1269
+ </div>
1270
+</footer>
1271
+
1272
+ </div>
1273
+ <div class="md-dialog" data-md-component="dialog">
1274
+ <div class="md-dialog__inner md-typeset"></div>
1275
+ </div>
1276
+
1277
+
1278
+
1279
+
1280
+
1281
+ <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.instant", "navigation.tabs", "navigation.sections", "navigation.expand", "navigation.top", "search.suggest", "search.highlight", "content.code.copy", "content.tabs.link", "header.autohide"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
1282
+
1283
+
1284
+ <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
1285
+
1286
+
1287
+ </body>
1288
+</html>
--- a/site/getting-started/configuration/index.html
+++ b/site/getting-started/configuration/index.html
@@ -0,0 +1,1288 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
--- a/site/getting-started/configuration/index.html
+++ b/site/getting-started/configuration/index.html
@@ -0,0 +1,1288 @@
1
2 <!doctype html>
3 <html lang="en" class="no-js">
4 <head>
5
6 <meta charset="utf-8">
7 <meta name="viewport" content="width=device-width,initial-scale=1">
8
9 <meta name="description" content="Self-hosted Fossil forge -- omnibus installer for production Fossil SCM hosting">
10
11
12 <meta name="author" content="CONFLICT LLC">
13
14
15 <link rel="canonical" href="https://fossilrepo.dev/getting-started/configuration/">
16
17
18 <link rel="prev" href="../installation/">
19
20
21 <link rel="next" href="../first-repo/">
22
23
24
25
26
27 <link rel="icon" href="../../assets/images/favicon.png">
28 <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
29
30
31
32 <title>Configuration - Fossilrepo</title>
33
34
35
36 <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
37
38
39 <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
40
41
42
43
44
45
46
47
48
49
50
51
52 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
53 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
54 <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
55
56
57
58 <link rel="stylesheet" href="../../assets/css/custom.css">
59
60 <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
61
62
63
64
65
66 </head>
67
68
69
70
71
72
73
74
75
76 <body dir="ltr" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom">
77
78
79 <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
80 <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
81 <label class="md-overlay" for="__drawer"></label>
82 <div data-md-component="skip">
83
84
85 <a href="#configuration" class="md-skip">
86 Skip to content
87 </a>
88
89 </div>
90 <div data-md-component="announce">
91
92 </div>
93
94
95
96
97 <header class="md-header" data-md-component="header">
98 <nav class="md-header__inner md-grid" aria-label="Header">
99 <a href="../.." title="Fossilrepo" class="md-header__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
100 <div style="display: flex; align-items: center; gap: 0.6rem;">
101 <img src="../../assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
102 <img src="../../assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
103 </div>
104 </a>
105 <label class="md-header__button md-icon" for="__drawer">
106
107 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
108 </label>
109 <div class="md-header__title" data-md-component="header-title">
110 <div class="md-header__ellipsis">
111 <div class="md-header__topic">
112 <span class="md-ellipsis">
113 Fossilrepo
114 </span>
115 </div>
116 <div class="md-header__topic" data-md-component="header-topic">
117 <span class="md-ellipsis">
118
119 Configuration
120
121 </span>
122 </div>
123 </div>
124 </div>
125
126
127 <form class="md-header__option" data-md-component="palette">
128
129
130
131
132 <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">
133
134 <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
135 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
136 </label>
137
138
139
140
141
142 <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
143
144 <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>
145 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
146 </label>
147
148
149 </form>
150
151
152
153 <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
154
155
156
157
158
159 <label class="md-header__button md-icon" for="__search">
160
161 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
162 </label>
163 <div class="md-search" data-md-component="search" role="dialog">
164 <label class="md-search__overlay" for="__search"></label>
165 <div class="md-search__inner" role="search">
166 <form class="md-search__form" name="search">
167 <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
168 <label class="md-search__icon md-icon" for="__search">
169
170 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
171
172 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
173 </label>
174 <nav class="md-search__options" aria-label="Search">
175
176 <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
177
178 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
179 </button>
180 </nav>
181
182 <div class="md-search__suggest" data-md-component="search-suggest"></div>
183
184 </form>
185 <div class="md-search__output">
186 <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
187 <div class="md-search-result" data-md-component="search-result">
188 <div class="md-search-result__meta">
189 Initializing search
190 </div>
191 <ol class="md-search-result__list" role="presentation"></ol>
192 </div>
193 </div>
194 </div>
195 </div>
196 </div>
197
198
199
200 <div class="md-header__source">
201 <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
202 <div class="md-source__icon md-icon">
203
204 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
205 </div>
206 <div class="md-source__repository">
207 ConflictHQ/fossilrepo
208 </div>
209 </a>
210 </div>
211
212 </nav>
213
214 </header>
215
216 <div class="md-container" data-md-component="container">
217
218
219
220
221
222 <nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
223 <div class="md-grid">
224 <ul class="md-tabs__list">
225
226
227
228
229
230
231 <li class="md-tabs__item">
232 <a href="../.." class="md-tabs__link">
233
234
235
236
237
238 Home
239
240 </a>
241 </li>
242
243
244
245
246
247
248
249
250
251
252
253
254 <li class="md-tabs__item md-tabs__item--active">
255 <a href="../prerequisites/" class="md-tabs__link">
256
257
258
259 Getting Started
260
261 </a>
262 </li>
263
264
265
266
267
268
269
270
271
272
273
274 <li class="md-tabs__item">
275 <a href="../../architecture/overview/" class="md-tabs__link">
276
277
278
279 Architecture
280
281 </a>
282 </li>
283
284
285
286
287 </ul>
288 </div>
289 </nav>
290
291
292
293 <main class="md-main" data-md-component="main">
294 <div class="md-main__inner md-grid">
295
296
297
298 <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
299 <div class="md-sidebar__scrollwrap">
300 <div class="md-sidebar__inner">
301
302
303
304
305
306
307 <nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
308 <label class="md-nav__title" for="__drawer">
309 <a href="../.." title="Fossilrepo" class="md-nav__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
310 <div style="display: flex; align-items: center; gap: 0.6rem;">
311 <img src="../../assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
312 <img src="../../assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
313 </div>
314 </a>
315 Fossilrepo
316 </label>
317
318 <div class="md-nav__source">
319 <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
320 <div class="md-source__icon md-icon">
321
322 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
323 </div>
324 <div class="md-source__repository">
325 ConflictHQ/fossilrepo
326 </div>
327 </a>
328 </div>
329
330 <ul class="md-nav__list" data-md-scrollfix>
331
332
333
334
335
336
337
338 <li class="md-nav__item">
339 <a href="../.." class="md-nav__link">
340
341
342
343 <span class="md-ellipsis">
344
345
346 Home
347
348
349
350 </span>
351
352
353
354 </a>
355 </li>
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380 <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
381
382
383
384 <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" checked>
385
386
387 <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="">
388
389
390
391 <span class="md-ellipsis">
392
393
394 Getting Started
395
396
397
398 </span>
399
400
401
402 <span class="md-nav__icon md-icon"></span>
403 </label>
404
405 <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="true">
406 <label class="md-nav__title" for="__nav_2">
407 <span class="md-nav__icon md-icon"></span>
408
409
410 Getting Started
411
412
413 </label>
414 <ul class="md-nav__list" data-md-scrollfix>
415
416
417
418
419
420
421
422 <li class="md-nav__item">
423 <a href="../prerequisites/" class="md-nav__link">
424
425
426
427 <span class="md-ellipsis">
428
429
430 Prerequisites
431
432
433
434 </span>
435
436
437
438 </a>
439 </li>
440
441
442
443
444
445
446
447
448
449
450 <li class="md-nav__item">
451 <a href="../installation/" class="md-nav__link">
452
453
454
455 <span class="md-ellipsis">
456
457
458 Installation
459
460
461
462 </span>
463
464
465
466 </a>
467 </li>
468
469
470
471
472
473
474
475
476
477
478
479
480 <li class="md-nav__item md-nav__item--active">
481
482 <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
483
484
485
486
487
488 <label class="md-nav__link md-nav__link--active" for="__toc">
489
490
491
492 <span class="md-ellipsis">
493
494
495 Configuration
496
497
498
499 </span>
500
501
502
503 <span class="md-nav__icon md-icon"></span>
504 </label>
505
506 <a href="./" class="md-nav__link md-nav__link--active">
507
508
509
510 <span class="md-ellipsis">
511
512
513 Configuration
514
515
516
517 </span>
518
519
520
521 </a>
522
523
524
525 <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
526
527
528
529
530
531
532 <label class="md-nav__title" for="__toc">
533 <span class="md-nav__icon md-icon"></span>
534 Table of contents
535 </label>
536 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
537
538 <li class="md-nav__item">
539 <a href="#environment-variables" class="md-nav__link">
540 <span class="md-ellipsis">
541
542 Environment Variables
543
544 </span>
545 </a>
546
547 <nav class="md-nav" aria-label="Environment Variables">
548 <ul class="md-nav__list">
549
550 <li class="md-nav__item">
551 <a href="#django-settings" class="md-nav__link">
552 <span class="md-ellipsis">
553
554 Django Settings
555
556 </span>
557 </a>
558
559 </li>
560
561 <li class="md-nav__item">
562 <a href="#database" class="md-nav__link">
563 <span class="md-ellipsis">
564
565 Database
566
567 </span>
568 </a>
569
570 </li>
571
572 <li class="md-nav__item">
573 <a href="#redis-celery" class="md-nav__link">
574 <span class="md-ellipsis">
575
576 Redis &amp; Celery
577
578 </span>
579 </a>
580
581 </li>
582
583 <li class="md-nav__item">
584 <a href="#fossil" class="md-nav__link">
585 <span class="md-ellipsis">
586
587 Fossil
588
589 </span>
590 </a>
591
592 </li>
593
594 <li class="md-nav__item">
595 <a href="#caddy-production" class="md-nav__link">
596 <span class="md-ellipsis">
597
598 Caddy (Production)
599
600 </span>
601 </a>
602
603 </li>
604
605 <li class="md-nav__item">
606 <a href="#litestream-backups" class="md-nav__link">
607 <span class="md-ellipsis">
608
609 Litestream (Backups)
610
611 </span>
612 </a>
613
614 </li>
615
616 <li class="md-nav__item">
617 <a href="#sync-bridge" class="md-nav__link">
618 <span class="md-ellipsis">
619
620 Sync Bridge
621
622 </span>
623 </a>
624
625 </li>
626
627 </ul>
628 </nav>
629
630 </li>
631
632 <li class="md-nav__item">
633 <a href="#caddy-configuration" class="md-nav__link">
634 <span class="md-ellipsis">
635
636 Caddy Configuration
637
638 </span>
639 </a>
640
641 </li>
642
643 <li class="md-nav__item">
644 <a href="#litestream-configuration" class="md-nav__link">
645 <span class="md-ellipsis">
646
647 Litestream Configuration
648
649 </span>
650 </a>
651
652 </li>
653
654 </ul>
655
656 </nav>
657
658 </li>
659
660
661
662
663
664
665
666
667
668
669 <li class="md-nav__item">
670 <a href="../first-repo/" class="md-nav__link">
671
672
673
674 <span class="md-ellipsis">
675
676
677 First Repository
678
679
680
681 </span>
682
683
684
685 </a>
686 </li>
687
688
689
690
691 </ul>
692 </nav>
693
694 </li>
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714 <li class="md-nav__item md-nav__item--nested">
715
716
717
718
719
720 <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
721
722
723 <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
724
725
726
727 <span class="md-ellipsis">
728
729
730 Architecture
731
732
733
734 </span>
735
736
737
738 <span class="md-nav__icon md-icon"></span>
739 </label>
740
741 <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
742 <label class="md-nav__title" for="__nav_3">
743 <span class="md-nav__icon md-icon"></span>
744
745
746 Architecture
747
748
749 </label>
750 <ul class="md-nav__list" data-md-scrollfix>
751
752
753
754
755
756
757
758 <li class="md-nav__item">
759 <a href="../../architecture/overview/" class="md-nav__link">
760
761
762
763 <span class="md-ellipsis">
764
765
766 Overview
767
768
769
770 </span>
771
772
773
774 </a>
775 </li>
776
777
778
779
780
781
782
783
784
785
786 <li class="md-nav__item">
787 <a href="../../architecture/sync-bridge/" class="md-nav__link">
788
789
790
791 <span class="md-ellipsis">
792
793
794 Sync Bridge
795
796
797
798 </span>
799
800
801
802 </a>
803 </li>
804
805
806
807
808 </ul>
809 </nav>
810
811 </li>
812
813
814
815 </ul>
816 </nav>
817 </div>
818 </div>
819 </div>
820
821
822
823 <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
824 <div class="md-sidebar__scrollwrap">
825 <div class="md-sidebar__inner">
826
827
828 <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
829
830
831
832
833
834
835 <label class="md-nav__title" for="__toc">
836 <span class="md-nav__icon md-icon"></span>
837 Table of contents
838 </label>
839 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
840
841 <li class="md-nav__item">
842 <a href="#environment-variables" class="md-nav__link">
843 <span class="md-ellipsis">
844
845 Environment Variables
846
847 </span>
848 </a>
849
850 <nav class="md-nav" aria-label="Environment Variables">
851 <ul class="md-nav__list">
852
853 <li class="md-nav__item">
854 <a href="#django-settings" class="md-nav__link">
855 <span class="md-ellipsis">
856
857 Django Settings
858
859 </span>
860 </a>
861
862 </li>
863
864 <li class="md-nav__item">
865 <a href="#database" class="md-nav__link">
866 <span class="md-ellipsis">
867
868 Database
869
870 </span>
871 </a>
872
873 </li>
874
875 <li class="md-nav__item">
876 <a href="#redis-celery" class="md-nav__link">
877 <span class="md-ellipsis">
878
879 Redis &amp; Celery
880
881 </span>
882 </a>
883
884 </li>
885
886 <li class="md-nav__item">
887 <a href="#fossil" class="md-nav__link">
888 <span class="md-ellipsis">
889
890 Fossil
891
892 </span>
893 </a>
894
895 </li>
896
897 <li class="md-nav__item">
898 <a href="#caddy-production" class="md-nav__link">
899 <span class="md-ellipsis">
900
901 Caddy (Production)
902
903 </span>
904 </a>
905
906 </li>
907
908 <li class="md-nav__item">
909 <a href="#litestream-backups" class="md-nav__link">
910 <span class="md-ellipsis">
911
912 Litestream (Backups)
913
914 </span>
915 </a>
916
917 </li>
918
919 <li class="md-nav__item">
920 <a href="#sync-bridge" class="md-nav__link">
921 <span class="md-ellipsis">
922
923 Sync Bridge
924
925 </span>
926 </a>
927
928 </li>
929
930 </ul>
931 </nav>
932
933 </li>
934
935 <li class="md-nav__item">
936 <a href="#caddy-configuration" class="md-nav__link">
937 <span class="md-ellipsis">
938
939 Caddy Configuration
940
941 </span>
942 </a>
943
944 </li>
945
946 <li class="md-nav__item">
947 <a href="#litestream-configuration" class="md-nav__link">
948 <span class="md-ellipsis">
949
950 Litestream Configuration
951
952 </span>
953 </a>
954
955 </li>
956
957 </ul>
958
959 </nav>
960 </div>
961 </div>
962 </div>
963
964
965
966 <div class="md-content" data-md-component="content">
967
968 <article class="md-content__inner md-typeset">
969
970
971
972
973
974
975
976
977 <h1 id="configuration">Configuration<a class="headerlink" href="#configuration" title="Permanent link">&para;</a></h1>
978 <h2 id="environment-variables">Environment Variables<a class="headerlink" href="#environment-variables" title="Permanent link">&para;</a></h2>
979 <p>All configuration is done through environment variables, loaded from <code>.env</code> in development.</p>
980 <h3 id="django-settings">Django Settings<a class="headerlink" href="#django-settings" title="Permanent link">&para;</a></h3>
981 <table>
982 <thead>
983 <tr>
984 <th>Variable</th>
985 <th>Default</th>
986 <th>Description</th>
987 </tr>
988 </thead>
989 <tbody>
990 <tr>
991 <td><code>SECRET_KEY</code></td>
992 <td>--</td>
993 <td>Django secret key (required)</td>
994 </tr>
995 <tr>
996 <td><code>DEBUG</code></td>
997 <td><code>False</code></td>
998 <td>Enable debug mode</td>
999 </tr>
1000 <tr>
1001 <td><code>ALLOWED_HOSTS</code></td>
1002 <td><code>localhost</code></td>
1003 <td>Comma-separated list of allowed hosts</td>
1004 </tr>
1005 <tr>
1006 <td><code>TIME_ZONE</code></td>
1007 <td><code>UTC</code></td>
1008 <td>Server timezone</td>
1009 </tr>
1010 </tbody>
1011 </table>
1012 <h3 id="database">Database<a class="headerlink" href="#database" title="Permanent link">&para;</a></h3>
1013 <table>
1014 <thead>
1015 <tr>
1016 <th>Variable</th>
1017 <th>Default</th>
1018 <th>Description</th>
1019 </tr>
1020 </thead>
1021 <tbody>
1022 <tr>
1023 <td><code>POSTGRES_DB</code></td>
1024 <td><code>fossilrepo</code></td>
1025 <td>Database name</td>
1026 </tr>
1027 <tr>
1028 <td><code>POSTGRES_USER</code></td>
1029 <td><code>fossilrepo</code></td>
1030 <td>Database user</td>
1031 </tr>
1032 <tr>
1033 <td><code>POSTGRES_PASSWORD</code></td>
1034 <td>--</td>
1035 <td>Database password (required)</td>
1036 </tr>
1037 <tr>
1038 <td><code>POSTGRES_HOST</code></td>
1039 <td><code>postgres</code></td>
1040 <td>Database host</td>
1041 </tr>
1042 <tr>
1043 <td><code>POSTGRES_PORT</code></td>
1044 <td><code>5432</code></td>
1045 <td>Database port</td>
1046 </tr>
1047 </tbody>
1048 </table>
1049 <h3 id="redis-celery">Redis &amp; Celery<a class="headerlink" href="#redis-celery" title="Permanent link">&para;</a></h3>
1050 <table>
1051 <thead>
1052 <tr>
1053 <th>Variable</th>
1054 <th>Default</th>
1055 <th>Description</th>
1056 </tr>
1057 </thead>
1058 <tbody>
1059 <tr>
1060 <td><code>REDIS_URL</code></td>
1061 <td><code>redis://redis:6379/0</code></td>
1062 <td>Redis connection URL</td>
1063 </tr>
1064 <tr>
1065 <td><code>CELERY_BROKER_URL</code></td>
1066 <td><code>$REDIS_URL</code></td>
1067 <td>Celery broker (defaults to Redis URL)</td>
1068 </tr>
1069 </tbody>
1070 </table>
1071 <h3 id="fossil">Fossil<a class="headerlink" href="#fossil" title="Permanent link">&para;</a></h3>
1072 <table>
1073 <thead>
1074 <tr>
1075 <th>Variable</th>
1076 <th>Default</th>
1077 <th>Description</th>
1078 </tr>
1079 </thead>
1080 <tbody>
1081 <tr>
1082 <td><code>FOSSIL_REPO_DIR</code></td>
1083 <td><code>/data/repos</code></td>
1084 <td>Directory where <code>.fossil</code> files are stored</td>
1085 </tr>
1086 <tr>
1087 <td><code>FOSSIL_BASE_URL</code></td>
1088 <td>--</td>
1089 <td>Base URL for Fossil web UI (e.g., <code>https://code.example.com</code>)</td>
1090 </tr>
1091 <tr>
1092 <td><code>FOSSIL_BINARY</code></td>
1093 <td><code>fossil</code></td>
1094 <td>Path to the Fossil binary</td>
1095 </tr>
1096 </tbody>
1097 </table>
1098 <h3 id="caddy-production">Caddy (Production)<a class="headerlink" href="#caddy-production" title="Permanent link">&para;</a></h3>
1099 <table>
1100 <thead>
1101 <tr>
1102 <th>Variable</th>
1103 <th>Default</th>
1104 <th>Description</th>
1105 </tr>
1106 </thead>
1107 <tbody>
1108 <tr>
1109 <td><code>CADDY_DOMAIN</code></td>
1110 <td>--</td>
1111 <td>Your domain (e.g., <code>example.com</code>)</td>
1112 </tr>
1113 <tr>
1114 <td><code>CADDY_EMAIL</code></td>
1115 <td>--</td>
1116 <td>Email for Let's Encrypt certificates</td>
1117 </tr>
1118 </tbody>
1119 </table>
1120 <h3 id="litestream-backups">Litestream (Backups)<a class="headerlink" href="#litestream-backups" title="Permanent link">&para;</a></h3>
1121 <table>
1122 <thead>
1123 <tr>
1124 <th>Variable</th>
1125 <th>Default</th>
1126 <th>Description</th>
1127 </tr>
1128 </thead>
1129 <tbody>
1130 <tr>
1131 <td><code>LITESTREAM_ACCESS_KEY_ID</code></td>
1132 <td>--</td>
1133 <td>S3 access key</td>
1134 </tr>
1135 <tr>
1136 <td><code>LITESTREAM_SECRET_ACCESS_KEY</code></td>
1137 <td>--</td>
1138 <td>S3 secret key</td>
1139 </tr>
1140 <tr>
1141 <td><code>LITESTREAM_BUCKET</code></td>
1142 <td>--</td>
1143 <td>S3 bucket name</td>
1144 </tr>
1145 <tr>
1146 <td><code>LITESTREAM_ENDPOINT</code></td>
1147 <td>--</td>
1148 <td>S3 endpoint (for MinIO/B2)</td>
1149 </tr>
1150 <tr>
1151 <td><code>LITESTREAM_REGION</code></td>
1152 <td><code>us-east-1</code></td>
1153 <td>S3 region</td>
1154 </tr>
1155 </tbody>
1156 </table>
1157 <h3 id="sync-bridge">Sync Bridge<a class="headerlink" href="#sync-bridge" title="Permanent link">&para;</a></h3>
1158 <table>
1159 <thead>
1160 <tr>
1161 <th>Variable</th>
1162 <th>Default</th>
1163 <th>Description</th>
1164 </tr>
1165 </thead>
1166 <tbody>
1167 <tr>
1168 <td><code>GITHUB_TOKEN</code></td>
1169 <td>--</td>
1170 <td>GitHub personal access token (for mirroring)</td>
1171 </tr>
1172 <tr>
1173 <td><code>GITLAB_TOKEN</code></td>
1174 <td>--</td>
1175 <td>GitLab personal access token (for mirroring)</td>
1176 </tr>
1177 </tbody>
1178 </table>
1179 <h2 id="caddy-configuration">Caddy Configuration<a class="headerlink" href="#caddy-configuration" title="Permanent link">&para;</a></h2>
1180 <p>The Caddyfile controls SSL termination and subdomain routing. Each Fossil repo gets its own subdomain:</p>
1181 <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>{$CADDY_DOMAIN} {
1182 <a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a> reverse_proxy django:8000
1183 <a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>}
1184 <a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>
1185 <a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>*.{$CADDY_DOMAIN} {
1186 <a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a> reverse_proxy fossil:8080
1187 <a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a>}
1188 </code></pre></div>
1189 <p>Caddy automatically provisions Let's Encrypt certificates for all subdomains.</p>
1190 <h2 id="litestream-configuration">Litestream Configuration<a class="headerlink" href="#litestream-configuration" title="Permanent link">&para;</a></h2>
1191 <p>Litestream continuously replicates every <code>.fossil</code> SQLite file to S3:</p>
1192 <div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">dbs</span><span class="p">:</span>
1193 <a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/data/repos/*.fossil</span>
1194 <a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="w"> </span><span class="nt">replicas</span><span class="p">:</span>
1195 <a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">s3</span>
1196 <a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w"> </span><span class="nt">bucket</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">${LITESTREAM_BUCKET}</span>
1197 <a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w"> </span><span class="nt">endpoint</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">${LITESTREAM_ENDPOINT}</span>
1198 <a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w"> </span><span class="nt">region</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">${LITESTREAM_REGION}</span>
1199 </code></pre></div>
1200 <div class="admonition tip">
1201 <p class="admonition-title">Point-in-time recovery</p>
1202 <p>Litestream replicates WAL frames continuously. You can restore any <code>.fossil</code> file to any point in time, not just the latest snapshot.</p>
1203 </div>
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217 </article>
1218 </div>
1219
1220
1221 <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
1222
1223 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
1224 </div>
1225
1226 <button type="button" class="md-top md-icon" data-md-component="top" hidden>
1227
1228 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
1229 Back to top
1230 </button>
1231
1232 </main>
1233
1234 <footer class="md-footer">
1235
1236 <div class="md-footer-meta md-typeset">
1237 <div class="md-footer-meta__inner md-grid">
1238 <div class="md-copyright">
1239
1240 <div class="md-copyright__highlight">
1241 Copyright &copy; 2026 CONFLICT LLC
1242 </div>
1243
1244
1245 Made with
1246 <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
1247 Material for MkDocs
1248 </a>
1249
1250 </div>
1251
1252
1253 <div class="md-social">
1254
1255
1256
1257
1258
1259
1260
1261
1262 <a href="https://github.com/ConflictHQ/fossilrepo" target="_blank" rel="noopener" title="github.com" class="md-social__link">
1263 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
1264 </a>
1265
1266 </div>
1267
1268 </div>
1269 </div>
1270 </footer>
1271
1272 </div>
1273 <div class="md-dialog" data-md-component="dialog">
1274 <div class="md-dialog__inner md-typeset"></div>
1275 </div>
1276
1277
1278
1279
1280
1281 <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.instant", "navigation.tabs", "navigation.sections", "navigation.expand", "navigation.top", "search.suggest", "search.highlight", "content.code.copy", "content.tabs.link", "header.autohide"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
1282
1283
1284 <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
1285
1286
1287 </body>
1288 </html>
A site/getting-started/first-repo/index.html
+1074
--- a/site/getting-started/first-repo/index.html
+++ b/site/getting-started/first-repo/index.html
@@ -0,0 +1,1074 @@
1
+
2
+<!doctype html>
3
+<html lang="en" class="no-js">
4
+ <head>
5
+
6
+ <meta charset="utf-8">
7
+ <meta name="viewport" content="width=device-width,initial-scale=1">
8
+
9
+ <meta name="description" content="Self-hosted Fossil forge -- omnibus installer for production Fossil SCM hosting">
10
+
11
+
12
+ <meta name="author" content="CONFLICT LLC">
13
+
14
+
15
+ <link rel="canonical" href="https://fossilrepo.dev/getting-started/first-repo/">
16
+
17
+
18
+ <link rel="prev" href="../configuration/">
19
+
20
+
21
+ <link rel="next" href="../../architecture/overview/">
22
+
23
+
24
+
25
+
26
+
27
+ <link rel="icon" href="../../assets/images/favicon.png">
28
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
29
+
30
+
31
+
32
+ <title>First Repository - Fossilrepo</title>
33
+
34
+
35
+
36
+ <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
37
+
38
+
39
+ <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
40
+
41
+
42
+
43
+
44
+
45
+
46
+
47
+
48
+
49
+
50
+
51
+
52
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
53
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
54
+ <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
55
+
56
+
57
+
58
+ <link rel="stylesheet" href="../../assets/css/custom.css">
59
+
60
+ <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
61
+
62
+
63
+
64
+
65
+
66
+ </head>
67
+
68
+
69
+
70
+
71
+
72
+
73
+
74
+
75
+
76
+ <body dir="ltr" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom">
77
+
78
+
79
+ <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
80
+ <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
81
+ <label class="md-overlay" for="__drawer"></label>
82
+ <div data-md-component="skip">
83
+
84
+
85
+ <a href="#creating-your-first-repository" class="md-skip">
86
+ Skip to content
87
+ </a>
88
+
89
+ </div>
90
+ <div data-md-component="announce">
91
+
92
+ </div>
93
+
94
+
95
+
96
+
97
+<header class="md-header" data-md-component="header">
98
+ <nav class="md-header__inner md-grid" aria-label="Header">
99
+ <a href="../.." title="Fossilrepo" class="md-header__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
100
+ <div style="display: flex; align-items: center; gap: 0.6rem;">
101
+ <img src="../../assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
102
+ <img src="../../assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
103
+</div>
104
+ </a>
105
+ <label class="md-header__button md-icon" for="__drawer">
106
+
107
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
108
+ </label>
109
+ <div class="md-header__title" data-md-component="header-title">
110
+ <div class="md-header__ellipsis">
111
+ <div class="md-header__topic">
112
+ <span class="md-ellipsis">
113
+ Fossilrepo
114
+ </span>
115
+ </div>
116
+ <div class="md-header__topic" data-md-component="header-topic">
117
+ <span class="md-ellipsis">
118
+
119
+ First Repository
120
+
121
+ </span>
122
+ </div>
123
+ </div>
124
+ </div>
125
+
126
+
127
+ <form class="md-header__option" data-md-component="palette">
128
+
129
+
130
+
131
+
132
+ <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">
133
+
134
+ <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
135
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
136
+ </label>
137
+
138
+
139
+
140
+
141
+
142
+ <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
143
+
144
+ <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>
145
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
146
+ </label>
147
+
148
+
149
+</form>
150
+
151
+
152
+
153
+ <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
154
+
155
+
156
+
157
+
158
+
159
+ <label class="md-header__button md-icon" for="__search">
160
+
161
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
162
+ </label>
163
+ <div class="md-search" data-md-component="search" role="dialog">
164
+ <label class="md-search__overlay" for="__search"></label>
165
+ <div class="md-search__inner" role="search">
166
+ <form class="md-search__form" name="search">
167
+ <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
168
+ <label class="md-search__icon md-icon" for="__search">
169
+
170
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
171
+
172
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
173
+ </label>
174
+ <nav class="md-search__options" aria-label="Search">
175
+
176
+ <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
177
+
178
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
179
+ </button>
180
+ </nav>
181
+
182
+ <div class="md-search__suggest" data-md-component="search-suggest"></div>
183
+
184
+ </form>
185
+ <div class="md-search__output">
186
+ <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
187
+ <div class="md-search-result" data-md-component="search-result">
188
+ <div class="md-search-result__meta">
189
+ Initializing search
190
+ </div>
191
+ <ol class="md-search-result__list" role="presentation"></ol>
192
+ </div>
193
+ </div>
194
+ </div>
195
+ </div>
196
+</div>
197
+
198
+
199
+
200
+ <div class="md-header__source">
201
+ <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
202
+ <div class="md-source__icon md-icon">
203
+
204
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
205
+ </div>
206
+ <div class="md-source__repository">
207
+ ConflictHQ/fossilrepo
208
+ </div>
209
+</a>
210
+ </div>
211
+
212
+ </nav>
213
+
214
+</header>
215
+
216
+ <div class="md-container" data-md-component="container">
217
+
218
+
219
+
220
+
221
+
222
+<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
223
+ <div class="md-grid">
224
+ <ul class="md-tabs__list">
225
+
226
+
227
+
228
+
229
+
230
+
231
+ <li class="md-tabs__item">
232
+ <a href="../.." class="md-tabs__link">
233
+
234
+
235
+
236
+
237
+
238
+ Home
239
+
240
+ </a>
241
+ </li>
242
+
243
+
244
+
245
+
246
+
247
+
248
+
249
+
250
+
251
+
252
+
253
+
254
+ <li class="md-tabs__item md-tabs__item--active">
255
+ <a href="../prerequisites/" class="md-tabs__link">
256
+
257
+
258
+
259
+ Getting Started
260
+
261
+ </a>
262
+ </li>
263
+
264
+
265
+
266
+
267
+
268
+
269
+
270
+
271
+
272
+
273
+
274
+ <li class="md-tabs__item">
275
+ <a href="../../architecture/overview/" class="md-tabs__link">
276
+
277
+
278
+
279
+ Architecture
280
+
281
+ </a>
282
+ </li>
283
+
284
+
285
+
286
+
287
+ </ul>
288
+ </div>
289
+</nav>
290
+
291
+
292
+
293
+ <main class="md-main" data-md-component="main">
294
+ <div class="md-main__inner md-grid">
295
+
296
+
297
+
298
+ <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
299
+ <div class="md-sidebar__scrollwrap">
300
+ <div class="md-sidebar__inner">
301
+
302
+
303
+
304
+
305
+
306
+
307
+<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
308
+ <label class="md-nav__title" for="__drawer">
309
+ <a href="../.." title="Fossilrepo" class="md-nav__button md-logo" aria-label="Fossilrepo" data-md-component="logo">
310
+ <div style="display: flex; align-items: center; gap: 0.6rem;">
311
+ <img src="../../assets/images/conflict-logo.svg" alt="CONFLICT" style="height: 1.4rem; width: auto;">
312
+ <img src="../../assets/images/fossilrepo-logo.svg" alt="Fossilrepo" style="height: 1.2rem; width: auto;">
313
+</div>
314
+ </a>
315
+ Fossilrepo
316
+ </label>
317
+
318
+ <div class="md-nav__source">
319
+ <a href="https://github.com/ConflictHQ/fossilrepo" title="Go to repository" class="md-source" data-md-component="source">
320
+ <div class="md-source__icon md-icon">
321
+
322
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
323
+ </div>
324
+ <div class="md-source__repository">
325
+ ConflictHQ/fossilrepo
326
+ </div>
327
+</a>
328
+ </div>
329
+
330
+ <ul class="md-nav__list" data-md-scrollfix>
331
+
332
+
333
+
334
+
335
+
336
+
337
+
338
+ <li class="md-nav__item">
339
+ <a href="../.." class="md-nav__link">
340
+
341
+
342
+
343
+ <span class="md-ellipsis">
344
+
345
+
346
+ Home
347
+
348
+
349
+
350
+ </span>
351
+
352
+
353
+
354
+ </a>
355
+ </li>
356
+
357
+
358
+
359
+
360
+
361
+
362
+
363
+
364
+
365
+
366
+
367
+
368
+
369
+
370
+
371
+
372
+
373
+
374
+
375
+
376
+
377
+
378
+
379
+
380
+ <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
381
+
382
+