Get started with QuestDB from the binaries

This page describes how to download and run QuestDB via binaries.

  • Linux or FreeBSD versions include script,
  • Windows version has questdb.exe executable,
  • For macOS, check out Homebrew.

Download the binaries#

Use the following links to download a tarball for your operating system:



This package differs from others by not embedding Java.

You should use it only if there is no package specific to your platform.
In practice, this often means ARM Linux.

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 environment variable#

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

Extract the tarballs#

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

Run QuestDB#

This section lists commands to run QuestDB for different OSes. They can be used to run No JVM binaries.

The file structure is as the following:

โ”œโ”€โ”€ conf
โ”œโ”€โ”€ db
โ”œโ”€โ”€ log
โ””โ”€โ”€ public

For information about the file structure, see root directory.

Upgrade QuestDB version#

This section lists commands to upgrade QuestDB for different OSes. They can be used to run No JVM binaries.


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

Steps to upgrade the QuestDB version:

  • Stop the instance
  • Overwrite the bin and lib folders with the new files
  • Restart the instance

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.

โญ Something missing? Page not helpful? Please suggest an edit on GitHub.