openGeminiAbout 1 minAbout 321 words



Compile environment information

How to set GO environment variables

Open ~/.profile configuration file and add the following configurations to the end of the file:

# Set GOPATH (requires custom directory)
export GOPATH=/path/to/dir
# Set up domestic proxy
export GOPROXY=,direct
# Turn on go mod mode
export GO111MODULE=on
export GONOSUMDB=*
export GOSUMDB=off


Clone the source code to your development machine:

git clone


  1. Enter the home directory.
cd openGemini
  1. Compiling.
python3 --clean

::: tips

The compiled binary file is in the build directory

> ls build
> ts-cli ts-meta ts-monitor ts-server ts-sql ts-store

ts-server is the standalone version.



Run the stand-alone version.


::: tips

For version v1.0.1 and earlier, you need to specify the configuration file to start the ts-server.

./build/ts-server -config config/openGemini.singlenode.conf

If you want to start it in the background, you can use the following command.

nohup ./build/ts-server -config config/openGemini.singlenode.conf > server_extra.log 2>&1 &



To facilitate various queries of the database, openGemini provides a command-line application called openGemini CLI (ts-cli for short). To enter the openGemini command line, you only need to go to the directory where ts-cli is located and execute ts-cli in the terminal.

Use the client to connect to openGemini you can use the following command:



By default, it connects to, but you can connect to other hosts using the following command:

./ts-cli -host -port 8086

For more usage, please use the following command to explore:

./ts-cli -h