The settings for the server are configured in the file numbasltiprovider/

The script creates this file on installation. You might want to change settings if you have a nonstandard environment, or after upgrading.

The Numbas LTI provider is a Django app, so many of the settings come from Django. See the Django documentation for information on these.

This page describes the available settings which are unique to the Numbas LTI provider.


The name of this instance of the LTI provider. You could use the name of your institution, or the name of the learning environment.

This is shown in the footer of each page.


A list of LTI role names which grant the user ‘instructor’ status if they’re present.

See the role vocabularies in the LTI spec.


The name of your support contact. This will be shown to students in case of errors.


A URL to direct students to when there is an error. This could be a web address, a mailto: URI, or None if you don’t want to display a link.


If this is True, then the Email attempt receipts to students on completion? option will be available for each resource. Note that receipts are only sent for attempts at resources where the option is turned on by the instructor.

If this is False, then no completion receipts will be sent for any resource.

The Numbas LTI provider uses Django’s email system to send email through the SMTP protocol. See the Django documentation on sending email for information about configuring this. The relevant settings are EMAIL_HOST, EMAIL_PORT, EMAIL_USER and EMAIL_PASSWORD.


The number of seconds to wait when making an HTTP request to another service before giving up.

The following actions involve making HTTP requests to other services:

  • Reporting scores back to the LTI consumer.

  • Fetching updated exam packages from the Numbas editor

  • Updating editor links.


The number of days after which report files should be deleted.


The address of the documentation for the LTI tool.

If this is not set, then the default of<version> is used.