From 9093dbd56949818d32cfe53ddb5790961c4c5528 Mon Sep 17 00:00:00 2001 From: Antonio Djigo <31393623+djigoio@users.noreply.github.com> Date: Tue, 23 Jun 2026 17:54:11 +0100 Subject: [PATCH 1/2] Document network requirements for licensing Added network requirements for licensing and endpoints. --- content/licensing/1.overview.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/content/licensing/1.overview.md b/content/licensing/1.overview.md index 3f4d8ec7..e290f492 100644 --- a/content/licensing/1.overview.md +++ b/content/licensing/1.overview.md @@ -80,6 +80,26 @@ If no license is configured, the instance runs on the core tier. See the [General configuration](/configuration/general#license) reference for the full `LICENSE_KEY` and `LICENSE_TOKEN` environment variable details. +## Network Requirements + +In online mode, Directus makes outbound HTTPS requests to `https://licensing.directus.com`. If your network restricts outbound traffic, allow the following endpoints: + +| Method | Endpoint | Purpose | +| --- | --- | --- | +| `GET` | `/.well-known/jwks.json` | Token signature verification | +| `POST` | `/api/licenses/preview` | License preview before activation | +| `POST` | `/api/licenses/activate` | Initial license activation | +| `POST` | `/api/licenses/refresh` | Periodic license revalidation | +| `POST` | `/api/licenses/update` | Plan or addon changes | +| `POST` | `/api/licenses/deactivate` | License deactivation | +| `POST` | `/api/licenses/portal` | Opening the Stripe billing portal | +| `GET` | `/api/licenses/addons/options` | Fetching available addon options | +| `PATCH` | `/api/licenses/addons` | Purchasing or modifying addons | +| `DELETE` | `/api/licenses/addons` | Removing addons | + +If outbound access to `https://licensing.directus.com` is not possible, use an [offline license token](#offline-mode) instead. Offline tokens are validated locally and require no outbound network access. Offline mode is only available on Enterprise plans. + + ## License Statuses | Status | Meaning | From f43a660c15bca2c530d44cfb7c39f894be9adb37 Mon Sep 17 00:00:00 2001 From: Antonio Djigo <31393623+djigoio@users.noreply.github.com> Date: Wed, 24 Jun 2026 09:22:54 +0100 Subject: [PATCH 2/2] Update network requirements and licensing notes Clarified network requirements for Directus licensing, recommending endpoint allowances for restricted networks and noting potential future changes to the endpoint list. --- content/licensing/1.overview.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/content/licensing/1.overview.md b/content/licensing/1.overview.md index e290f492..9a6ccf49 100644 --- a/content/licensing/1.overview.md +++ b/content/licensing/1.overview.md @@ -82,7 +82,7 @@ See the [General configuration](/configuration/general#license) reference for th ## Network Requirements -In online mode, Directus makes outbound HTTPS requests to `https://licensing.directus.com`. If your network restricts outbound traffic, allow the following endpoints: +In online mode, Directus makes outbound HTTPS requests to `https://licensing.directus.com`. We recommend If your network restricts outbound traffic, allow the following endpoints: | Method | Endpoint | Purpose | | --- | --- | --- | @@ -97,6 +97,8 @@ In online mode, Directus makes outbound HTTPS requests to `https://licensing.dir | `PATCH` | `/api/licenses/addons` | Purchasing or modifying addons | | `DELETE` | `/api/licenses/addons` | Removing addons | +**Notice**: These endpoints are subject to future change and the list may be modified or be extended in the future. + If outbound access to `https://licensing.directus.com` is not possible, use an [offline license token](#offline-mode) instead. Offline tokens are validated locally and require no outbound network access. Offline mode is only available on Enterprise plans.