jmcgettrick / sakai-docker

Dockerized version of Sakai for testing the Hypothesis LMS integration

sakai-docker

Docker container for the stable version of Sakai v19.

This is forked from hypothesis/sakai-docker.

Setup

First, run a Git submodule update to fetch/update the source code for Sakai.

git submodules update --init

To build the Docker image for Sakai and launch containers for Sakai and MySQL, run:

docker-compose up

The first time this command is run the Docker image for Sakai will be built, which can take 10 minutes or more. Additionally when the Sakai starts for the first time it will spend several minutes initializing.

Logging into Sakai

Once the Sakai container image has been built and the container is created, you can access Sakai by browsing to http://localhost:8080/portal.

The default admin user is admin and the password is admin.

Installing an LTI Tool

To test an LTI tool, you will need to:

1. Create a new "project site".
   • Click "Worksite Setup" in the left navbar
   • Click the "Create new site" tab
   • Select "Build your own site" => "project site"
   • Click "Continue".
2. Enter a title for the site and click "Continue".
3. On the "Site Tools" page, check the "External Tool" option and click Continue.
4. Click "Continue" on the Customize tool instances page
5. Click "Continue" on the Project Site Access page
6. Click "Create Site" on the confirmation page.
7. Select the new site in the list of sites. It should be displayed as active in the tabs at the top.
8. Click the "External Tool" link in the left navbar and then click "Edit" to configure it.
9. Enter the "Remote Tool URL", and "Remote Tool Key" and "Remote Tool Secret". Check "Send Email Addresses to the External Tool" and "Send Names to the External Tool" then click "Update Options".

Note that you can check "Debug Launch" which will give you the option to see the launch data before launching the tool.

Troubleshooting

If you have problems building or running the Docker container on macOS, you may need to increase the memory allowance for Docker Engine up from the default of 2GB to 3GB or more.

This can be done in the "Advanced" section of Docker for Mac's Preferences UI.

References

Quick Start from Source