Getting started ​

This page describes how to run GreptimeDB from source in your local environment.

Prerequisite ​

System & Architecture ​

At the moment, GreptimeDB now only supports Linux(amd64) and macOS (both amd64 and Apple Silicone).

Build Dependencies ​

• Git (optional)
• C/C++ Toolchain: provides essential tools for compiling and linking. This is available either as build-essential on ubuntu or a similar name on other platforms.
• Rust (guide)
  • Compile the source code
• Protobuf (guide)
  • Compile the proto file
  • Note that the version needs to be >= 3.15. You can check it with protoc --version

Compile and Run ​

Start GreptimeDB standalone instance in just a few commands!

git clone https://github.com/GreptimeTeam/greptimedb.git
cd greptimedb
cargo run -- standalone start

git clone https://github.com/GreptimeTeam/greptimedb.git
cd greptimedb
cargo run -- standalone start

Next, you can choose the protocol you like to interact with in GreptimeDB.

Or if you just want to build the server without running it:

cargo build # --release

cargo build # --release

The artifacts can be found under $REPO/target/debug or $REPO/target/release, depending on the build mode (whether the --release option is passed)

Unit test ​

GreptimeDB is well-tested, the entire unit test suite is shipped with source code. To test them, run

cargo test --workspace

cargo test --workspace

Docker ​

We also provide pre-build binary via Docker. It's which is available in dockerhub: https://hub.docker.com/r/greptime/greptimedb