Install

You can access Materialize through the materialized binary, which you can install on macOS and Linux, or build on most OSes (e.g. FreeBSD). These instructions install the latest release of Materialize, v0.17.0. For prior releases and unstable builds, see the Versions page.

Have any questions? Ask us on Slack

Docker

We provide the materialize/materialized image in Docker Hub. If you already have Docker installed, you can run materialized with your tools in the usual way. For example:

docker run -p 6875:6875 materialize/materialized:v0.17.0 --workers 1

macOS installation

Homebrew

Assuming you’ve installed Homebrew:

brew install MaterializeInc/materialize/materialized

curl

curl -L https://binaries.materialize.com/materialized-v0.17.0-$(uname -m)-apple-darwin.tar.gz \
    | sudo tar -xzC /usr/local --strip-components=1

Linux installation

apt (Ubuntu, Debian, or variants)

Note! These instructions changed between versions 0.8.0 and 0.8.1. If you ran them previously, you may need to do so again to continue receiving updates.

# Add the signing key for the Materialize apt repository
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 79DEC5E1B7AE7694
# Add and update the repository
sudo sh -c 'echo "deb http://apt.materialize.com/ generic main" > /etc/apt/sources.list.d/materialize.list'
sudo apt update
# Install materialized
sudo apt install materialized

curl

curl -L https://binaries.materialize.com/materialized-v0.17.0-$(uname -m)-unknown-linux-gnu.tar.gz \
    | sudo tar -xzC /usr/local --strip-components=1

Build from source

Materialize is written primarily in Rust, but incorporates several components written in C. To build Materialize, you will need to acquire the following tools:

• A recent version of Git

• A C compiler that supports C11

• CMake v3.2+

• Rust v1.58.0+

Your system’s package manager, like Homebrew on macOS or APT on Debian, likely contains sufficiently recent versions of Git, a C compiler, and CMake. However, we recommend installing Rust via rustup. rustup configures your system so that running cargo build in the Materialize repository will automatically download and use the correct version of Rust.

Once you’ve installed the prerequisites, to build your own materialized binary, you can clone the MaterializeInc/materialize repo from GitHub, and build it using cargo build. Be sure to check out the tag for the correct release.

git clone https://github.com/MaterializeInc/materialize.git
cd materialize
git checkout v0.17.0
cargo build --release

Run the binary

You can start the materialized process by simply running the binary, e.g.

./materialized -w 1

-w 1 specifies that the process will use 1 worker. You can also find more detail about our command line flags.

By default materialized uses:

CLI Connections

To connect to a running instance, you can use any Materialize-compatible CLI, like psql or mzcli. To install the psql client:

brew install postgresql

apt install postgresql-client

Once you have psql installed, connect using:

psql -U materialize -h localhost -p 6875 materialize

Next, let’s get started with Materialize! →