Files
Help/ssh/gitea-ssh-setup.md
T

29 lines
2.0 KiB
Markdown

# 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)