GreptimeDB Standalone

You can try out GreptimeDB with our test builds released on the Download page.

We use the simplest configuration for you to get started. For a comprehensive list of configurations available in GreptimeDB, see the configuration documentation.

Binary

Linux and macOS

For Linux and macOS users, you can download the latest build of the greptime binary by using the following commands:

  1. curl -fsSL \
  2.   https://raw.githubusercontent.com/greptimeteam/greptimedb/main/scripts/install.sh | sh

Once the download is completed, the binary file greptime will be stored in your current directory.

You can run GreptimeDB in the standalone mode:

  1. ./greptime standalone start

Windows

If you have WSL(Windows Subsystem for Linux) enabled, you can lunch a latest Ubuntu and run GreptimeDB like above!

Otherwise please download the GreptimeDB binary for Windows at our official site, and unzip the downloaded artifact.

To run GreptimeDB in standalone mode, open a terminal (like Powershell) at the directory where the GreptimeDB binary locates, and execute:

  1. .\greptime standalone start

Docker

Make sure the Docker is already installed. If not, you can follow the official documents to install Docker.

  1. docker run -p 127.0.0.1:4000-4003:4000-4003 \
  2. -v "$(pwd)/greptimedb:/tmp/greptimedb" \
  3. --name greptime --rm \
  4. greptime/greptimedb:v0.8.2 standalone start \
  5. --http-addr 0.0.0.0:4000 \
  6. --rpc-addr 0.0.0.0:4001 \
  7. --mysql-addr 0.0.0.0:4002 \
  8. --postgres-addr 0.0.0.0:4003

GreptimeDB Standalone - 图1NOTE

To avoid accidently exit the Docker container, you may want to run it in the “detached” mode: add the -d flag to the docker run command.

The data will be stored in the greptimedb/ directory in your current directory.

If you want to use another version of GreptimeDB’s image, you can download it from our GreptimeDB Dockerhub. In particular, we support GreptimeDB based on CentOS, and you can try image greptime/greptimedb-centos.

GreptimeDB Standalone - 图2NOTE

If you are using a Docker version lower than v23.0, you may experience problems with insufficient permissions when trying to run the command above, due to a bug in the older version of Docker Engine.

You can:

  1. Set --security-opt seccomp=unconfined, for example:

    1. docker run --security-opt seccomp=unconfined -p 4000-4003:4000-4003 \
    2. -v "$(pwd)/greptimedb:/tmp/greptimedb" \
    3. --name greptime --rm \
    4. greptime/greptimedb:v0.8.2 standalone start \
    5. --http-addr 0.0.0.0:4000 \
    6. --rpc-addr 0.0.0.0:4001 \
    7. --mysql-addr 0.0.0.0:4002 \
    8. --postgres-addr 0.0.0.0:4003

  2. Upgrade the Docker version to v23.0.0 or higher;

Binding address

GreptimeDB binds to 127.0.0.1 by default. If you need to accept connections from other addresses, you can start with the following parameters.

GreptimeDB Standalone - 图3Warning

If the computer running GreptimeDB is directly exposed to the internet, binding to 0.0.0.0 is dangerous and will expose the instance to everybody on the internet.

  • Binary
  • Docker
  1. ./greptime standalone start \
  2.    --http-addr 0.0.0.0:4000 \
  3.    --rpc-addr 0.0.0.0:4001 \
  4.    --mysql-addr 0.0.0.0:4002 \
  5.    --postgres-addr 0.0.0.0:4003
  1. docker run -p 0.0.0.0:4000-4003:4000-4003 \
  2. -v "$(pwd)/greptimedb:/tmp/greptimedb" \
  3. --name greptime --rm \
  4. greptime/greptimedb:v0.8.2 standalone start \
  5. --http-addr 0.0.0.0:4000 \
  6. --rpc-addr 0.0.0.0:4001 \
  7. --mysql-addr 0.0.0.0:4002 \
  8. --postgres-addr 0.0.0.0:4003

You can also refer to the Configuration document to modify the bind address in the configuration file.

Next Steps

Learn how to write data to GreptimeDB and visualize it using Grafana in the Quick Start.