From 548636bf14b654d31c904abd96622704d73d4a5f Mon Sep 17 00:00:00 2001 From: David Stockton <7375241+dstockton@users.noreply.github.com> Date: Wed, 29 Jul 2026 00:24:34 +0100 Subject: [PATCH] docs: document EXTENSIONS_SYNC_MAX_CONCURRENCY --- content/configuration/extensions.md | 27 +++++++++++++++------------ 1 file changed, 15 insertions(+), 12 deletions(-) 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"}