Binaries

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.

Download

You can find the latest binaries on our release page.

Available commands

./questdb.sh [start|stop|status] [-d dir] [-f] [-t tag]
OptionDescription
startStarts QuestDB service.
stopStops QuestDB service
statusShows service status. This command is useful for troubleshooting problems with the service. It prints RUNNING or INACTIVE if the service is started or stopped respectively

Start

start - starts the QuestDB service.

./questdb.sh start
info

QuestDB will start and run in the background and continue running even if you close the session. You will need to actively stop it.

Default directories

By default, QuestDB root directory will be the following:

$HOME/.questdb

Options

  • -d - specify QuestDB's root_directory.
  • -f - force re-deploying the Web Console. Without this option, the Web Console is cached deployed only when missing.
  • -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.
tip

The tag option, -t, can be used to start and manipulate independent QuestDB services. Each can be started, stopped etc using its own service tag name.

Examples

Linux & macOS - custom root_directory
./questdb.sh start -d '/home/user/my_new_root_directory'
Windows - custom root_directory
questdb.exe start -d 'C:\Users\user\my_new_root_directory'
Windows - custom JAVA_HOME
questdb.exe start -j 'C:\Program Files\Java\jdk-11\'

Stop

stop - stops the default questdb service, or the service specified with the -t option.

Examples

./questdb.sh stop -t 'my-questdb-service'

Status

status shows service status. This command is useful for troubleshooting problems with the service. It prints Running or Not running if the service is start or stopped respectively. On *nix operating systems, it also prints the PID.

Examples

./questdb.sh status

Install

install - installs the Windows QuestDB service. It will start automatically at startup.

note

install is only available on Windows.

Examples

Default service
questdb.exe install
Specific tag
questdb.exe install -t 'my-questdb-service'

Remove

remove - removes the Windows QuestDB service. It will no longer start at startup.

note

remove is only available on Windows.

Examples

Default service
questdb.exe remove
Specific tag
questdb.exe remove -t 'my-questdb-service'

Use interactively (Windows)

You can start QuestDB interactively by running questdb.exe.

Behaviour

This will launch QuestDB interactively in the active Shell window. QuestDB will be stopped when the Shell is closed.

Default directory

When started interactively, QuestDB's root directory defaults to the current directory.

Start

To start, run the following.

questdb.exe

Stop

To stop, press Ctrl+C in the terminal or close it directly.