Materialize CLI Installation

We offer several installation methods for mz on macOS and Linux.

macOS

On macOS, we we recommend using Homebrew.

Homebrew

You’ll need Homebrew installed on your system. Then install mz from our tap:

brew install materializeinc/materialize/mz

Binary download

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

Linux

On Linux, we recommend using APT, if supported by your distribution.

apt (Ubuntu, Debian, or variants)

curl -fsSL https://dev.materialize.com/apt/materialize.sources | sudo tee /etc/apt/sources.list.d/materialize.sources
sudo apt update
sudo apt install materialize-cli

Binary download

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

Docker

You can use the materialize/mz Docker image to run mz on any platform that is supported by Docker. You’ll need to mount your local ~/.mz directory in the container to ensure that configuration settings and authentiation tokens outlive the container.

docker run -v $HOME/.mz:/root/.mz materialize/mz [args...]