GitRoot

 1<!--
 2SPDX-FileCopyrightText: 2026 Romain Maneschi <romain@gitroot.dev>
 3
 4SPDX-License-Identifier: CC-BY-SA-4.0
 5-->
 6
 7# Managing repositories
 8
 9The `.gitroot/repositories.yml` yaml file is where you can manage repositories of your forge. Present only in the [root repository](./root_repository.md).
10
11## Structure
12
13```yaml
14root:
15  kind: normal
16  defaultbranch: main
17  owners: []
18  forkurl: ""
19repo1:
20  kind: normal
21  defaultbranch: main
22  owners: []
23  forkurl: ""
24```
25
26## Name
27
28The first property is the name of your repo. This will make your repository accessible at `ssh://yourintance.com/name`.
29
30## Kind
31
32Only kind `normal` is officialy supported today.
33
34## Default branch
35
36The [most importante branch](./default_branch.md), by default `main` but can be `dev` or `next` if your prefer.
37
38## Owners
39
40Add your public ssh key here to be sure you will be the owner of this repo.
41
42## forkurl
43
44Not supported today