- 64-bit MacOS, Windows or Linux.
- Oracle Java JRE or JDK 8 and above, or OpenJDK equivalent.
OpenJDK may incur a performance penalty of up to 20% as it contains fewer intrinsics than the Oracle counterpart.
Step 1 - Download & install JAVA
If you already have a suitable version JAVA installed, you can skip this step. You can find the package corresponding to your architecture on the Oracle Download page.
Step 2 - Download QuestDB
You can download QuestDB from our download page. To install, simply extract the files into the directory of your choice.
Throughout this documentation, we refer to this directory as the
installation_directory. When starting, QuestDB requires another directory where the configuration, logs, and data files are saved. We call this directory the root_directory.
QuestDB comes with an executable
questdb.exe for Windows, and script
questdb.sh for MacOS and Linux which can
be used to control QuestDB as a service. On Windows, QuestDB can also be started interactively.
Navigate to the
You can interact with the service using the following syntax and commands.
./questdb.sh [start|stop|status] [-d dir] [-f] [-t tag]
questdb.exe [start|stop|status|install|remove] [-d dir] [-f] [-j JAVA_HOME] [-t tag]
|start||Starts Windows service. Default service name is |
|stop||Stops Windows service|
|status||Shows service status. This command is useful for troubleshooting problems with the service. It prints |
|install||Install the Windows service|
|remove||Remove the Windows service|
start - starts the questdb service.
QuestDB will start and run in the background and continue running even if you close the session. You will need to actively stop it.
By default, QuestDB root directory will be the following
-d- specify QuestDB's
-f- force reload the web console. The web console is cached otherwise and the HTML page will not be reloaded automatically in case it has been changed.
-j (Windows only)- path to JAVA_HOME
-t- specify a service tag. You can use this option to run several services and administer them separately.
./questdb.sh start -d '/home/user/my_new_root_directory'
questdb.exe start -d 'C:\Users\user\my_new_root_directory'
questdb.exe start -j 'C:\Program Files\Java\jdk1.8.0_141'
questdb.exe start -d 'C:\Users\user\my_new_root_directory' -j 'C:\Program Files\Java\jdk1.8.0_141' -t 'mytag'
stop - stops the default
questdb service, or the service specified with the
./questdb.sh stop -t 'my-questdb-service'
questdb.exe stop -t 'my-questdb-service'
status shows service status. This command is useful for troubleshooting problems with the service. It prints
Not running if the service is start or stopped respectively. On Unix systems, it also prints the
./questdb.sh status -t 'my-questdb-service'
questdb.exe status -t 'my-questdb-service'
install - installs the Windows questdb service. It will start automatically at startup.
installis only available on Windows.
questdb.exe install -t 'my-questdb-service'
remove - removes the Windows questdb service. It will no longer start at startup.
removeis only available on Windows.
questdb.exe remove -t 'my-questdb-service'
Use interactively (Windows)
You can start QuestDB interactively by running
This will launch QuestDB interactively in the active
Shell window. QuestDB will be stopped when the Shell is closed.
When started interactively, QuestDB's root directory defaults to the
To start, run the following.
To stop, simply press Ctrl+C in the
Shell window or close it.