Get started with QuestDB via Homebrew (macOS)

Each software release of QuestDB is distributed via the Homebrew package manager.

Install Homebrew#

Users who already have Homebrew installed may skip this section and proceed to Install QuestDB. Otherwise, Homebrew can be installed by running the official installation script via bash:

/bin/bash -c \
"$(curl -fsSL"

Install QuestDB#

To install QuestDB via Homebrew, run the following command:

brew install questdb

On macOS, the location of the root directory of QuestDB and server configuration files depending on the chip:

  • Path on Macs with Apple Silicon (M1 or M2) chip:

  • Path on Macs with Intel chip:


The file structure is as the following:

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

For information about the file structure, see root directory.

Uninstall QuestDB#

To remove QuestDB, use Homebrew's uninstall command:

brew uninstall questdb

Troubleshooting Homebrew issues#

It's recommended to first run update before trying to install packages or diagnose errors:

brew update

Homebrew comes with a basic diagnostic command which can help find inconsistencies with system settings and permissions. This command will exit with a non-zero status if any potential problems are found:

brew doctor

Upgrade QuestDB version#


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

Once the latest QuestDB version is published on Homebrew, the command to upgrade QuestDB version is:

brew upgrade questdb

Next steps#

Once you installed the QuestDB with Homebrew, you can navigate to our command-line options page to learn more about its usage.

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