GitLab Version Control System

A version control system such as Git might be of use to you for maintaining, sharing or collaborating on program code, LaTeX, text files, etc.

The department has a self-service GitLab server where you can easily upload your own repositories.

You can share repositories with other department members, as long as they have signed into GitLab at least once. If you would like an external collaborator to have access to your repository, please contact IT Support, providing their full name and email address.

The default limits are 10 projects per user, 1 GB per project, and 10 MB per individual file. Please contact IT Support if you need to request an increase to any of these. Note that large generated/binary files are generally not suitable for storing in Git.

Cloning a Repository

We recommend using SSH to clone/push/pull repositories:

• Create an SSH key on your local machine
• Find your public key - e.g. run cat .ssh/id_*.pub - and copy it to the clipboard
• Add it to GitLab
  • Go to Edit profile > SSH keys
  • Click "Add new key"
  • Paste your public key into the "Key" field
  • The "Title" will be filled in automatically, but you can edit it if needed
  • Optionally change/remove the default Expiration date, if needed
  • Click "Add key"
• Use the "Clone with SSH" URL to clone the repository - e.g.
  git clone git@git.maths.ox.ac.uk:USERNAME/REPONAME.git

Please note: Cloning over HTTPS using your Maths account password is no longer supported. To update an existing copy of a repository to use SSH instead of HTTPS, you can run git remote set-url origin git@git.maths.ox.ac.uk:USERNAME/REPONAME.git.