Installing the LMS app for Sakai at the Institutional Level

Installing the LMS app for Sakai at the Institutional Level2020-12-09T12:37:08-08:00
  1. Home
  2. Help
  3. Tutorials and How-Tos
  4. Installing the LMS app for Sakai at the Institutional Level
  1. Home
  2. Help
  3. Learning Management Systems
  4. Sakai
  5. Installing the LMS app for Sakai at the Institutional Level

Who is this guide for?

  • This guide is for administrators who want to install Hypothesis organization-wide in Sakai.
  • If you are a Sakai user and do not have administrator access and want to install Hypothesis in a course, please see our Course-level installation guide.
  • Are you having trouble getting Hypothesis installed in Sakai? 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

Fill out our form to provide your contact information. We will send you an email that contains the information you need to create the Hypothesis credentials (key and secret) you will need during the installation process.

Generate a Hypothesis Key/Secret

Required fields

The LMS Domain is the basic web address you use to access your LMS (i.e.,

The Email field can be any valid email address that belongs to you.


Your credentials

After you fill out the form, click Generate Credentials. You will see a screen that looks like this:

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 your Admin Workspace > External Tools > Install LTI 1.x Tool

Sakai admin install tool page


3. Add the External Tool settings, including the key and secret

You will be using default settings, unless otherwise indicated.


Fill out the following information:

  • Tool Title: Hypothesis
  • Button Text: Hypothesis
  • Launch URL:
  • Launch Key and Launch Secret: acquired in Step 1
  • Privacy Settings: Check both boxes
  • Services: Check boxes for Allow External Tool to return grades, Provide Roster to External Tool, and Allow External Tool to store setting data


If you have an option that says Allow External Tool to create grade columns, check that off as well.

alternate sakai tool settings


The app needs access to the information granted in Privacy Settings and Services in order to create accounts and groups using the LMS roster.

Click Save.

The app will now be successfully installed for your course site. You may wish to consult our help article on Using the Hypothesis LMS App with Lessons in Sakai.

Related Articles

In order to support easy reuse, revision, remixing, and redistribution, the entire Hypothesis Help knowledge base by Hypothesis is dedicated to the public domain via CC CC0 1.0. While we appreciate attribution and links back to Hypothesis from anywhere these works are published, they are not required. Learn more about how we made the decision to put our guidance in the public domain and let us know how you are putting Hypothesis Help to good use.