diff --git a/README.md b/README.md index 21ada2e..78a6e64 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,11 @@ For questions not clarified here, missing information or corrections consider op 2. [Manual](#manual-migration) 3. [Teams/Organizations vs Personal Repositories](#teamsorganizations-vs-personal-repositories) 4. [Actions](#actions) -5. [Extra Information](#extra-information) +5. [Git Credentials Helper](#git-credentials-helper) + 1. [Store](#credential-store) + 2. [OAuth](#credential-oauth) + 3. [Recommended](#recommended-setup) +6. [Extra Information](#extra-information) ## Permissions Gitea works on three permission levels: @@ -92,6 +96,28 @@ Similar to GitHub, Gitea implements an Actions system. It can be setup under the Currently only exists ONE runner for actions. As not many repositories use this mechanism, available images and support may need to be expanded in the future. +## Git Credentials Helper +Git can save credentials for remote server, but is not configured to do so by default on some systems. + +### Credential-Store +All git installations have this option. This saves the credentials in a plain text file. It is not the safest, but is the easiest. + + git config --global --add credential.helper store + + +### Credential-OAuth +Cross platform option that uses OAuth for authentication, instead of username and password (works for GitHub too). + + git config --global --add credential.helper oauth + +Check [Git-Credential-OAuth](https://github.com/hickford/git-credential-oauth) for information on how to install. + +### Recommended setup + + git config --global --unset-all credential.helper # Clear all helper options + git config --global --add credential.helper "cache --timeout 21600" # Saves on cache for 6 hours (not permanent) + git config --global --add credential.helper oauth # Use OAuth system (replace with store if oauth not available) + ## Extra information ### Administrators - Rui Barbosa (rfpba)