Installing Learning Lab

GitHub Learning Lab requires you to authorize and install it.

Installing Learning Lab on a repository allows it to monitor events that occur in that repository and gives it the ability to administer that repository for the purposes of taking or authoring a course.

A Learning Lab app can be installed:

• on your personal account*
• on select repositories
• on an organization

*For simplicity, we recommend installing Learning Lab on your personal account. This will ensure that you don't have to reinstall the app every time you join a course.

Installing on a personal account (recommended)

1. Navigate to Install GitHub Learning Lab.
2. Select your user name if you see a list of organizations.
3. Select All repositories.
4. Click Install.
5. Join your preferred course without any extra installation steps.

Installing on select repositories

1. Create a repository you'll use to install the app for the first time, if you don't already have one. The repository can be empty and it won't be used for anything beyond installation.
2. Navigate to Install GitHub Learning Lab.
3. Select your user name if you see a list of organizations.
4. Select Only select repositories.
5. Choose the newly created repository.
6. Click Install.

Each time you want to join a course while using selected installation:

1. Join your preferred course. Learning Lab will create your repository for the newly joined course.
2. Click on Install Learning Lab on your new course repository.
3. On the new window, you'll see the newly created repository was suggested. Click Approve and install
4. Close the new window and return to Learning Lab. Click Done installing? Move on >.
5. Start the course.

Installing on an organization

You'll need to install Learning Lab on an organization if you are authoring courses on behalf of the organization, or if you'd like all members of an organization to take private courses owned by that organization.

1. Navigate to Install GitHub Learning Lab.
2. Select the organization from the list of organizations.
3. Select All repositories.
4. Click Install.
5. Any organization member can now join a private course course in the organization without any extra installation steps.