Run the Materialize Emulator on Docker

The Materialize Emulator is an all-in-one Docker image available on Docker Hub, offering the fastest way to get hands-on experience with Materialize in a local environment.

  Materialize Emulator
The fastest option for prototyping or internal testing with Materialize.
Download 		Materialize
Materialize's cloud hosted SaaS solution for critical operational workloads.
Get a demo Try it free
Production deployments Cross Not suitable due to performance and license limitations. Checkmark
Performance Cross Limited. Services are bundled in a single container. Checkmark High. Services are scaled across many machines.
Dedicated Support Cross Checkmark
Sample data Checkmark Quickstart data source Checkmark Quickstart data source
Data sources Checkmark Connect using SQL configuration Checkmark Connect using a streamlined GUI
Version upgrades Checkmark Manual, with no data persistence Checkmark Automated, with data persistence
Use case isolation Cross Checkmark
Fault tolerance Cross Checkmark
Horizontal scalability Cross Checkmark
GUI (Materialize Console) Checkmark Checkmark

Run the Materialize Emulator on Docker

Install with docker run

Run this line in your terminal to launch Materialize instantly:

bash
docker run -d -p 127.0.0.1:6874:6874 -p 127.0.0.1:6875:6875 -p 127.0.0.1:6876:6876 materialize/materialized:latest

Once the image is running:

  • The Docker container binds exclusively to localhost for security reasons.
  • The SQL interface is available on port 6875.
  • The Materialize Console is available on port 6874.
  • Logs are available via docker logs <container-id>.

Connect to the Materialize database

Open the Materialize Console in your browser at http://localhost:6874/ and navigate to the SQL Shell.

Alternatively, access the SQL interface using psql:

bash
psql postgres://materialize@localhost:6875/materialize

Explore Materialize

Once you’re running Materialize:

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.