Guide Git Repository Account - Generate a New SSH Key

[- Alex Thunderhunter - 32]

GGU Git Repository Account - Generate a New SSH Key
This post is continuously being updated as methods/information changes, this can happen without any warning. Last update 1/22/25. Last Bot Update 1/22/25.

These are the instructions for generating a new SSH key, adding the newly generated SSH key to the ssh-agent and adding the ssh key to your GGU Git Repository Account. If you have any questions, please use #helpdesk on our discord server. 

Generating a New SSH Key

You can generate a new SSH key on your local machine. After you generate the key, you can add the public key to your account on git.gguclan.com to enable authentication for Git operations over SSH.

Windows:

Windows

1. Install and open Git Bash (https://git-scm.com/downloads - Select Windows)
2. Paste the text below, replacing the email used in the example with your GGU Git Repository email address. 

   ssh-keygen -t ed25519 -C "[email protected]"

   This creates a new SSH key, using the provided email as a label.
   When you're prompted to "Enter a file in which to save the key", you can press Enter to accept the default file location. Please note that if you created SSH keys previously, ssh-keygen may ask you to rewrite another key, in which case we recommend creating a custom-named SSH key. To do so, type the default file location and replace id_ALGORITHM with your custom key name (ssh_keyname). IF YOU ENTER A CUSTOM KEY NAME, CHECK "C:\Users\YOU\ssh_keyname". 

   > Enter file in which to save the key (/c/Users/YOU/.ssh/id_ALGORITHM or ssh_keyname):[Press enter]

3. At the prompt, type a secure passphrase.

   > Enter passphrase (empty for no passphrase*): [Type a passphrase]
   > Enter same passphrase again: [Type passphrase again]
   *Passphrase is required for the GGU Git Repository

4. You should see this in the console if you did everything correctly:

   Your identification has been saved in ssh_keyname
   Your public key has been saved in ssh_keyname.pub
   The key fingerprint is:
   SHA256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
   The key's randomart image is:
   +--[ED25519 256]--+
   |                 |
   |                 |
   |                 |
   |                 |
   |                 |
   |                 |
   |                 |
   |                 |
   |                 |
   +----[SHA256]-----+

Adding your SSH key to the ssh-agent

Before adding a new SSH key to the ssh-agent to manage your keys, you should have checked for existing SSH keys and generated a new SSH key.

Windows:

Windows

1. In a new admin elevated PowerShell window, ensure the ssh-agent is running. You can start it manually by using the command:

   # start the ssh-agent in the background
   Get-Service -Name ssh-agent | Set-Service -StartupType Manual
   Start-Service ssh-agent

2. In a terminal window without elevated permissions, add your SSH private key to the ssh-agent. If you created your key with a different name, or if you are adding an existing key that has a different name, replace ssh_keyname in the command with the name of your private key file (no file extension).

   ssh-add C:\Users\YOU\.ssh\ssh_keyname

3. Add the SSH public key to your account on GGU Git Repository. For more information, see GGU Git Repository Account - Add a New SSH Key to your account.