rt/wrolpi-help
1
0
Fork 0
mirror of https://github.com/wrolpi/wrolpi-help.git synced 2026-10-25 18:40:11 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

Repos: importing an existing clone

Browse source 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Roland 2026-10-06 18:09:53 -06:00
parent 66a20f0ef9
commit ad99de72ff
No known key found for this signature in database
GPG key ID: 1BA620CE6C9A4680
1 changed files with 20 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

20
docs/modules/repos/index.md
View file

@ -31,6 +31,26 @@ that branch.
If two repos have the same name (e.g. two repos named `utils` from different owners), WROLPi asks you to choose another
name, such as `owner-utils`.
## Importing an Existing Clone
If you already have a git clone in your media directory, WROLPi can take it over instead of downloading it again.
> To import a clone, click **Repos** in the navigation bar, click **Import**, then choose the clone's directory.
WROLPi shows the clone's origin, branch and latest commit, and where it will be moved. Then:
* The clone is **moved** into the Repos Directory (so its files are no longer indexed).
* Its URL must be the clone's origin. An SSH origin like `git@github.com:owner/repo.git` is converted to its
`https://` URL; if the clone has no origin, enter its URL.
* Like a new repo, it follows the remote's default branch unless you enter a Branch.
**Warning!** An imported clone becomes a mirror. Its first update discards local changes, untracked files, and any
commits that are not on the remote. WROLPi warns you if it has commits which are not on the remote; push them
first if you want to keep them.
WROLPi only updates clones it downloaded or imported. If a repo's directory already holds a different git clone, the
repo's download fails and explains that it must be imported.
## Modes
| Mode | What is saved | Size |