1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
|
-
+
+
-
+
+
-
+
+
+
-
+
+
-
+
+
-
+
-
-
+
-
-
-
-
-
-
-
-
+
+
+
+
+
-
-
-
-
-
-
+
-
-
-
-
-
-
+
-
-
+
-
-
-
-
-
+
-
+
+
+
+
-
-
-
+
-
+
-
+
-
+
-
-
+
-
+
-
+
+
+
-
+
+
+
+
+
+
-
+
+
+
+
+
-
+
+
+
+
+
+
-
-
+
+
+
-
-
-
+
+
+
+
+
+
+
+
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
|
# Creating a New Repository
# Adding a Repository
How to put a new repo on fossil.craftdesign.group. Five commands, then `apply.py` does the rest: skin, Bone Hive logo, home page, public access, and the card on the landing page.
Everything needed to add a repo to fossil.craftdesign.group.
## 1. Initialize the repo
## 1. Create the repository
```bash
fossil init /var/fossil/repos/<name>.fossil
fossil user new dmestas dmestas /var/fossil/repos/<name>.fossil
```
To host an existing project instead, skip `init` and copy its `.fossil` file into `/var/fossil/repos/`. Git projects are mirrored rather than copied, see [Mirrors](#mirrors) below. zit repositories cannot be read by Fossil directly: serve them with `zit serve --port 8899` and `fossil clone http://localhost:8899/ <name>.fossil` to get a Fossil file.
## 2. Set the admin password
fossil user password dmestas <password> -R /var/fossil/repos/<name>.fossil
fossil config -R /var/fossil/repos/<name>.fossil set project-name <name>
fossil config -R /var/fossil/repos/<name>.fossil set project-description "What this repo does"
```
## 3. Create the meta sidecar
## 2. Write the meta file
Controls the icon and description shown on the landing page. Two lines — emoji icon, then description:
```bash
printf '🚀\nShort description of the project' > /var/fossil/repos/<name>.meta
```
If no `.meta` file exists, the repo will appear with a `📦` icon and no description.
Optional lines 3 and 4 set the public access policy: line 3 is the Fossil capability string for `nobody` (not logged in), line 4 for `anonymous` (defaults to line 3). The default is `jh` (wiki read only). Example for a repo with a public, moderated forum:
```
🪨
Fossil's formats and sync protocol, reimplemented in Zig
ghoj2
ghoj23
```
`2` lets visitors read the forum, `3` lets anonymous users post with their posts held for moderation. The `.meta` files are versioned in the fossil-skin repo under `repos/`; edit them there and deploy, rather than only on the server.
## 4. Run apply.py
Skins the repo, sets public access policy (wiki-only), and regenerates the landing page:
python3 /var/fossil/skin/apply.py
printf 'package\nWhat this repo does\nghoj\n' > /var/fossil/repos/<name>.meta
```
## 5. Add to the login group
Allows single sign-on across all repos — log in once, authenticated everywhere:
```bash
fossil login-group join /var/fossil/repos/edgesync.fossil \
-R /var/fossil/repos/<name>.fossil
```
Verify it joined:
```bash
fossil login-group -R /var/fossil/repos/<name>.fossil
```
## 6. Create the wiki home page
## 3. Create the home page
Sets what visitors see when they land on the repo:
Description of the project.
```
fossil clone https://dmestas@fossil.craftdesign.group/<name>/ <name>.fossil
```
## 7. Done
The repo is live at `https://fossil.craftdesign.group/<name>/` and appears on the landing page automatically.
---
## Full one-liner checklist
PASS=changeme
ICON="📦"
ICON=package # see the icon list above
CAPS=ghoj # public read; use jh for wiki-only
R=/var/fossil/repos/$NAME.fossil
fossil init /var/fossil/repos/$NAME.fossil
fossil user password dmestas $PASS -R /var/fossil/repos/$NAME.fossil
printf "$ICON\n$DESC" > /var/fossil/repos/$NAME.meta
fossil init $R
fossil user new dmestas dmestas $R
fossil config -R $R set project-name $NAME
fossil config -R $R set project-description "$DESC"
printf '%s\n%s\n%s\n' "$ICON" "$DESC" "$CAPS" > /var/fossil/repos/$NAME.meta
printf '# %s\n\n%s\n' "$NAME" "$DESC" | fossil wiki create index -mimetype text/x-markdown -R $R
fossil login-group join /var/fossil/repos/zit.fossil -R $R
python3 /var/fossil/skin/apply.py
```
fossil login-group join /var/fossil/repos/edgesync.fossil \
-R /var/fossil/repos/$NAME.fossil
|