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!

shell

  1. git clone https://github.com/GreptimeTeam/greptimedb.git
  2. cd greptimedb
  3. 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:

shell

  1. 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

shell

  1. 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