You can access Materialize through the materialized binary, which you can install on macOS and Linux. These instructions install the latest release of Materialize, v0.1.3. For prior releases, see the Versions page.

Note: We have unofficial support for other operating systems, e.g. FreeBSD, if you build from source.

macOS installation 


Assuming you’ve installed Homebrew:

brew install MaterializeInc/materialize/materialized


curl -L | tar -xzC /usr/local --strip-components=1

Linux installation 

apt (Ubuntu, Debian, or variants) 

Run the following commands as root.

# Add the signing key for the Materialize apt repository
apt-key adv --keyserver --recv-keys 379CE192D401AB61
# Add and update the repository
sh -c 'echo "deb /" > /etc/apt/sources.list.d/materialize.list'
apt update
# Install materialized
apt install materialized


curl -L | tar -xzC /usr/local --strip-components=1

Build from source 

Materialize is written in Rust and requires a recent Rust toolchain to build from source. Follow Rust’s getting started guide if you don’t already have Rust installed.

Then, 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
cd materialize
git checkout v0.1.3
cargo build

Run the binary 

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


By default materialized uses:

Detail Info
Database materialize
Port 6875

For more information, see CLI Connections.

Up next 

With materialized installed, let’s get started.