Working With GitHub.com

If you don’t already have a GitHub.com user account, you can create an account here:

https://github.com/join

To request access to the Imperial College London organisation on GitHub, please follow the instructions on this knowledge article. Once you’ve completed the steps on the knowledge article, you’ll be a member of the organisation and can access the resources within there. 

Once your membership of the Imperial College organisation is confirmed:

1. From your GitHub dashboard click the plus symbol (+) in the top right corner and select New repository.

2. Make sure the owner is ‘ImperialCollegeLondon’, enter a new repository name and select any other options you require, as shown below:

3. Click the green ‘Create repository’ button and your new repository will be created.

Once you have created a new repository it is advisable to create a Team within GitHub.com to allow you to grant access permissions to other users. If those users are part of the College already, you will be able to add them using the method below. If you want to invite users external to the College, please log a job with the ICT Service Desk providing the exact Github user name and we can invite them on your behalf.

To create a Team:

1. Sign in to GitHub.com and open your Imperial College London repository page in GitHub.com (eg https://github.com/ImperialCollege/cmtest1)
2. Click the Settings tab  and select the ‘Collaborators & teams’ option
3. Click the ‘Create new team’ button  and complete the details for the new team:



Enter the details for your team and then click the green ‘Create team’ button.
4. Once your new team has been created you can add any number of internal team members as long as they are part of the College. If you wish to add an external user, please log a request with the Service Desk providing the exact Github user name. 

5. Click into the ‘Add a person’ box to add new team members. You can type the required GitHub user account(s) and you will be shown a list of matching users.  Select the user you require to add them to your team.

By default, Team Members will have Read access to the chosen repository, this can be changed by clicking the ‘Read’ button and choosing the required option for the drop-down list:

Teams can be added to any number of repositories using this method.

1. Instructions for transferring a repository can be found on the GitHub website on the About repository transfers page and on the Transferring a repository page.

      If you are working remotely you will need to be connected to the Imperial College VPN when you do this.  See instructions for setting up a VPN connection.

   2. Make sure you transfer your repository to the ‘imperialcollegelondon’ organisation or to one of your own organisations which is already covered by the College GitHub license facilities

Alternative method of applying for the Imperial College GitHub license discount

Providing you, as the GitHub.com Organisation owner, have an Imperial College ‘@imperial.ac.uk’ email address registered against your Github.com User profile then you can apply to GitHub for a discount for your organisation(s) at:

https://education.github.com/discount_requests/new

You will be asked to choose which email address on your GitHub account you will be applying with. Applying with a profile which has a College mail address will have the College license applied to that organisation and the fees will be waived.  The College email address on the your GitHub.com profile must be an ‘@imperial.ac.uk’ address and not an ‘@ic.ac.uk’ address however it does not need to be the primary email address.