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.7.0. The latest (unstable)
developer builds are available at https://mtrlz.dev/. For prior releases,
see the Versions page.
Have any questions? Contact us
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.7.0 --workers 1
macOS installation
Homebrew
Assuming you’ve installed Homebrew:
brew install MaterializeInc/materialize/materialized
curl
curl -L https://downloads.mtrlz.dev/materialized-v0.7.0-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.7.0-x86_64-unknown-linux-gnu.tar.gz \
| 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.49.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.7.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:
Detail | Info |
---|---|
Database | materialize |
Port | 6875 |
For more information, see CLI Connections.
Next, let’s get started with Materialize →