GreptimeDB is an open-source, cloud-native time series database which also has powerful analytical features
The next-generation hybrid time-series/analytics processing database in the cloud
What is GreptimeDB
GreptimeDB is an open-source time-series database with a special focus on scalability, analytical capabilities and efficiency. It's designed to work on infrastructure of the cloud era, and users benefit from its elasticity and commodity storage.
Our core developers have been building time-series data platform for years. Based on their best-practices, GreptimeDB is born to give you:
Quick Start GreptimePlay
Try out the features of GreptimeDB right from your browser.
Build Build from Source
To compile GreptimeDB from source, you'll need:
build-essential
on ubuntu and similar name on other platforms.rustup
, which will check our rust-toolchain
file and
install correct Rust version for you.protoc
is required for compiling .proto
files. protobuf
is
available from major package manager on macos and linux distributions. You can
find an installation instructions here.
Note that protoc
version needs to be >= 3.15 because we have used the optional
keyword. You can check it with protoc --version
.pyo3_backend
feature when compiling(by cargo run -F pyo3_backend
or add pyo3_backend
to src/script/Cargo.toml 's features.default
like default = ["python", "pyo3_backend]
)): this install a Python shared library required for running Python
scripting engine(In CPython Mode). This is available as python3-dev
on
ubuntu, you can install it with sudo apt install python3-dev
, or
python3-devel
on RPM based distributions (e.g. Fedora, Red Hat, SuSE). Mac's
Python3
package should have this shared library by default. More detail for compiling with PyO3 can be found in PyO3's documentation.Build with Docker
A docker image with necessary dependencies is provided:
docker build --network host -f docker/Dockerfile -t greptimedb .
Run
Start GreptimeDB from source code, in standalone mode:
cargo run -- standalone start
Or if you built from docker:
docker run -p 4002:4002 -v "$(pwd):/tmp/greptimedb" greptime/greptimedb standalone start
Please see the online document site for more installation options and operations info.
Get started
Read the complete getting started guide on our official document site.
To write and query data, GreptimeDB is compatible with multiple protocols and clients.
Resources Installation
pyo3_backend
enabled.gtctl
: the command-line tool for
Kubernetes deploymentDocumentation
Dashboard
SDK
Project Status
This project is in its early stage and under heavy development. We move fast and break things. Benchmark on development branch may not represent its potential performance. We release pre-built binaries constantly for functional evaluation. Do not use it in production at the moment.
For future plans, check out GreptimeDB roadmap.
Community
Our core team is thrilled to see you participate in any ways you like. When you are stuck, try to ask for help by filling an issue with a detailed description of what you were trying to do and what went wrong. If you have any questions or if you would like to get involved in our community, please check out:
In addition, you may:
License
GreptimeDB uses the Apache 2.0 license to strike a balance between open contributions and allowing you to use the software however you want.
Contributing
Please refer to contribution guidelines for more information.
Acknowledgement
Twice a month we will interview people behind open source businesses. We will talk about how they are building a business on top of open source projects.
We'll never share your email with anyone else.