Home  /  v25.2 Release notes

Release Compatibility

Materialize Operator

For self-managed deployments, Materialize provides the Materialize Operator. The Materialize Operator manages Materialize environments within your Kubernetes infrastructure.

Materialize provides the Materialize Operator Helm Chart, a Helm Chart for installing and upgrading the Materialize Operator. The chart repository is: https://materializeinc.github.io/materialize.

Releases and Compatibility

Materialize Operator orchestratord version environmentd version Release date Notes
v25.2.3 v0.147.4 v0.147.4 2025-07-15
v25.2.0 v0.147.0 v0.147.0 2025-06-24 Support for password authentication.
v25.1.12 v0.144.0 v0.130.13 2025-05-15
v25.1.11 v0.143.0 v0.130.12 2025-05-15
v25.1.10 v0.142.1 v0.130.11 2025-04-24

Terraform helpers

To help you get started, Materialize also provides some template Terraforms.

! Important:

These modules are intended for evaluation/demonstration purposes and for serving as a template when building your own production deployment. The modules should not be directly relied upon for production deployments: future releases of the modules will contain breaking changes. Instead, to use as a starting point for your own production deployment, either:

  • Fork the repo and pin to a specific version; or

  • Use the code as a reference when developing your own deployment.

Sample Module Description
terraform-helm-materialize A sample Terraform module for installing the Materialize Helm chart into a Kubernetes cluster.
Materialize on AWS A sample Terraform module for deploying Materialize on AWS Cloud Platform with all required infrastructure components. See Install on AWS for an example usage.
Materialize on Azure A sample Terraform module for deploying Materialize on Azure with all required infrastructure components. See Install on Azure for an example usage.
Materialize on Google Cloud Platform (GCP) A sample Terraform module for deploying Materialize on Google Cloud Platform (GCP) with all required infrastructure components. See Install on GCP for an example usage.
    Terraform version Notable changes
    v0.4.9
    • Uses terraform-helm-materialize v0.1.19.
    • Bumps Materialize release to self-managed 25.2
    • Adds support for password authentication and enabling RBAC
    v0.4.6

    • Adds support for passing in additional Materialize instance configuration options via environmentd_extra_args

      To use, set the instance’s environmentd_extra_env to an array of strings; for example:

      materialize_instances = [
  {
    ...
    environmentd_extra_args = [
      "--system-parameter-default=<param>=<value>",
      "--bootstrap-builtin-catalog-server-cluster-replica-size=50cc"
    ]
  }
]

    • Uses terraform-helm-materialize v0.1.15.
    v0.4.5
    • Defaults to using Materialize Operator v25.1.12 (via terraform-helm-materialize v0.1.14).
    v0.4.4
    • Defaults to using Materialize Operator v25.1.11 (via terraform-helm-materialize v0.1.13).

    If upgrading from a deployment that was set up using an earlier version of the Terraform modules, additional considerations may apply when using an updated Terraform modules to your existing deployments.

    See also Upgrade Notes for release-specific upgrade notes.

    Terraform version Notable changes
    v0.4.6
    • Uses terraform-helm-materialize v0.1.19.
    • Bumps Materialize release to self-managed 25.2
    • Adds support for password authentication and enabling RBAC
    v0.4.3

    • Adds support for passing in additional Materialize instance configuration options via environmentd_extra_args

      To use, set the instance’s environmentd_extra_env to an array of strings; for example:

      materialize_instances = [
  {
    ...
    environmentd_extra_args = [
      "--system-parameter-default=<param>=<value>",
      "--bootstrap-builtin-catalog-server-cluster-replica-size=50cc"
    ]
  }
]

    • Uses terraform-helm-materialize v0.1.15.
    v0.4.1
    • Defaults to using Materialize Operator v25.1.11 (via terraform-helm-materialize v0.1.13).

    If upgrading from a deployment that was set up using an earlier version of the Terraform modules, additional considerations may apply when using an updated Terraform modules to your existing deployments.

    See also Upgrade Notes for release specific notes.

    Terraform version Notable changes
    v0.4.6
    • Uses terraform-helm-materialize v0.1.19.
    • Bumps Materialize release to self-managed 25.2
    • Adds support for password authentication and enabling RBAC
    v0.4.3

    • Adds support for passing in additional Materialize instance configuration options via environmentd_extra_args

      To use, set the instance’s environmentd_extra_env to an array of strings; for example:

      materialize_instances = [
  {
    ...
    environmentd_extra_args = [
      "--system-parameter-default=<param>=<value>",
      "--bootstrap-builtin-catalog-server-cluster-replica-size=50cc"
    ]
  }
]

    • Uses terraform-helm-materialize v0.1.15.
    v0.4.1
    • Defaults to using Materialize Operator v25.1.11 (via terraform-helm-materialize v0.1.13).

    If upgrading from a deployment that was set up using an earlier version of the Terraform modules, additional considerations may apply when using an updated Terraform modules to your existing deployments.

    See also Upgrade Notes for release specific notes.

    terraform-helm-materialize Notes Release date
    v0.1.16
    • Adds support for passing in additional environmentd configuration options.
    • Adds support for password authentication.
    • Uses as default Materialize Operator version: v25.2.0
    • Uses as default environmentd version: v0.147.0
    		 2025-05-15
    v0.1.15
    • Adds support for passing in additional environmentd configuration options.
    • Uses as default Materialize Operator version: v25.1.12
    • Uses as default environmentd version: v0.130.13
    		 2025-05-15
    v0.1.14
    • Uses as default Materialize Operator version: v25.1.12
    • Uses as default environmentd version: v0.130.13
    		 2025-05-15
    v0.1.13
    • Uses as default Materialize Operator version: v25.1.11
    • Uses as default environmentd version: v0.130.12
    		 2025-05-15
    v0.1.12
    • Uses as default Materialize Operator version: v25.1.7
    • Uses as default environmentd version: v0.130.8
    		 2025-04-08
    Back to top ↑