You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
1. In the NGINX One Console, go to **Manage > Config Sync Groups**, then select your group.
8
+
9
+
If you haven't created a Config Sync Group yet, see [Manage Config Sync Groups]({{< ref "/nginx-one/nginx-configs/config-sync-groups/manage-config-sync-groups.md" >}}) for setup instructions.
10
+
2. Select the **Configuration** tab, then choose **Edit Configuration**.
11
+
3. Select **Add File**, then choose **New Configuration File**.
12
+
4. In the **File name** field, enter:
13
+
- On Linux: `/etc/nginx/license.jwt`
14
+
- On FreeBSD: `/usr/local/etc/nginx/license.jwt`
15
+
The name must be exact.
16
+
5. Paste the contents of your JWT license file into the editor.
17
+
6. Select **Next** to preview the diff, then **Save and Publish** to apply the update.
Copy file name to clipboardExpand all lines: content/solutions/about-subscription-licenses.md
+41-10Lines changed: 41 additions & 10 deletions
Original file line number
Diff line number
Diff line change
@@ -14,18 +14,18 @@ We’re updating NGINX Plus to align with F5’s entitlement and visibility poli
14
14
15
15
Starting with NGINX Plus R33, all **NGINX Plus instances require a valid JSON Web Token (JWT) license**. This license is tied to your subscription (not individual instances) and is used to validate your subscription and automatically send usage reports to F5's licensing endpoint (`product.connect.nginx.com`), as required by your subscription agreement. In offline environments, usage reporting is [routed through NGINX Instance Manager]({{< ref "nim/disconnected/report-usage-disconnected-deployment.md" >}}).
16
16
17
+
## Important changes
18
+
17
19
If you have multiple subscriptions, you’ll also have multiple JWT licenses. You can assign each NGINX Plus instance to the license you prefer. NGINX combines usage reporting across all licensed instances.
18
20
19
21
This feature is available in NGINX Instance Manager 2.20 and later.
20
22
21
-
### Important changes
22
-
23
-
##### NGINX Plus won't start if:
23
+
### NGINX Plus won't start if:
24
24
25
25
- The JWT license is missing or invalid.
26
26
- The JWT license expired over 90 days ago.
27
27
28
-
#####NGINX Plus will **stop processing traffic** if:
28
+
### NGINX Plus will **stop processing traffic** if:
29
29
30
30
- It can't submit an initial usage report to F5's licensing endpoint or NGINX Instance Manager.
31
31
@@ -45,17 +45,48 @@ When installing or upgrading to NGINX Plus R33 or later, take the following step
45
45
46
46
---
47
47
48
-
## Add the JWT license {#add-jwt}
48
+
## Download the license from MyF5 {#download-jwt}
49
49
50
-
Before you install or upgrade to NGINX Plus R33 or later, make sure to:
50
+
{{< include "licensing-and-reporting/download-jwt-from-myf5.md" >}}
51
51
52
-
### Download the license from MyF5 {#download-jwt}
52
+
---
53
53
54
-
{{< include "licensing-and-reporting/download-jwt-from-myf5.md" >}}
54
+
## Deploy the JWT license
55
+
56
+
After you download the JWT license, you can deploy it to your NGINX Plus instances using either of the following methods:
57
+
58
+
- Use a **Config Sync Group** if you're managing instances with the NGINX One Console (recommended)
59
+
- Copy the license manually to each instance
60
+
61
+
Each method ensures your NGINX Plus instances have access to the required license file.
62
+
63
+
### Deploy with a Config Sync Group (Recommended)
64
+
65
+
If you're using the [NGINX One Console]({{< ref "/nginx-one/getting-started.md" >}}), the easiest way to manage your JWT license is with a [Config Sync Group]({{< ref "/nginx-one/nginx-configs/config-sync-groups/manage-config-sync-groups.md" >}}). This method lets you:
66
+
67
+
- Avoid manual file copying
68
+
- Keep your fleet consistent
69
+
- Automatically apply updates to new NGINX Plus instances
70
+
71
+
To deploy the JWT license with a Config Sync Group:
72
+
73
+
{{< include "/licensing-and-reporting/deploy-jwt-with-csgs.md" >}}
74
+
75
+
Your JWT license now syncs to all NGINX Plus instances in the group.
76
+
77
+
When your subscription renews and a new JWT license is issued, update the file in the Config Sync Group to apply the change across your fleet.
78
+
79
+
New instances added to the group automatically inherit the license.
If you're using NGINX Instance Manager instead of the NGINX One Console, the equivalent feature is called an *instance group*. You can manage your JWT license in the same way by adding or updating the file in the instance group. For details, see [Manage instance groups]({{< ref "/nim/nginx-instances/manage-instance-groups.md" >}}).
83
+
{{< /call-out >}}
84
+
85
+
### Copy the license manually
55
86
56
-
### Copy the license to each NGINX Plus instance
87
+
If you're not using NGINX One, copy the JWT license file to each NGINX Plus instance manually.
57
88
58
-
{{< include "licensing-and-reporting/apply-jwt.md" >}}
89
+
{{< include "/licensing-and-reporting/apply-jwt.md" >}}
0 commit comments