FileStore and File Uploads¶

Setup the FileStore with Local File Storage¶

To setup CKAN’s FileStore with local file storage:

1. Create the directory where CKAN will store uploaded files:

   sudo mkdir -p /var/lib/ckan/default
   

2. Add the following lines to your CKAN config file, after the [app:main] line:

   ofs.impl = pairtree
   ofs.storage_dir = /var/lib/ckan/default
   

3. Set the permissions of the storage_dir. For example if you’re running CKAN with Apache, then Apache’s user (www-data on Ubuntu) must have read, write and execute permissions for the storage_dir:

   sudo chown www-data /var/lib/ckan/default
   sudo chmod u+rwx /var/lib/ckan/default
   

4. Make sure you’ve set ckan.site_url in your config file.

5. Restart your web server, for example to restart Apache:

   sudo service apache2 reload
   

Setup the FileStore with Cloud Storage¶

Important: you must install boto library for cloud storage to function:

pip install boto

In your config for google:

## OFS configuration
ofs.impl = google
ofs.gs_access_key_id = GOOG....
ofs.gs_secret_access_key = ....

For S3:

## OFS configuration
ofs.impl = s3
ofs.aws_access_key_id = ....
ofs.aws_secret_access_key = ....

FileStore Web Interface¶

Upload of files to storage is integrated directly into the the Dataset creation and editing system with files being associated to Resources.

FileStore API¶

The FileStore API is CKAN’s API for uploading files to the FileStore.

DataStore Integration¶

It is also possible to have uploaded files (if of a suitable format) stored in the DataStore which will then provides an API to the data. See DataStorer: Automatically Add Data to the DataStore for more details.