General GitHub Enterprise Information
GitHub Enterprise is a collaborative tool for managing, reviewing, and sharing code. At it's core, GitHub is a repository for files and projects that are being managed with Git, a command-line version control system.
In addition to managing code, GitHub Enterprise is capable of tracking changes made to many different filetypes including Word documents, SVG files, and more.
GitHub Enterprise Features:
- Track and manage changes to code and other files
- Track issues and bugs
- Unlimited private repositories
- Manage multiple projects, organizations, & teams
Who has access to GitHub Enterprise?
Faculty and students
Log in using your Swarthmore username and password at https://github.swarthmore.edu.
TriCo Students, Strath Haven Students, and other students enrolled in courses at Swarthmore
All students taking classes at Swarthmore receive a Swarthmore username and password that can be used to log into Swarthmore's GitHub Enterprise. After registering for a course, non-Swarthmore students receive an email with their username and instructions on how to set up their password.
Only users with Swarthmore network accounts may access GitHub Enterprise. If you're working on a project with collaborators who are outside of the College, consider creating an account at the public GitHub.com, or contact a member of Academic Technologies to discuss additional options. Educators and Academic Researchers can receive free unlimited private repositories at GitHub.com. See Applying for an academic research discount for more details.
GitHub Desktop Client
Although GitHub Enterprise is accessible via the web at https://github.swarthmore.edu, you may wish to use the Desktop application for Windows or Mac (it is recommended to use Git's version of the application rather than the native OS X version).
Using the Mac OSX GitHub Desktop Client
- Open the GitHub application on your computer
- In the Applications folder or search for it with magnifying glass on the top right of the screen
- Skip option to update application (if prompted)
- Connect to GitHub Enterprise:
- Enter https://github.swarthmore.edu
- Leave username and password blank
- Click "Sign in"
- Web browser opens -- sign in with Swarthmore username and password
- Authorize GitHub for your account (large green button)
- Return to the GitHub application
- Click Continue
- Verify name and email
Using the Windows GitHub Desktop Client
In order to work with the College's authentication service, the Windows client requires that users generate an authorization token.To do so, follow these instructions:
- Sign in to your GitHub Enterprise instance.
- Navigate to your user profile page. For example, you would go to . USERNAME/settings/profile
- In the user settings sidebar, click Applications.
- Find and click the Generate new token button.
- Give your token a descriptive name.
- Select the scopes you wish to grant to this token. The default scopes allow you to interact with public and private repositories, user data, and gists.
- Click Generate token.
- Copy the token to your clipboard. For security reasons, after you navigate away from this page, no one will be able to see the token again.
- Launch GitHub for Windows.
- In the upper-right corner, click the gear icon, then click Options....
- Click Add GitHub Enterprise Account.
- Type your GitHub username and GitHub Enterprise URL. In the password field, paste the OAuth token you copied earlier.
- Click Log in.
GitHub from the Command Line / Terminal
In order to push commits to your GitHub repositories from the command line or terminal, you'll need to first set up an SSH key. Please follow the instructions linked below.