From 26ce6aa32b44796da5c139481011e9e372865a69 Mon Sep 17 00:00:00 2001
From: Earl Warren <contact@earl-warren.org>
Date: Mon, 9 Oct 2023 13:28:46 +0200
Subject: [PATCH] admin: adopt

---
 docs/admin/adopt.md | 13 +++++++++++++
 docs/admin/index.md |  1 +
 2 files changed, 14 insertions(+)
 create mode 100644 docs/admin/adopt.md

diff --git a/docs/admin/adopt.md b/docs/admin/adopt.md
new file mode 100644
index 00000000..398bf719
--- /dev/null
+++ b/docs/admin/adopt.md
@@ -0,0 +1,13 @@
+---
+title: 'Adopt existing git directories'
+license: 'CC-BY-SA-4.0'
+---
+
+If directories containing bare git repositories exist in the
+`[repository].ROOT` hierarchy, they can be imported using the admin
+panel.
+
+- Make sure the directory names are lowercase.
+- `[repository].ROOT/{user,org}/{repo}.git` will become a project owned by the user or the org.
+- Go to `/admin/repos/unadopted`
+- In trusted environments, users can also be given similar permissions via the [`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`](../config-cheat-sheet/#repository-repository) setting.
diff --git a/docs/admin/index.md b/docs/admin/index.md
index 54fcd372..f0d0edff 100644
--- a/docs/admin/index.md
+++ b/docs/admin/index.md
@@ -20,3 +20,4 @@ These documents are targeted to people who run Forgejo on their machines.
 - [Recommended Settings and Tips](./recommendations/)
 - [GPG Commit Signatures](./signing/)
 - [Moderation tools](./moderation/)
+- [Adopt existing git directories](./adopt/)