Homebrew Tap for ClickHouse

Available formulae

clickhouse                       - alias, points to the latest release ([email protected])
clickhouse@lts                   - alias, points to the latest LTS release ([email protected])

[email protected]                  - the latest release, version: 23.5.3.24-stable
[email protected]                  - keg-only, version: 22.7.2.15-stable
[email protected]                  - keg-only, version: 22.6.4.35-stable
[email protected]                  - keg-only, version: 22.5.3.21-stable
[email protected]                  - keg-only, version: 22.4.6.53-stable
[email protected]                  - keg-only, version: 22.3.9.19-lts
[email protected]                  - keg-only, version: 22.2.3.5-stable
[email protected]                  - keg-only, version: 22.1.4.30-stable

Quick start: one-liner

brew install clickhouse/clickhouse/clickhouse

Quick start: fine control

First, register the tap (needs to be done only once):

brew tap clickhouse/clickhouse

Then, install the formula:

brew install clickhouse
# ..or
brew install [email protected]
# ...and so on.

Please always read the Caveats sections displayed after installation carefully.

Note that the installation doesn't require sudo and will deploy ClickHouse under the standard Homebrew prefix.

Running ClickHouse server

Do not use sudo, ever. Do not start the ClickHouse server manually, instead use brew services:

brew services start clickhouse
# ..or
brew services start [email protected]
# ...and so on.

ClickHouse is deployed under the standard Homebrew prefix. The relevant directories are:

Config:    $(brew --prefix)/etc/clickhouse-server/
Data:      $(brew --prefix)/var/lib/clickhouse/
Logs:      $(brew --prefix)/var/log/clickhouse-server/
PID file:  $(brew --prefix)/var/run/clickhouse-server/

These files and directories will be preserved between installations.

Make sure you stop the server, when upgrading the formula.

If you absolutely need to run ClickHouse server manually, the command that corresponds to brew services start clickhouse would be:

$(brew --prefix clickhouse)/bin/clickhouse server --config-file $(brew --prefix)/etc/clickhouse-server/config.xml --pid-file $(brew --prefix)/var/run/clickhouse-server/clickhouse-server.pid

Versioned formulae

All except the latest versioned ClickHouse formulae are configured as keg-only, so in order to refer to an executable from such formula you have to provide the full path to it, e.g.:

$(brew --prefix [email protected])/bin/clickhouse client

Pre-built binary packages (bottles)

Bottles for the following platforms are available:

macOS Monterey (version 12) on Intel
macOS Monterey (version 12) on Apple silicon

Eventually, this list will be extended to also contain some of the previous versions of macOS.

Building (the latest versions) from sources

Formulae will be built from sources automatically if the corresponding bottles are not available for your platform.

It could take several hours to build ClickHouse from sources, so you will probably want to monitor the progress. To enable verbose output for that scenario, add --verbose to brew install ...:

brew install --verbose clickhouse

You can also build the latest version (HEAD) of the sources for a formula:

brew install --HEAD --verbose clickhouse

The above command will check out the tip of the branch that corresponds to that specific version (e.g., branch 21.11 for [email protected] and so on) and build it from sources.

Homebrew on Linux (Linuxbrew)

Building the formulae from this tap is not tested in Linux, and bottles are not available, but there are no known conceptual problems, and they should generally work. Feel free to experiment and report any issues.

Adding or updating formulae in this tap (for maintainers only)

Refer to Maintenance for instructions.

Useful links

• ClickHouse
• Homebrew