# Gitea ssh setup
This guide assumes you have registered and verified your account with an @RU.IS email address.  If you have not setup your account yet, you must do that first.
The gitea server at RU is on port 2222.  *It does not respond on the usual port 22*

- [Gitea Documentation](https://docs.gitea.com/)

# Installing ssh keys into Gitea
1. If you don't have an ssh key, generate one now following the guide on the (main ssh page)[index.md]
1. Login to gitea.cs.ru.is
1. Click on your user Icon on the top right and choose "Settings" in the dropdown
1. On the Left, click on "SSH / GPG Keys"
   ![menu of SSH / GPG Keys](Graphics/gitea-ssh-nokeys.png)
1. copy the contents of `~/.ssh/id_ed25519.pub` into the text box and click "Add Key".  *On windows you can view it in Notepad to cut and paste it*.
   ![SSH key pasted into the text field](Graphics/gitea-ssh-pubkey-paste.png)
1. It will then want you to verify the key by running a `ssh-keygen`.  You will need to tell it where your public key is, typically `~/.ssh/id_ed25519.pub.  **This process must be done quickly as the tokens expire!!!**
    1. First look at the validation information given.  This guide assumes you are on linux of some sort, but there are directions for Windows also listed
   ![verification prompt, empty](Graphics/gitea-ssh-signingtoken.png)
    2. Open a command shell (if you weren't already) and run the ssh-keygen command to sign the token with your key
   ![shell prompt running sshkeygen](Graphics/gitea-ssh-sshkeygen-sign.png)
    2. Paste the results into the "Armored SSH signature" area
   ![verification prompt, full](Graphics/gitea-ssh-signingtoken-filled.png)
    2. Click "Verify"
1. If validation is done quickly and with the right key, you will see confirmation
   ![Successful validation box](Graphics/gitea-ssh-verified.png)

# Testing
If you have ssh setup properly with gitea, you should be able to test it this way:
![ssh test result using git user: success](Graphics/gitea-cmdline-test-success.png)