Configuration¶
Flask-FS expose both global and by storage settings.
Global configuration¶
FS_ROOT¶
default: {app.instance_path}/fs
The global local storage root. Each storage will have its own root as a subdirectory unless not local or overridden by configuration.
FS_URL¶
default: None
An optionnal URL on which the FS_ROOT is visible (ex: 'https://static.mydomain.com/'
).
FS_BACKEND¶
default: 'local'
The default backend used for storages.
Can be one of local
, s3
, gridfs
or swift
Storages configuration¶
Each storage configuration can be overriden from the application configuration. The configuration is loaded in the following order:
{STORAGE_NAME}_FS_{KEY}
(specific configuration)FS_{KEY}
(global configuration)- default value
Given a storage declared like this:
import flask_fs as fs
avatars = fs.Storage('avatars', fs.IMAGES)
You can override its root with the following configuration:
AVATARS_FS_ROOT = '/somewhere/on/the/filesystem'