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:

*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.

  1. Navigate to Install GitHub Learning Lab.
  2. Select your user name if you see a list of organizations. screenshot of github app installation with a choice of target
  3. Select All repositories.
  4. Click Install. screenshot of app installation on all repositories
  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. screenshot of github app installation with a choice of target
  4. Select Only select repositories.
  5. Choose the newly created repository. screenshot of the selected installation option
  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. screenshot of joining a course and installing the app
  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. screenshot of github app installation with a choice of target
  3. Select All repositories.
  4. Click Install. screenshot of app installation on all repositories
  5. Any organization member can now join a private course course in the organization without any extra installation steps.