Back to Directus

Extensions

content/configuration/extensions.md

latest3.4 KB
Original Source

:partial{content="config-env-vars"}

VariableDescriptionDefault Value
EXTENSIONS_PATH<sup>[1]</sup>Path to your local extensions directory, or subdirectory within the configured storage location when EXTENSIONS_LOCATION is set../extensions
EXTENSIONS_MUST_LOADExit the server when any API extension fails to load.false
EXTENSIONS_AUTO_RELOAD<sup>[2], [3]</sup>Automatically reload extensions when they have changed.false
EXTENSIONS_CACHE_TTL<sup>[4]</sup>How long custom app Extensions get cached by browsers.
EXTENSIONS_LOCATION<sup>[5], [6]</sup>Key of the configured storage locations to load extensions from a specific storage location.
EXTENSIONS_LIMITMaximum number of extensions you allow to be installed through the Marketplace.
EXTENSIONS_ROLLDOWNEnable use of Rolldown to optimize extensions bundling.false

<sup>[1]</sup> When EXTENSIONS_LOCATION is set, this defines the path inside the selected storage location where extensions reside.

<sup>[2]</sup> EXTENSIONS_AUTO_RELOAD will not work when the EXTENSIONS_LOCATION environment variable is set.

<sup>[3]</sup> EXTENSIONS_AUTO_RELOAD will likely not work on Windows machines without also setting the CHOKIDAR_USEPOLLING environment variable to true.

<sup>[4]</sup> The EXTENSIONS_CACHE_TTL environment variable controls how long app extensions are cached by browsers. By default, extensions are not cached.

<sup>[5]</sup> By default extensions are loaded from the local file system. EXTENSIONS_LOCATION can be used to load extensions from a storage location instead.

<sup>[6]</sup> The value of EXTENSIONS_LOCATION must correspond to a key defined in your STORAGE_LOCATIONS environment variable.

Marketplace

VariableDescriptionDefault Value
MARKETPLACE_TRUSTOne of sandbox, allsandbox
MARKETPLACE_REGISTRYThe registry to use for the Directus Marketplace.https://registry.directus.io

::callout{icon="material-symbols:info-outline"} Sandbox
By default, the Directus Marketplace will allow installation of all App extension types and only API extension types that use our secure sandbox. ::