--- title: "Repository settings" slug: "repository-settings" tags: ["Reference", "Site Administrator", "Totara Platform"] updated: 2026-08-13T16:01:02Z published: 2026-08-13T16:01:02Z canonical: "totara.help/repository-settings" --- > ## Documentation Index > Fetch the complete documentation index at: https://totara.help/llms.txt > Use this file to discover all available pages before exploring further. # Repository settings Each [repository type](/totara-20/docs/available-repositories) has configurable settings associated with it. These include both settings frequently found across repositories and unique settings only found for certain types. ## Frequent settings | **Setting** | **Description** | **Notes** | | --- | --- | --- | | Repository plugin name | You can give the repository a different name if you prefer or leave it blank to use the default name. | All repository types. | | Client ID | With an external repository it is likely you will require a client ID which is obtained from that service's developer portal when you set up Totara there. | Many external repository types. | | Client secret | With an external repository it is likely you will require a client secret (or password) which is obtained from that service's developer portal when you set up Totara there. | Many external repository types. | | Key | Rather than an ID and secret sometimes an external repository will require a key (this could be an API key or a license key). The key can normally be obtained from the external services developer portal. | Many external repository types e.g. Merlot, Flickr public, YouTube. | ## Recent files | **Setting** | **Description** | **Notes** | | --- | --- | --- | | Repository plugin name | You can give the repository a different name if you prefer or leave it blank to use the default name. | - | | Number of recent files | Set the number of recent files you want to display. By default this is 50 files. | - | ## Dropbox See the [Dropbox repository page](/totara-20/docs/set-up-the-dropbox-repository) for setup instructions. | **Setting** | **Description** | **Notes** | | --- | --- | --- | | Dropbox API key | You can get your API Key from the [Dropbox developers](http://www.dropbox.com/developers/apps) portal. When setting up your key please select **Full Dropbox** as the **Access level**. | - | | Dropbox secret | You can get your secret from the [Dropbox developers](http://www.dropbox.com/developers/apps) portal whilst setting up your API key. | - | | OAuth 2 redirect URI | This is preset and will be something like **https://yoursitename.com/admin/oauth2callback.php** | - | | Cache limit | Enter the maximum size of files (in bytes) to be cached on server for Dropbox aliases/shortcuts. Cached files will be served when the source is no longer available. Empty value or zero mean caching of all files regardless of size. | - | ## EQUELLA When setting up the EQUELLA repository on the site the following settings are available. | **Setting** | **Description** | **Notes** | | --- | --- | --- | | Allow users to add a repository instance into the course | Allows you to add an EQUELLA repository on a course. | - | | Allow users to add a repository instance into the user context | Allows you to add an EQUELLA repository to a specific user. | - | ## File system There is a lot of setup required to use the file system repository. Please see the [Set up a File Transfer Protocol (file system repository)](/totara-20/docs/set-up-a-file-transfer-protocol-file-system-repository) page for more information. | **Setting** | **Description** | **Notes** | | --- | --- | --- | | Allow admins to add a file system repository instance to a course (configurable only by admins) | Allows a Site Administrator to add a File system repository to a course. | - | | Allow admins to add a file system repository instance for personal use (configurable only by admins) | Allows a Site Administrator to add a File system repository to a user. | - | ## Amazon S3 | **Setting** | **Description** | **Notes** | | --- | --- | --- | | Repository plugin name | You can give the repository a different name if you prefer or leave it blank to use the default name. | - | | Access key | Enter the access key obtained from the Amazon S3 developer portal. | - | | Secret key | Enter the secret key obtained from the Amazon S3 developer portal. | - | | Amazon S3 endpoint | Configure the endpoint URL. | - | ## WebDAV | **Setting** | **Description** | **Notes** | | --- | --- | --- | | Allow users to add a repository instance into the course | Allows you to add a WebDAV repository to a course. | - | | Allow users to add a repository instance into the user context | Allows you to add a WebDAV repository to a specific user. | - | ## Next steps - [Configure an individual repository](/totara-20/docs/configure-an-individual-repository) - [Configure site-wide repository settings](/totara-20/docs/configure-site-wide-repository-settings) - [Add an EQUELLA user repository](/totara-20/docs/add-an-equella-user-repository) - [Add an EQUELLA course repository](/totara-20/docs/add-an-equella-course-repository) - [Add a WebDAV user repository](/totara-20/docs/add-a-webdav-user-repository) - [Add a WebDAV course repository](/totara-20/docs/add-a-webdav-course-repository) - [Set up the Dropbox repository](/totara-20/docs/set-up-the-dropbox-repository) - [Configure Google repository](/totara-20/docs/configure-google-repository) Join the [Totara Community](https://totara.community/) for more resources to help you get the most out of Totara. © Copyright 2025 Totara Learning Solutions. All rights reserved. Some content originally obtained via [GPLv3 license](https://www.gnu.org/licenses/licenses.html#GPL) and continues to be available under GPLv3. All other content is the sole copyright of Totara Learning Solutions.