Configuration

Extensions

Configuration for extensions and the Directus Marketplace.
Environment Variables
Environment variables are configurable for Directus Enterprise Cloud projects via our Customer Success team. You can also set environment variables in self-hosted projects.
VariableDescriptionDefault Value
EXTENSIONS_PATH1Path 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_RELOAD2, 3Automatically reload extensions when they have changed.false
EXTENSIONS_CACHE_TTL4How long custom app Extensions get cached by browsers.
EXTENSIONS_LOCATION5, 6Key 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.

1 When EXTENSIONS_LOCATION is set, this defines the path inside the selected storage location where extensions reside.

2 EXTENSIONS_AUTO_RELOAD will not work when the EXTENSIONS_LOCATION environment variable is set.

3 EXTENSIONS_AUTO_RELOAD will likely not work on Windows machines without also setting the CHOKIDAR_USEPOLLING environment variable to true.

4 The EXTENSIONS_CACHE_TTL environment variable controls how long app extensions are cached by browsers. By default, extensions are not cached.

5 By default extensions are loaded from the local file system. EXTENSIONS_LOCATION can be used to load extensions from a storage location instead.

6 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
Sandbox
By default, the Directus Marketplace will allow installation of all App extension types and only API extension types that use our secure sandbox.

Get once-a-month release notes & real‑world code tips...no fluff. 🐰