From 7cf1ec48d3bc0a4a6f5e315f3db895b15bf51535 Mon Sep 17 00:00:00 2001 From: Rui Barbosa Date: Tue, 21 Apr 2026 21:09:11 +0000 Subject: [PATCH] Add information on how to save git credentials --- README.md | 28 +++++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) 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)