File system repository configuration

Revision as of 21:36, 7 December 2010 by Helen Foster (talk | contribs) (removing update template because the page is fine as it is ;-))

Jump to: navigation, search

Note: You are currently viewing documentation for Moodle 1.9. Up-to-date documentation for the latest stable version is available here: File system repository configuration.

How to use the filesystem as a repository

This module allows you to share any of the sub-directories found in $CFG->dataroot/repository as a browseable repository inside Moodle.

It needs to be configured by a system administrator, because it requires write access to the system disk.

1. Create some folders to be repositories

Inside your "Moodledata" directory (the one where all your data is stored), create one called "repository".

Inside that, make one folder for each repository you want to create. Short, simple, one-word names are best, I'm going to use "clipart" as my example.

Inside your "clipart" folder put your files (in this example it could be hundreds of useful images that you got from

Note that these directories can be ANYTHING your operating system supports. You could mount a whole hard drive there, or mount a shared Windows network drive via SAMBA. You could have a symbolic link to a directory that allows FTP access. The sky is the limit here for a creative Moodle admin!!

2. Enable the File System repository plugin

You do this in the Settings block, under Site Administration > Plugins > Repositories > Manage repositories.

Once enabled, click on the "Settings" link beside it.

3. (Optional) Set up the personal repositories

You can safely ignore the settings at the top. These are for rare cases where you want to allow users to create their own virtual repositories from the filesystem, either for themselves or a course.

4. Create some actual usable repositories (instances)

  1. Click on "Add a repository instance".
  2. Give it a name. This is how it will appear in the filepicker interface in the list on the left.
  3. Choose the appropriate subdirectory from the list.

5. Check permissions

Although permissions should be on by default, you may have to check the roles and make sure that the "Authenticated User" role (or some other role, if you have set up a special one) has the "repository/filesystem:view" capability allowed.

(If you are using 2.0 Preview 1 then this was not on by default)

6. Use it!

Everything should be working. If you try to add a file in Moodle, then the File Picker should show you your new file system repository, and you should be able to browse it and select files to use.

Note that file types are respected (based on file extensions), so if you are adding an image in the editor, then you won't see Office docs (for example) appear in the File Picker.


See also