diff --git a/content/configuration/extensions.md b/content/configuration/extensions.md index 43ccbe99..f5e749d9 100644 --- a/content/configuration/extensions.md +++ b/content/configuration/extensions.md @@ -5,26 +5,27 @@ description: Configuration for extensions and the Directus Marketplace. :partial{content="config-env-vars"} -| Variable | Description | Default Value | -| -------------------------------------- | ------------------------------------------------------------------------------- | -------------- | -| `EXTENSIONS_PATH`[1] | Path to your local extensions directory. | `./extensions` | -| `EXTENSIONS_MUST_LOAD` | Exit the server when any API extension fails to load. | `false` | -| `EXTENSIONS_AUTO_RELOAD`[2], [3] | Automatically reload extensions when they have changed. | `false` | -| `EXTENSIONS_CACHE_TTL`[4] | How long custom app Extensions get cached by browsers. | | -| `EXTENSIONS_LOCATION`[5] | What configured storage location to use for extensions. | | -| `EXTENSIONS_LIMIT` | Maximum number of extensions you allow to be installed through the Marketplace. | | +| Variable | Description | Default Value | +| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -------------- | +| `EXTENSIONS_PATH`[1] | Path to your local extensions directory, or subdirectory within the configured storage location when `EXTENSIONS_LOCATION` is set. | `./extensions` | +| `EXTENSIONS_MUST_LOAD` | Exit the server when any API extension fails to load. | `false` | +| `EXTENSIONS_AUTO_RELOAD`[2], [3] | Automatically reload extensions when they have changed. | `false` | +| `EXTENSIONS_CACHE_TTL`[4] | How long custom app Extensions get cached by browsers. | | +| `EXTENSIONS_LOCATION`[5], [6] | Key of the configured [storage locations](/configuration/files) to load extensions from a specific storage location. | | +| `EXTENSIONS_LIMIT` | Maximum number of extensions you allow to be installed through the Marketplace. | | -[1] If `EXTENSIONS_LOCATION` is configured, this is the path to the extensions directory within the selected -storage location. +[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 `EXTENSION_LOCATION` environment variable is set. +[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 for how long [app extensions](/guides/extensions/app-extensions) are cached by browsers. By default, extensions are not cached. +[4] The `EXTENSIONS_CACHE_TTL` environment variable controls how long [app extensions](/guides/extensions/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 | Variable | Description | Default Value |