Installation
View as MarkdownYou can install Self-Managed Materialize on a Kubernetes cluster running locally or on a cloud provider. Self-Managed Materialize requires:
- A Kubernetes (v1.31+) cluster.
- PostgreSQL as a metadata database.
- Blob storage.
- A license key.
License key
Starting in v26.0, Materialize requires a license key.
| License key type | Deployment type | Action |
|---|---|---|
| Community | New deployments |
To get a license key:
|
| Community | Existing deployments | Contact Materialize support. |
| Enterprise | New deployments | Visit https://materialize.com/self-managed/enterprise-license/ to purchase an Enterprise license. |
| Enterprise | Existing deployments | Contact Materialize support. |
Installation guides
The following installation guides are available to help you get started:
Install using Helm Commands
| Guide | Description |
|---|---|
| Install locally on Kind | Uses standard Helm commands to deploy Materialize to a Kind cluster in Docker. |
Install using Terraform Modules
We recommend pinning your module sources to specific tags to avoid unexpected breaking changes in future versions.
We recommend updating your module source tags when updating Materialize versions, taking care to follow any instructions in the release notes.
| Guide | Description |
|---|---|
| Install on AWS | Uses Terraform module to deploy Materialize to AWS Elastic Kubernetes Service (EKS). |
| Install on Azure | Uses Terraform module to deploy Materialize to Azure Kubernetes Service (AKS). |
| Install on GCP | Uses Terraform module to deploy Materialize to Google Kubernetes Engine (GKE). |
Install using Legacy Terraform Modules
We recommend pinning your module sources to specific tags to avoid unexpected breaking changes in future versions.
We recommend updating your module source tags when updating Materialize versions, taking care to follow any instructions in the release notes.
| Guide | Description |
|---|---|
| Install on AWS (Legacy Terraform) | Uses legacy Terraform module to deploy Materialize to AWS Elastic Kubernetes Service (EKS). |
| Install on Azure (Legacy Terraform) | Uses legacy Terraform module to deploy Materialize to Azure Kubernetes Service (AKS). |
| Install on GCP (Legacy Terraform) | Uses legacy Terraform module to deploy Materialize to Google Kubernetes Engine (GKE). |