aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJohn Olheiser2023-02-06 10:20:20 -0600
committerGitHub2023-02-06 10:20:20 -0600
commit189d5b7045b2200fa55c20707a39138cfb8cf0ed (patch)
treeccd8011c12dbeb025a9b8a97a0e228250894f28b /docs
parentf8c1e14a136c9702f459a36a1ea2e75fedd123af (diff)
Add repo adoption to FAQ (#22778)
This should be a simple set of steps to achieve repo adoption.
Diffstat (limited to 'docs')
-rw-r--r--docs/content/doc/help/faq.en-us.md11
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/content/doc/help/faq.en-us.md b/docs/content/doc/help/faq.en-us.md
index 2fcf0be15..c8327de7f 100644
--- a/docs/content/doc/help/faq.en-us.md
+++ b/docs/content/doc/help/faq.en-us.md
@@ -449,3 +449,14 @@ It is highly recommended to back-up your database before running these commands.
If you are using Cloudflare, turn off the auto-minify option in the dashboard.
`Speed` -> `Optimization` -> Uncheck `HTML` within the `Auto-Minify` settings.
+
+## How to adopt repositories from disk
+
+- Add your (bare) repositories to the correct spot for your configuration (`repository.ROOT`), ensuring they are in the correct layout `<REPO_ROOT>/[user]/[repo].git`.
+ - **Note:** the directory names must be lowercase.
+ - You can also check `<ROOT_URL>/admin/config` for the repository root path.
+- Ensure that the user/org exists that you want to adopt repositories for.
+- As an admin, go to `<ROOT_URL>/admin/repos/unadopted` and search.
+ - Users can also be given similar permissions via config [`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`]({{< relref "doc/advanced/config-cheat-sheet.en-us.md#repository" >}}).
+- If the above steps are done correctly, you should be able to select repositories to adopt.
+ - If no repositories are found, enable [debug logging]({{< relref "doc/advanced/config-cheat-sheet.en-us.md#repository" >}}) to check for any specific errors.