Failed to start redis. Got code: 0 Got error: Failed to connect to 10.73.0.251 port 457: Connection refused Installing the LMS app for Moodle Across an Installation - LTI 1.1 (Worldwide) : Hypothesis
  1. Home
  2. Knowledge Base
  3. Learning Management Systems
  4. Installing in the LMS
  5. Installing the LMS app for Moodle Across an Installation – LTI 1.1 (Worldwide)
  1. Home
  2. Knowledge Base
  3. Learning Management Systems
  4. Moodle
  5. Installing the LMS app for Moodle Across an Installation – LTI 1.1 (Worldwide)

Installing the LMS app for Moodle Across an Installation – LTI 1.1 (Worldwide)

This legacy guide is for installing the LTI 1.1 version of Hypothesis and is no longer current. For instructions on installing the LTI 1.3 / Advantage version of the Hypothesis LMS app please see this page.

This guide is for schools without specific data residency requirements. For compliance with Canadian data residency requirements please see the Canadian version of this guide.

Who is this guide for?

  • This guide is for Moodle administrators who want to install Hypothesis across their entire installation.
  • If you do not have administrator access and want to install Hypothesis in your course, please see our guide to installing Hypothesis in a Moodle course.
  • Are you having trouble getting Hypothesis installed in Moodle? Please contact us!

Before you install Hypothesis you may wish to review the LTI parameters we use. You can find them here.

1. Generate Hypothesis Credentials

These instructions assume that you have already spoken with a member of our Education Team and been provided with a link to the page where you can generate Hypothesis credentials.

If you have not yet received a link, please fill out this form and a someone from our Education Team will get in touch with you about the next steps.

In the form to generate credentials, fill out the following:

  • LMS Domain:
    • This is the basic web address instructors and students use to access your LMS (e.g., lms.yourschool.edu)
  • Email:
    • Can be any valid email address that belongs to you

Note: Ignore the two Canvas-specific fields. Those are relevant only for use in Canvas LMS.

Form presented for generating Hypothesis credentials

Click the Generate Credentials button.

You will be shown a screen that contains your new Hypothesis Consumer Key and Shared Secret.

Hypothesis LMS credentials

Don’t close this tab/window! You will need to copy and paste these credentials later in the install process.

2. Go to Site Administration

Location of Site Administration button

3. Go to Manage Tools

Select the Plugins tab, then locate and select Manage tool (found under Activity modules > External tool)

Location of Manage tools option

4. Choose “configure tool manually”
Location of

5. Fill out External Tool Configuration

Under Tool Setting enter the following:

  • Tool Name:
    • Hypothesis
  • Tool URL:
    • https://lms.hypothes.is/lti_launches
  • LTI version:
    • LTI 1.0/1.1
  • Consumer Key and Shared Secret:
    • Enter the credentials you generated in step 1
  • Default launch container:
    • New window. While not required, selecting “New window” will maximize the space given to the original text and annotation pane.

Moodle Tool Settings

Click Show more… and for Secure icon URL enter (optional, to display the Hypothesis icon):

  • https://d242fdlp0qlcia.cloudfront.net/uploads/brand/HypothesisBlackboardIcon.png

Location of

Expand the Privacy section and enter the following:

  • Share launcher’s name with tool:
    • Always
  • Check the box to Force SSL

Privacy configuration

Click the Save changes button when finished.

To create an assignment in Moodle using Hypothesis, see our guide Creating Hypothesis-enabled readings in Moodle.

Was this article helpful?

Related Articles