Get started with QuestDB from the binaries

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

• Linux or FreeBSD versions include questdb.sh 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:

Linux

questdb-7.3.2-rt-linux-amd64.tar.gz

Windows

questdb-7.3.2-rt-windows-amd64.tar.gz

FreeBSD

questdb-7.3.2-rt-freebsd-amd64.tar.tar

Any (no JVM)

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

note

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

Linux

tar -xvf questdb-7.3.2-rt-linux-amd64.tar.gz

Windows

tar -xvf questdb-7.3.2-rt-windows-amd64.tar.gz

FreeBSD

tar -xvf questdb-7.3.2-rt-freebsd-amd64.tar.tar

Any (no JVM)

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.

Linux

./questdb.sh start

Windows

To run the instance as a windows service (preferably as a privileged account):

questdb.exe install

questdb.exe start

To run a one-off instance in the current work directory:

questdb.exe

FreeBSD

./questdb.sh start

The file structure is as the following:

/questdb

├── 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.

note

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

Linux

./questdb.sh stop

Overwrite bin and lib folders with the new files

./questdb.sh start

Windows

./questdb.exe stop

Overwrite bin and lib folders with the new files

./questdb.exe start

FreeBSD

./questdb.sh stop

Overwrite bin and lib folders with the new files

./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.