Download and run Materialize Emulator

The Materialize Emulator is an all-in-one Docker image available on Docker Hub for testing and evaluation purposes. The Materialize Emulator is not representative of Materialize’s performance and full feature set. To evaluate Materialize for production scenarios, sign up for a free trial account or schedule a demo.

WARNING! The Materialize Emulator is for testing/evaluation purposes only. It is not suitable for production deployments.

Materialize Emulator vs Materialize

	Materialize Emulator	Materialize
	The fastest option for prototyping or internal testing with Materialize.	Cloud-hosted SaaS solution for critical operational workloads.
Production deployments	❌ Not suitable due to performance and license limitations.	✅
Performance	❌ Limited. Services are bundled in a single container.	✅ High. Services are scaled across many machines.
Dedicated support	❌	✅
Sample data	✅ Quickstart data source.	✅ Quickstart data source.
Data sources	✅ Connect using configuration SQL.	✅ Connect using a streamlined GUI.
Version upgrades	✅ Manual, with no data persistence.	✅ Automated, with data persistence.
Use case isolation	❌	✅
Fault tolerance	❌	✅
Horizontal scalability	❌	✅
GUI	❌	✅ Materialize Console

Prerequisites

Docker. If Docker is not installed, refer to its official documentation to install.

Run Materialize Emulator

NOTE:

Use of the Docker image is subject to Materialize’s BSL License.
By downloading the Docker image, you are agreeing to Materialize’s privacy policy.

In a terminal, issue the following command to run a Docker container from the Materialize Emulator image. The command downloads the image, if one has not been already downloaded.
```
docker run -d -p 127.0.0.1:6875:6875 -p 127.0.0.1:6876:6876 materialize/materialized:v0.126.2
```
When running locally:
- The Docker container binds exclusively to localhost, for security reasons.
- The SQL interface is available on port 6875.
- Logs are available via docker logs <container-id>.
- A default user materialize is created.
- A default database materialize is created.
Connect to the Materialize Emulator using your preferred SQL client, using the following connection field values:

Field Value

Server localhost

Database materialize

Port 6875

Username materialize

For example, if using psql:
```
psql postgres://materialize@localhost:6875/materialize
```
Once connected, you can get started with the Quickstart.

Field	Value
Server	`localhost`
Database	`materialize`
Port	`6875`
Username	`materialize`

Next steps

To start ingesting your own data from an external system like Kafka, MySQL or PostgreSQL, check the documentation for sources.
Join the Materialize Community on Slack.
To more fully evaluate Materialize and its features, sign up for a free trial account or schedule a demo.

Technical Support

For questions, discussions, or general technical support, join the Materialize Community on Slack.

License and privacy policy

Use of the Docker image is subject to Materialize’s BSL License.
By downloading the Docker image, you are agreeing to Materialize’s privacy policy.