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 https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

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:
/opt/homebrew/var/questdb
Path on Macs with Intel chip:
/usr/local/var/questdb

The file structure is as the following:

/questdb
├── 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#

note

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.