File Storage Methods
STORAGE LOCATION OF UPLOADED FILES: You may choose to store the files uploaded in REDCap in a local directory on your web server
or on a separate server.
Local (on REDCap web server)
External server using WebDAV (SSL supported)
Amazon S3 - see custom settings below
Google Cloud Storage (for Google App Engine hosting only)
Google Cloud Storage using API Service Account
Microsoft Azure Blob Storage - see custom settings below
If using a separate server for storage via WebDAV, you must set up the configuration in /webtools2/webdav/
NOTE: The 'Local' option may also include a directory on a separate server (e.g., NFS, NAS) that is mapped as a local directory on your REDCap web server.
Storage Configuration Settings
Local Server File Storage
SET LOCAL FILE STORAGE LOCATION: If using 'Local' storage option, you may set an alternative location for storage of uploaded files (otherwise it will default to 'edocs' folder). For security reasons, it is recommended that you set this to a folder that is not accessible over the web.
If blank, then the following default path is used: /var/www/webresearch_id/public_html/redcap/edocs/
Example: /var/www/webresearch_id/public_html/redcap/my_file_repository/
Amazon S3
AMAZON S3 STORAGE SETTINGS: If using 'Amazon S3' as your storage option, set the values for your AWS access key, secret key,
and the name of the 'bucket' where all REDCap files should be stored in S3.
AWS Access Key:
Bucket:
AWS Region / Location Constraint:
This must be the Region/Location Constraint (e.g., ap-northeast-2) and NOT the Endpoint URL. If left blank, then
us-east-1 will be used by default. For the list of AWS regions/location constraints, see the following:
S3 Regions
Google Cloud Storage (for Google App Engine hosting only)
GOOGLE CLOUD STORAGE SETTINGS: If REDCap is hosted on Google Cloud Platform, you must use the Google Cloud Storage
option for storing files. Provide the names of two buckets in GCS (one to serve as a temporary file storage, and the other for
permanent storage of REDCap files).
Bucket for storing REDCap files:
Bucket for storing temporary files (must be different than bucket above):
Google Cloud Storage using API Service Account
GOOGLE CLOUD STORAGE API SETTINGS: If using 'Google Cloud Storage' as your storage option, set the values for your account ID, secret key, and the name of the 'bucket' where all REDCap files should be stored.
Setup Instructions
Google Cloud Platform project ID
Bucket name
Organize the stored files by REDCap project ID?
Disabled
Enabled
Microsoft Azure Blob Storage
AZURE BLOB STORAGE SETTINGS: If using 'Microsoft Azure Blob Storage' as your storage option,
set the values for your storage account name, storage account key,
and the name of the 'container' where all REDCap files should be stored in Azure Blob Storage.
Setup Instructions
Setup Instructions:
1) Log in to Azure at https://portal.azure.com/
2) Go to 'Storage Accounts' on the left-hand menu, and create a new storage account (this 'name' will be your 'Azure storage account name' in REDCap).
3) Under that storage account, click the 'Access keys' option on the menu, and copy the first 'Key' value (this will be your 'Azure storage account key').
4) Under that storage account, click the 'Overview' option on the menu, and then under 'Services' click 'Blobs'.
Then click '+Container' to create a new container (this will be your 'Azure storage container').
Azure storage account name:
Azure storage blob container:
Configuration Options for Various Types of Stored Files
File Repository
ENABLE FILE UPLOADING FOR THE FILE REPOSITORY MODULE: Allows users to upload files into the File Repository.
Disabled
Enabled
If disabled, all data export files will still be stored in the File Repository. This setting only affects the ability for
users to manually upload files to that location.
File Repository upload max file size
If blank, then uses server default (2 MB)
'File Upload' Fields
ENABLE 'FILE UPLOAD' FIELD TYPES: Enable document uploading for individual project records on forms/surveys?
Disabled
Enabled
If disabled, this choice will not appear as an available field type for users to utilize. Any 'File Upload' fields already
created before being disabled will no longer be functional when viewed on forms/surveys.
Upload max file size for 'file' field types on forms/surveys
If blank, then uses server default (2 MB)
Send-It
ENABLE SEND-IT: Enable the 'Send-It' application, which allows users to upload and send non-project files, as well as to send files uploaded into a
project's File Repository or data entry pages (via 'File Upload' field types)?
Disabled
Enabled for all locations
Enabled only for REDCap home page
Enabled only for project file repository and forms
All files uploaded for Send-It will be deleted from the server at the time of expiration.
Send-It upload max file size
If blank, then uses server default (2 MB)
File Attachments (General)
Upload max file size for general file attachments.
(Includes the following: attachments for Descriptive fields, attachments uploaded for Data Resolution Workflow)
If blank, then uses server default (2 MB)
Allow file attachments to be uploaded for data queries in the Data Resolution Workflow?
Disabled
Enabled
If disabled, this will not appear as an available option for users to utilize for an open data query in DRW.