Materialize CLI Installation

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


On macOS, we we recommend using Homebrew.


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

brew install materializeinc/materialize/mz

Binary download

curl -L$(uname -m)-apple-darwin.tar.gz \
    | sudo tar -xzC /usr/local --strip-components=1


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

apt (Ubuntu, Debian, or variants)

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

Binary download

curl -L$(uname -m)-unknown-linux-gnu.tar.gz \
    | sudo tar -xzC /usr/local --strip-components=1


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...]
Back to top ↑