diff --git a/content/configuration/extensions.md b/content/configuration/extensions.md index ca07d399..e7f82426 100644 --- a/content/configuration/extensions.md +++ b/content/configuration/extensions.md @@ -10,15 +10,16 @@ description: Configuration for extensions and the Directus Marketplace. For guidance on restricting who can install or manage extensions, see [Security Best Practices](/guides/security/best-practices#extensions). :: -| 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. | | -| `EXTENSIONS_ROLLDOWN` | Enable use of [Rolldown](https://rolldown.rs/) to optimize extensions bundling. | `false` | +| 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. | | +| `EXTENSIONS_ROLLDOWN` | Enable use of [Rolldown](https://rolldown.rs/) to optimize extensions bundling. | `false` | +| `EXTENSIONS_SYNC_MAX_CONCURRENCY`[7] | Maximum number of concurrent downloads when syncing extensions from the configured storage location. | `20` | [1] When `EXTENSIONS_LOCATION` is set, this defines the path inside the selected storage location where extensions reside. @@ -32,11 +33,13 @@ For guidance on restricting who can install or manage extensions, see [Security [6] The value of `EXTENSIONS_LOCATION` must correspond to a key defined in your `STORAGE_LOCATIONS` environment variable. +[7] `EXTENSIONS_SYNC_MAX_CONCURRENCY` only applies when `EXTENSIONS_LOCATION` is set, as extensions are then downloaded from the storage location on startup. + ## Marketplace -| Variable | Description | Default Value | -| ---------------------- | ------------------------------------------------- | ------------------------------ | -| `MARKETPLACE_TRUST` | One of `sandbox`, `all` | `sandbox` | +| Variable | Description | Default Value | +| ---------------------- | ------------------------------------------------- | ------------------------------- | +| `MARKETPLACE_TRUST` | One of `sandbox`, `all` | `sandbox` | | `MARKETPLACE_REGISTRY` | The registry to use for the Directus Marketplace. | `https://registry.directus.com` | ::callout{icon="i-lucide-info"}