Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Install Git. This will install the git  CLI command that you will use to create commits, switch branches, and push/pull branches.
  2. Open your terminal and run ssh-keygen -t ed25519 . Use  Use the defaults they provide, and make sure that there is no passphrase. You should just be pressing enter again and again. You should see a path matching something like C:\Users\<username>/.ssh/id_ed25519  or C:\Users\<username>/.ssh/id_rsa. Remember this, as you will use it in the next step .
  3. Run notepad C:\Users\<username>/.ssh/ssh_configconfig (should mostly match the path you saw above). It may ask you to create the file. If it does, answer yes.
  4. Copy and paste the following into the file:
    Code Block
    Host git.valor6800.com
    	Port 6822
    	IdentityFile ~/.ssh/<id_rsa or id_ed25519>
    If you want an explanation of this config, keep reading. Otherwise skip to step 5.
    There are two main protocols to configure a central server with Git: HTTPS and SSH. HTTPS uses a username and password, while SSH uses public/private keys. While HTTPS is easier to configure, it is considered less secure than SSH, and is disabled on the Valor GitLab. Valor's GitLab also uses a non-standard SSH port number (6822). You can sort of think of ports as a series of mailboxes on a computer, and for the central server to respond to Git, you need to send data to the right "mailbox" on the central server, which happens to be 6822 instead of the default SSH port number of 22. This is where the SSH config file comes into play. Since Git uses SSH under the hood, it reads this .ssh/config  file that says that when accessing the host git.valor6800.com , it should use the port 6822  and use the public/private key pair that you created with ssh-keygen
  5. Run cat ~/.ssh/<id_rsa or id_ed25519>ed25519.pub . Copy the output. Go to the Valor GitLab, sign in, then click on your icon in the top right of the left sidebar, then go to Preferences → SSH Keys → Add new key. Paste the text you copied and set the expiration to four years from now (just sometime after you graduate). Click Add Key .
  6. Verify that you can connect to GitLab with ssh -T git@git.valor6800.com . If it succeeded, you should see something along the lines of Welcome to GitLab, ...! 
  7. Go to an appropriate directory where you want to store your Valor code and clone the 2026 code with git clone --recursive git@git.valor6800.com:valor6800/2026/robot.git . The --recursive  flag tells Git to clone the submodules inside of the repository.

...