add license key information to installation instructions

doy-materialize · doy-materialize · commit 5b922de75571 · 2025-10-31T16:39:32.000-04:00
diff --git a/doc/user/content/installation/install-on-aws/_index.md b/doc/user/content/installation/install-on-aws/_index.md
@@ -59,6 +59,10 @@ for details.
 If you do not have Helm 3.2.0+, install. For details, see the [Helm
 documentation](https://helm.sh/docs/intro/install/).
 
+### License key
+
+To run Materialize in Kubernetes, a license key is required. To request a license key for Materialize Community Edition, visit [https://materialize.com/get-started/].
+
 ## Set up AWS Kubernetes environment and install Materialize
 
 {{< warning >}}
@@ -278,6 +282,7 @@ components:
          cpu_request    = "1"
          memory_request = "2Gi"
          memory_limit   = "2Gi"
+         license_key    = ""
        }
    ]
    EOF
diff --git a/doc/user/content/installation/install-on-aws/upgrade-on-aws.md b/doc/user/content/installation/install-on-aws/upgrade-on-aws.md
@@ -73,6 +73,10 @@ for details.
 If you do not have Helm 3.2.0+, install. For details, see the [Helm
 documentation](https://helm.sh/docs/intro/install/).
 
+### License key
+
+To run Materialize in Kubernetes, a license key is required. To request a license key for Materialize Community Edition, visit [https://materialize.com/get-started/].
+
 ## Procedure
 
 1. Open a Terminal window.
diff --git a/doc/user/content/installation/install-on-azure/_index.md b/doc/user/content/installation/install-on-azure/_index.md
@@ -65,6 +65,10 @@ the [Helm documentation](https://helm.sh/docs/intro/install/).
 Terraform outputs. Alternatively, you can manually specify the name and region.
 If you want to use `jq` and do not have `jq` installed, install.
 
+### License key
+
+To run Materialize in Kubernetes, a license key is required. To request a license key for Materialize Community Edition, visit [https://materialize.com/get-started/].
+
 ## A. Authenticate with Azure
 
 1. Open a Terminal window.
@@ -331,6 +335,7 @@ deploys a sample infrastructure on Azure with the following components:
          cpu_request    = "1"
          memory_request = "2Gi"
          memory_limit   = "2Gi"
+         license_key    = ""
        }
    ]
    EOF
diff --git a/doc/user/content/installation/install-on-azure/upgrade-on-azure.md b/doc/user/content/installation/install-on-azure/upgrade-on-azure.md
@@ -84,6 +84,10 @@ the [Helm documentation](https://helm.sh/docs/intro/install/).
 Terraform outputs. Alternatively, you can manually specify the name and region.
 If you want to use `jq` and do not have `jq` installed, install.
 
+### License key
+
+To run Materialize in Kubernetes, a license key is required. To request a license key for Materialize Community Edition, visit [https://materialize.com/get-started/].
+
 ## A. Authenticate with Azure
 
 1. Open a Terminal window.
diff --git a/doc/user/content/installation/install-on-gcp/_index.md b/doc/user/content/installation/install-on-gcp/_index.md
@@ -91,6 +91,10 @@ If you do not have Helm version 3.2.0+ installed, install.  For details, see the
 Terraform outputs. Alternatively, you can manually specify the name and region.
 If you want to use `jq` and do not have `jq` installed, install.
 
+### License key
+
+To run Materialize in Kubernetes, a license key is required. To request a license key for Materialize Community Edition, visit [https://materialize.com/get-started/].
+
 ## A. Configure GCP project and service account
 
 1. Open a Terminal window.
@@ -400,6 +404,7 @@ components:
          cpu_request    = "1"
          memory_request = "2Gi"
          memory_limit   = "2Gi"
+         license_key    = ""
        }
    ]
    EOF
diff --git a/doc/user/content/installation/install-on-gcp/upgrade-on-gcp.md b/doc/user/content/installation/install-on-gcp/upgrade-on-gcp.md
@@ -102,6 +102,10 @@ If you do not have Helm version 3.2.0+ installed, install.  For details, see the
 Terraform outputs. Alternatively, you can manually specify the name and region.
 If you want to use `jq` and do not have `jq` installed, install.
 
+### License key
+
+To run Materialize in Kubernetes, a license key is required. To request a license key for Materialize Community Edition, visit [https://materialize.com/get-started/].
+
 ## Procedure
 
 ### A. Setup GCP service account and authenticate
diff --git a/doc/user/content/installation/install-on-local-kind/_index.md b/doc/user/content/installation/install-on-local-kind/_index.md
@@ -59,6 +59,10 @@ documentationq](https://kubernetes.io/docs/tasks/tools/).
 For help with `kubectl` commands, see [kubectl Quick
 reference](https://kubernetes.io/docs/reference/kubectl/quick-reference/).
 
+### License key
+
+To run Materialize in Kubernetes, a license key is required. To request a license key for Materialize Community Edition, visit [https://materialize.com/get-started/].
+
 ## Installation
 
 1. Start Docker if it is not already running.
@@ -104,6 +108,8 @@ reference](https://kubernetes.io/docs/reference/kubectl/quick-reference/).
 
    {{% self-managed/versions/curl-sample-files-local-install %}}
 
+1. Edit `sample-materialize.yaml` to add your license key to the `license_key` field in the backend secret.
+
 1. Install the Materialize Helm chart.
 
    1. Add the Materialize Helm chart repository.
diff --git a/doc/user/content/installation/install-on-local-kind/upgrade-on-local-kind.md b/doc/user/content/installation/install-on-local-kind/upgrade-on-local-kind.md
@@ -38,6 +38,10 @@ documentationq](https://kubernetes.io/docs/tasks/tools/).
 For help with `kubectl` commands, see [kubectl Quick
 reference](https://kubernetes.io/docs/reference/kubectl/quick-reference/).
 
+### License key
+
+To run Materialize in Kubernetes, a license key is required. To request a license key for Materialize Community Edition, visit [https://materialize.com/get-started/].
+
 ## Upgrade
 
 {{< important >}}
diff --git a/doc/user/content/installation/install-on-local-minikube/_index.md b/doc/user/content/installation/install-on-local-minikube/_index.md
@@ -63,6 +63,10 @@ This tutorial uses `kubectl`. To install, refer to the [`kubectl` documentationq
 For help with `kubectl` commands, see [kubectl Quick
 reference](https://kubernetes.io/docs/reference/kubectl/quick-reference/).
 
+### License key
+
+To run Materialize in Kubernetes, a license key is required. To request a license key for Materialize Community Edition, visit [https://materialize.com/get-started/].
+
 ## Installation
 
 1. Start Docker if it is not already running.
@@ -107,6 +111,8 @@ reference](https://kubernetes.io/docs/reference/kubectl/quick-reference/).
 
    {{% self-managed/versions/curl-sample-files-local-install %}}
 
+1. Edit `sample-materialize.yaml` to add your license key to the `license_key` field in the backend secret.
+
 1. Install the Materialize Helm chart.
 
    1. Add the Materialize Helm chart repository.
diff --git a/doc/user/content/installation/install-on-local-minikube/upgrade-on-local-minikube.md b/doc/user/content/installation/install-on-local-minikube/upgrade-on-local-minikube.md
@@ -36,6 +36,10 @@ This tutorial uses `kubectl`. To install, refer to the [`kubectl` documentationq
 For help with `kubectl` commands, see [kubectl Quick
 reference](https://kubernetes.io/docs/reference/kubectl/quick-reference/).
 
+### License key
+
+To run Materialize in Kubernetes, a license key is required. To request a license key for Materialize Community Edition, visit [https://materialize.com/get-started/].
+
 ## Upgrade
 
 
diff --git a/doc/user/layouts/shortcodes/self-managed/versions/upgrade/upgrade-steps-cloud.html b/doc/user/layouts/shortcodes/self-managed/versions/upgrade/upgrade-steps-cloud.html
@@ -82,6 +82,7 @@
    | `environmentd_version`  | New Materialize instance version.|
    | `request_rollout`  or `force_rollout` | A new UUID string.  Can be generated with `uuidgen`.<br> <ul><li>`request_rollout` triggers a rollout only if changes exist. </li><li>`force_rollout`  triggers a rollout even if no changes exist.</li></ul> |
    | `inPlaceRollout` | Set to `false` to perform a rolling upgrade. For rolling upgrades, ensure you have enough resources to support having both the old and new Materialize instances running during the upgrade. |
+   | `license_key` | Set to the value of your license key. |
 
    For example, the following instance specifies:
 
@@ -100,6 +101,7 @@
          memory_request = "2Gi"
          memory_limit   = "2Gi"
          create_database = false
+         license_key    = "[...]"
          environmentd_version = "{{ $environmentd_version }}"
          inPlaceRollout: false                                   # When false, performs a rolling upgrade rather than in-place
          requestRollout: 22222222-2222-2222-2222-222222222222    # Enter a new UUID
diff --git a/doc/user/layouts/shortcodes/self-managed/versions/upgrade/upgrade-steps-local-kind.html b/doc/user/layouts/shortcodes/self-managed/versions/upgrade/upgrade-steps-local-kind.html
@@ -50,6 +50,13 @@
    kubectl -n materialize describe pod -l app.kubernetes.io/name=materialize-operator
    ```
 
+1. As of Materialize version 25.3, a license key is required to run in
+   Kubernetes. To configure a license key in an existing installation, run:
+
+   ```bash
+   kubectl -n materialize-environment patch secret materialize-backend -p '{"stringData":{"license_key":"<your license key goes here>"}}' --type=merge
+   ```
+
 1. Create a new `upgrade-materialize.yaml` file with the following content:
 
    | Field | Description |
diff --git a/doc/user/layouts/shortcodes/self-managed/versions/upgrade/upgrade-steps-local-minikube.html b/doc/user/layouts/shortcodes/self-managed/versions/upgrade/upgrade-steps-local-minikube.html
@@ -51,6 +51,13 @@
    kubectl -n materialize describe pod -l app.kubernetes.io/name=materialize-operator
    ```
 
+1. As of Materialize version 25.3, a license key is required to run in
+   Kubernetes. To configure a license key in an existing installation, run:
+
+   ```bash
+   kubectl -n materialize-environment patch secret materialize-backend -p '{"stringData":{"license_key":"<your license key goes here>"}}' --type=merge
+   ```
+
 1. Create a new `upgrade-materialize.yaml` file with the following content:
 
    | Field | Description |
diff --git a/misc/helm-charts/testing/materialize.yaml b/misc/helm-charts/testing/materialize.yaml
@@ -21,6 +21,7 @@ metadata:
 stringData:
   metadata_backend_url: "postgres://materialize_user:materialize_pass@postgres.materialize.svc.cluster.local:5432/materialize_db?sslmode=disable"
   persist_backend_url: "s3://minio:minio123@bucket/12345678-1234-1234-1234-123456789012?endpoint=http%3A%2F%2Fminio.materialize.svc.cluster.local%3A9000&region=minio"
+  license_key: ""
 ---
 apiVersion: materialize.cloud/v1alpha1
 kind: Materialize
