Install

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 

Homebrew 

Assuming you’ve installed Homebrew:

brew install MaterializeInc/materialize/materialized

curl 

curl -L https://downloads.mtrlz.dev/materialized-v0.1.3-x86_64-apple-darwin.tar.gz | 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 keyserver.ubuntu.com --recv-keys 379CE192D401AB61
# Add and update the repository
sh -c 'echo "deb http://packages.materialize.io/apt/ /" > /etc/apt/sources.list.d/materialize.list'
apt update
# Install materialized
apt install materialized

curl 

curl -L https://downloads.mtrlz.dev/materialized-v0.1.3-x86_64-unknown-linux-gnu.tar.gz | 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 https://github.com/MaterializeInc/materialize.git
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.

./materialized

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.