FileStore and File Uploads¶
CKAN allows users to upload files directly to file storage either on the local file system or to online ‘cloud’ storage like Amazon S3 or Google Storage. The uploaded files will be stored in the configured location.
Setup the FileStore with Local File Storage¶
To setup CKAN’s FileStore with local file storage:
Create the directory where CKAN will store uploaded files:
sudo mkdir -p /var/lib/ckan/default
Add the following lines to your CKAN config file, after the [app:main] line:
ofs.impl = pairtree ofs.storage_dir = /var/lib/ckan/default
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
Make sure you’ve set ckan.site_url in your config file.
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 = ....
## 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.
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.