Welcome to GitHub at Syracuse University!

Syracuse University offers GitHub to its active students, faculty, and staff, empowering them to boost collaboration, communication, and documentation while coding and working on projects.

What to Expect

Once your IT Team enables GitHub access:

1. An email will be sent to your Syracuse University mailbox. (usually within 60 minutes)
2. Follow the instructions in the email to link your existing personal GitHub account with your Syracuse University identity by completing the sign-in process.
3. After successful sign-in, you will be brought to your account's "Dashboard".  You can access the Syracuse University organization by using the "View organization" button or by navigating to: Syracuse University (github.com)

Creating a Personal GitHub Account with Your syr.edu Email

If you do not have a personal GitHub account to link with your Syracuse University identity, follow the instructions below:

1. Navigate to GitHub and select "Sign Up" near the top right-hand corner of the page.

2. Enter your syr.edu email address.

3. Create a password. 

   1. Best practice is to have a different password than your Syracuse University NetID.

4. Create a username. 

5. Solve the captcha and create your account.

6. After creating your account, multifactor will need to be enabled - navigate to the GitHub Passkey Setup for YubiKey and follow the instructions that suit your needs best.

   1. For most, instructions under "Setup 2FA for GitHub Using Microsoft Authenticator App" will be the best option.

7. Once a personal account is created, the steps in the "What to Expect" section can be used to link your personal account to your Syracuse University identity.

Gaining Access to GitHub Teams

Repository permissions are managed via GitHub Teams, which are advised to be created as "available for request." To request access to a Team:

1. Navigate to the Syracuse University Organization.
2. Select the "Teams" tab from the row of available options near the top of the page.
3. Search for the Team you would like to be a member of.
4. Select the Team, and click the "Request to join" button to send an access request to the Team admin.
   
5. An admin will now be able to review your request to join and will approve or deny based on their discretion.

Setting a Custom Routing for Notifications

Notifications can be configured on a per repository, team, or enterprise basis. It is advised to enable a custom routing so that all notifications for repositories, teams, or mentions under the Enterprise will be routed to your @syr.edu email address. notifications. To configure a custom routing:

1. Navigate to your GitHub Settings Notification page.
2. Select the "Custom routing" option.
3. Select the "Add new route" option.
4. You will be given the option to pick an organization choose the Syracuse University, then select your @syr.edu email address.
5. Now all notifications for repositories, teams, or mentions under the Syracuse University enterprise will be routed to your @syr.edu email address.

Additional GitHub Information

Related Links:

1. GitHub Passkey Setup for YubiKey
2. Using GitHub as an IT Team
3. Administrative Use Cases
4. Academic Use Cases