Help/gitea.md

# Gitea ssh setup
Gitea is a GitHub/GitLab clone written in Go.
- Maintainer:  Joseph T. Foley `foley`
- (Gitea Documentation)[https://docs.gitea.com/]

# Registering for an account

## Initial Registration
1. go to https://gitea.cs.ru.is
1. Click on "Register" on the top right
1. Registration information:
   1. Username:  the same as your RU username *(remove the @RU.IS)*
   1. Email Address:  your RU email
   1. Password:  *Choose something relatively long that you can remember and save it somewhere safe*
   1. Confirm the password by typing it again
   1. Click on "Register Account"
   If you use any email other than RU.IS, it will give you the error "You cannot register with your email address".  **External collaborators must be added manually by an administrator.**
   ![A new confirmation email has been sent to BLUR@ru.is. Please check your inbox within the next 3 hours to complete the registration process. If your registration email address is incorrect, you can sign in again and change it.](Graphics/gitea-activation.png)
## Email verification
1. Gitea will send you an email with a verification link within the next 5 minutes.  If you don't see it, check your spam
1. Look at the email and cut-and-paste the verification link into a browser.  **Check that it starts with `https://gitea.cs.ru.is` to make sure that it is not a Phishing attack**
1. Your email is now verified!
1. You can now click on "Sign In" on the top right to login with this username and password.

## Creating a repository
1. Look for the "Repositories" on the right side and a "+" symbol.  Click on it.  Some things to consider:
   - Owner:  Either yourself or an organization you are a member of
   - Repository Name:  something short with US alphabet, numbers, and dashes or underscores.  *Avoid accented and letters outside of the 26 a-z*
   - Visibility:  check this box to keep it private.  In general, make things private unless you are really sure you want search engines, AI LLM scrapers, and random people to look at it.
   - Issue Labels: Default (unless you are working on a project with a complicated management/approval process)
   - License:  Skip this if private.  If not, read the quick overview on licenses at https://choosealicense.com/