Get started with QuestDB from the binaries

This page describes how to download and run QuestDB via binaries. QuestDB comes with a questdb.sh script on Linux or FreeBSD, and a questdb.exe executable on Windows. For macOS, check out Homebrew.

Prerequisites#

Java 11#

You need to have Java 11 installed locally. To check your installed version:

java -version

If you do not have Java installed, install one of the following supported packages for your operating system:

  • AdoptOpenJDK
  • Amazon Corretto
  • OpenJDK
  • Oracle Java

Other Java distributions might work but are not tested.

JAVA_HOME#

The environment variable JAVA_HOME needs to point to your Java 11 installation folder.

Download the binaries#

The Java runtime is packaged directly with QuestDB and you do not need anything else.

Extract the tarballs#

tar -xvf questdb-7.1.3-no-jre-bin.tar.gz

Run QuestDB#

./questdb.sh start

Upgrade QuestDB version#

note

Check the release notes and ensure that necessary backup is completed.

To upgrade the QuestDB version: stop the instance, overwrite the binaries folder with new binaries, and then restart the instance:

./questdb.sh stop
(Overwrite the binaries folder with new binaries)
./questdb.sh start

Next steps#

Once you extracted the tarball, you are ready to use QuestDB. Navigate to our command-line options page to learn more about its usage.