...
- Install Git. This will install the
git
CLI command that you will use to create commits, switch branches, and push/pull branches. - 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 likeC:\Users\<username>/.ssh/id_ed25519
orC:\Users\<username>/.ssh/id_rsa
. Remember this, as you will use it in the next step . - 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. - Copy and paste the following into the file:
If you want an explanation of this config, keep reading. Otherwise skip to step 5.Code Block Host git.valor6800.com Port 6822 IdentityFile ~/.ssh/<id_rsa or id_ed25519>
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 hostgit.valor6800.com
, it should use the port6822
and use the public/private key pair that you created withssh-keygen
. - 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). ClickAdd Key
. - Verify that you can connect to GitLab with
ssh -T git@git.valor6800.com
. If it succeeded, you should see something along the lines ofWelcome to GitLab, ...!
- 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.
...