On this page:
- What is github.mit.edu?
- What's the difference between GitHub.com and GitHub Enterprise ?
- What documentation is available?
- Who can use it?
- Can non-MIT people get accounts?
- What is the address or URL of my repositories?
- Less Common issues
GitHub.com is a public site that allows people to create public repositories. You have to pay to create private repositories on GitHub.com.
GitHub Enterprise runs the same software as GitHub.com, but is hosted at MIT. You can sign in with your MIT account, your data is at MIT, and you can create private or public repositories as you desire.
This page will cover some common topics, particularly related to MIT's GitHub Enterprise service.
For topics not specific to MIT, general GitHub documentation is available at:
- General GitHub help: https://help.github.com/
- Getting started with Git and GitHub: https://help.github.com/categories/bootcamp/
- Topics specific to GitHub Enterprise: https://enterprise.github.com/help
All MIT faculty, students, and staff may use the service via http://github.mit.edu/ (requires Touchstone login).
Yes, you can collaborate with anyone that has a Touchstone collaboration account. These are available to users who do not have MIT certificates. When logging into github.mit.edu, those users can choose to login with a collaboration account (as opposed to an MIT kerberos account).
- What is a Touchstone Collaboration Account?
- Creating a Touchstone Collaboration Account
- Log in using a Touchstone Collaboration Account
- Github Accounts After Graduation or Leaving MIT
Github uses HTTPS or SSH.
The repository address for HTTPS will be of the pattern:
If you use HTTPS, be aware that the system does not know (or use) your MIT Kerberos password. You need to create an GitHub access token and use it as your password. See Creating an access token but be aware that you need to create the access token in your MIT GitHub account on github.mit.edu (and not on github.com).
The repository address for SSH will be of the pattern:
If you use SSH, you need to generate SSH keys and add them to your account. See Generating SSH keys, but be aware that steps 3 and 4 connect to the public GitHub.com site. You will want to adapt those steps, to connect to MIT's github.mit.edu site.
See GitHub's documentation at: https://developer.github.com/v3/enterprise/
API endpoints are prefixed with the MIT GitHub URL: https://github.mit.edu/api/v3/
- curl -u [OAuth_token]:x-oauth-basic -i https://github.mit.edu/api/v3/
- curl -H 'Authorization: token [OAuth_token]' -i https://github.mit.edu/api/v3/
See GitHub's instructions at: Using CAS with GitHub for Windows
- for step 5 (name the token):
- Give the token a descriptive name, so that a year from now you can still tell where you are using the token.
- Example of a good name: "GitHub for Windows on my Dell E7240 Laptop"
- Example of a bad name: "My Token".
- for step 8 (copy token to clipboard):
- When copying the token, make sure you copy only the numbers and not the space at the end. If you copy the space at the end, it won't work as a password in step 12. Paste the token into Notepad if you need to check it.
- for step 12 (enter login details):
- Your GitHub Enterprise username is your MIT Kerberos account username
- MIT's GitHub Enterprise URL is https://github.mit.edu/
- Create an access token
- Set up command-line "git", and configure it to Cache the access token as the password
- Get the GitHub for Mac program
- Launch GitHub for Mac. You can sign into the MIT GitHub Enterprise server during setup, or can use Preferences > Accounts to sign in later.
- MIT's GitHub Enterprise Login URL is https://github.mit.edu/
- You will not be able to enter a username or password.
- When you press the "Sign In" button you will be sent to a web page to sign in. After web page signin finishes, the web page will ask permission to send an access token back to the GitHub app on your Mac.
It's not quite clear why you need two access tokens (one for commandline and one for the app), but our tests did need both.
According to GitHub support, the GitHub Enterprise product does not support replying to issues and comments via email, although it's true that github.com does. The GitHub Enterprise product is currently only capable of sending email from the noreply@domain address, and users must visit the web interface to respond.
The most common cause of not receiving a notification is if an account is lacking an associated email address or if no address has been designated the "primary email address". To fix this, have the user go to their email settings page and enter a primary email address. Note that by default github.mit.edu does not attach an email address to your account - everyone starts with a blank primary email address.
App Delivery needs to have key stakeholders test Github Enterprise version updates in a test environment. MIT Github Upgrade Schedule
|Additional escalation information for Help Staff can be found here: [hd:GitHub Recon].|