Altinity Stable Builds macOS Install Guide

How to install the Altinity Stable Builds for ClickHouse with macOS.

Installing on macOS

Altinity Stable for ClickHouse is available to macOS users through the Homebrew package manager. Users and developers who use macOS as their preferred environment can quickly install a production ready version of ClickHouse within minutes.

The following instructions are targeted for users of Altinity Stable for ClickHouse. For more information on running community or other versions of ClickHouse on macOS, see either the Homebrew Tap for ClickHouse project or the blog post Altinity Introduces macOS Homebrew Tap for ClickHouse.

Note

As of this time, the only versions of macOS with prepared binary bottles are the following:

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

Other versions of macOS will compile from the source code rather than downloading pre-compiled binaries. This process can take anywhere from 30 minutes to several hours depending on your environment and internet connection.

macOS Prerequisites

Installed the Homebrew package manager.

Brew Install for Altinity Stable Instructions

By default, installing ClickHouse through brew will install the latest version of the community version of ClickHouse. Extra steps are required to install the Altinity Stable version of ClickHouse. Altinity Stable is installed as a keg-only version, which requires manually setting paths and other commands to run the Altinity Stable for ClickHouse through brew.

To install Altinity Stable for ClickHouse in macOS through Brew:

Add the ClickHouse formula via brew tap:
```
brew tap altinity/clickhouse
```
Install Altinity Stable for ClickHouse by specifying clickhouse@altinity-stable for the most recent Altinity Stable version, or specify the version with clickhouse@{Altinity Stable Version}. For example, as of this writing the most current version of Altinity Stable is 21.8, therefore the command to install that version of altinity stable is clickhouse@21.8-altinity-stable. To install the most recent version, use the brew install command as follows:
```
brew install clickhouse@altinity-stable
```
Because Altinity Stable for ClickHouse is available as a keg only release, the path must be set manually. These instructions will be displayed as part of the installation procedure. Based on your version, executable directory will be different based on the pattern:

$(brew --prefix)/{clickhouse version}/bin

For our example, clickhouse@altinity-stable gives us the following path setting:

export PATH="/opt/homebrew/opt/clickhouse@21.8-altinity-stable/bin:$PATH"

Using the which command after updating the path reveals the location of the clickhouse-server executable:
```
which clickhouse-server
/opt/homebrew/opt/clickhouse@21.8-altinity-stable/bin/clickhouse-server
```
To start the Altinity Stable for ClickHouse server use the brew services start command. For example:
```
brew services start clickhouse@altinity-stable
```

Connect to the new server with clickhouse-client:

> clickhouse-client
ClickHouse client version 21.8.13.1.
Connecting to localhost:9000 as user default.
Connected to ClickHouse server version 21.11.6 revision 54450.

ClickHouse client version is older than ClickHouse server. It may lack support for new features.

penny.home :) select version()

SELECT version()

Query id: 128a2cae-d0e2-4170-a771-83fb79429260

┌─version()─┐
│ 21.11.6.1 │
└───────────┘

1 rows in set. Elapsed: 0.004 sec.

penny.home :) exit
Bye.

To end the ClickHouse server, use brew services stop command:
```
brew services stop clickhouse@altinity-stable
```