Altinity Stable Builds macOS Install Guide
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 withclickhouse@{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 isclickhouse@21.8-altinity-stable
. To install the most recent version, use thebrew 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 theclickhouse-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
Feedback
Was this page helpful?
Glad to hear it!
Sorry to hear that. We'll track this issue and see how we can improve.