メインコンテンツへスキップ

​
tgz アーカイブを使用して ClickHouse をインストールする

deb または rpm パッケージをインストールできない Linux ディストリビューションでは、公式の事前コンパイル済み tgz アーカイブを使用することを推奨します。
1

​
推奨事項を確認する

ClickHouse をインストールする前に、次の推奨事項を確認してください。
  • スワップ: 本番環境では、オペレーティングシステムのスワップファイルを無効にしてください。
  • ディスク容量: ClickHouse バイナリのインストールには、少なくとも 2.5 GB のディスク容量が必要です。
  • ネットワーク: 分散デプロイメント (クラスター構成) では、少なくとも 10 Gbit のネットワーク接続を使用してください。大量の中間データを伴う分散クエリの処理やレプリケーションでは、ネットワーク帯域幅が重要です。
ストレージ要件の見積もりデータに必要なディスク容量を見積もるには:
  1. データ量を見積もる: データのサンプルを取得して平均的な行サイズを計算し、それに保存予定の行数を掛けます。
  2. 圧縮係数を適用する: サンプルを ClickHouse にロードし、元のデータサイズと保存後のテーブルサイズを比較します。たとえば、クリックストリームデータは通常 6～10 倍に圧縮されます。
  3. レプリカを考慮する: 複数のレプリカにデータを保存する予定がある場合は、見積もり容量にレプリカ数を掛けます。
より詳細なハードウェア要件については、“サイジングとハードウェアの推奨事項” を参照してください。
2

​
最新の stable バージョンをダウンロードしてインストールする

必要なバージョンは、リポジトリ https://packages.clickhouse.com/tgz/ から curl または wget を使ってダウンロードできます。 その後、ダウンロードしたアーカイブを展開し、インストールスクリプトを使ってインストールします。以下は、最新の stable バージョンをインストールする例です。
本番環境では、最新の stable バージョンを使用することを推奨します。 リリース番号は、この GitHub page で、接尾辞 -stable が付いたものとして確認できます。
3

​
最新の ClickHouse バージョンを取得する

GitHub から最新の ClickHouse バージョンを取得し、LATEST_VERSION 変数に保存します。
LATEST_VERSION=$(curl -s https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/utils/list-versions/version_date.tsv | \
    grep -Eo '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+' | sort -V -r | head -n 1)
export LATEST_VERSION
4

​
システムアーキテクチャを検出する

システムアーキテクチャを検出し、それに応じて ARCH 変数を設定します。
case $(uname -m) in
  x86_64) ARCH=amd64 ;;         # Intel/AMD 64 ビットプロセッサ向け
  aarch64) ARCH=arm64 ;;        # ARM 64 ビットプロセッサ向け
  *) echo "Unknown architecture $(uname -m)"; exit 1 ;; # サポートされていないアーキテクチャの場合は終了
esac
5

​
各 ClickHouse コンポーネントの tarball をダウンロードする

各 ClickHouse コンポーネントの tarball をダウンロードします。このループでは、まずアーキテクチャ固有の パッケージを試し、利用できない場合は汎用パッケージにフォールバックします。
for PKG in clickhouse-common-static clickhouse-common-static-dbg clickhouse-server clickhouse-client clickhouse-keeper
do
  curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION-${ARCH}.tgz" \
    || curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION.tgz"
done
6

​
パッケージを展開してインストールする

以下のパッケージを展開してインストールするには、次のコマンドを実行します。
  • clickhouse-common-static
# clickhouse-common-static パッケージを展開してインストール
tar -xzvf "clickhouse-common-static-$LATEST_VERSION-${ARCH}.tgz" \
  || tar -xzvf "clickhouse-common-static-$LATEST_VERSION.tgz"
sudo "clickhouse-common-static-$LATEST_VERSION/install/doinst.sh"
  • clickhouse-common-static-dbg
# デバッグシンボルパッケージを展開してインストール
tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION-${ARCH}.tgz" \
  || tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION.tgz"
sudo "clickhouse-common-static-dbg-$LATEST_VERSION/install/doinst.sh"
  • clickhouse-server
# 設定を含むサーバーパッケージを展開してインストール
tar -xzvf "clickhouse-server-$LATEST_VERSION-${ARCH}.tgz" \
  || tar -xzvf "clickhouse-server-$LATEST_VERSION.tgz"
sudo "clickhouse-server-$LATEST_VERSION/install/doinst.sh" configure
sudo /etc/init.d/clickhouse-server start  # サーバーを起動
  • clickhouse-client
# クライアントパッケージを展開してインストール
tar -xzvf "clickhouse-client-$LATEST_VERSION-${ARCH}.tgz" \
  || tar -xzvf "clickhouse-client-$LATEST_VERSION.tgz"
sudo "clickhouse-client-$LATEST_VERSION/install/doinst.sh"
最終更新日 2026年6月10日