Accessing GitHub for research
This document explains how to sign up to use GitHub.com for research and teaching. For further information see:
First, users should create a personal account, using a ucl.ac.uk email address. You should use a .ac.uk or .edu email address, so that you will be able to sign up for free repositories for research.
Visit github.com, and fill in your details. Have a look at GitHub's documentation if you need help. You should also read the details about how UCL Research Software Development can support you in your use of GitHub.
If you are a PI or leading a research group or consortium, or are acting on behalf of one, you have the option to create an organisation account for your research group. (Alternatively, you can just use the main UCL organisation: see below.)
- You should choose the free "open source" tier for now - we will show you how to get free private repositories for your organisation later in the article.
- For the "billing email", you should just enter any .ac.uk email address to which you have access.
You may wish to add additional users to the "admin" team for your organisation on this page, by carefully entering their GitHub usernames.
- Only include colleagues who need full admin access to the account; we will show you how to give other colleagues limited access later.
- We recommend you include the user rc-softdev-admin at this point. You do not have to do this, but if you do, it will help us to support you in your use of GitHub.
If you need only open-source repositories, you can stop here. The remainder of the instructions need be followed only if you need password-protected repositories which only designated users can access.
You should now proceed to https://education.github.com/discount_requests/new to tell GitHub your organisation will be used for Research.
On the first page:
- Select Researcher
- Choose Organisation account.
On the second page:
- Choose the organisation account you created above
- Select Research Group.
On the third page:
- Enter the URL of the website of your research group, project or consortium.
- Choose 20 private repositories, the maximum number allowed for an organisation account.
Answer No to the question "Is any part of your work done on a commercial/for-profit basis?".
- If the answer to this question is yes, you will need to use UCL's paid central account for any work which does not meet this criterion. Please see below for details.
- In the research funding box, enter "UK and European Research Councils" or similar, as appropriate to your research.
In the final page,
- Ensure your ucl.ac.uk email address is shown in the drop down,
- Ensure the "School Name" is shown as University College London, University of London.
- Finally, for "How do you plan to use GitHub in your research group?" you should enter "Management of researcher-written code for research data analysis, modelling and simulation," or a similar statement appropriate to your work.
Submit the form.
You should receive confirmation from GitHub within a couple of days that you have been granted a free Silver plan, allowing 20 private repositories. Once this is received, you should proceed to create your first private repository, and add your research collaborators to your team.
Please forward this email to email@example.com, so that we can keep track of UCL groups' success in receiving private repositories.
If you are unsuccessful, please get in touch with us at the above address, so that we can provide you with access to UCL's central paid account.
If you are an individual student who is not part of a research team, you should not create an organisation, but simply request 5 private repositories for your personal account.
If the repository is for teaching purposes, you should enter "classroom" rather than "research" on step 2.
If you wish to carry out your work as part of the central UCL organisation, email firstname.lastname@example.org, and we will then create a team for you within UCL’s central organisation, allowing you to create your private repositories.
You should expect this to be complete within two working days.
Your email should specify:
- Your name,
- Your github username,
- Your UCL user ID,
- A team name for your group, (no spaces)
- Name and Github username of one or more team maintainers.
- A repository name for your first project.
Requests should come from UCL academic staff: research staff and research students should request that their PI or supervisor apply on their behalf, or forward to us confirmation that the PI has read and accepts these terms and conditions.