メインコンテンツへスキップ
ClickHouse は Nixpkgs リポジトリで提供されており、Linux および macOS では Nix を使ってインストールできます。
1

​
推奨事項を確認する

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

​
Nix を使って ClickHouse をインストールする

Nix を使うと、ClickHouse をシステムに恒久的に追加することなくインストールできます。
# 最新の安定版をインストール
nix shell nixpkgs#clickhouse

# または LTS バージョンをインストール
nix shell nixpkgs#clickhouse-lts
これにより、現在のシェルセッションで clickhouse バイナリを利用できるようになります。
  • nixpkgs#clickhouse パッケージは最新の安定版を提供します。
  • nixpkgs#clickhouse-lts パッケージは Long Term Support バージョンを提供します。
  • どちらのパッケージも Linux と macOS で動作します。
3

​
恒久的なインストール

ClickHouse をシステムに恒久的にインストールするには、次のようにします。NixOS ユーザーの場合、configuration.nix に次を追加します。
environment.systemPackages = with pkgs; [
  clickhouse
];
次に、システムを再構築します。
sudo nixos-rebuild switch
NixOS 以外のユーザーの場合、Nix profile を使ってインストールします。
# 最新の安定版をインストール
nix profile install nixpkgs#clickhouse

# または LTS バージョンをインストール
nix profile install nixpkgs#clickhouse-lts
4

​
ClickHouseサーバーを起動する

インストール後、ClickHouseサーバーを起動できます。
clickhouse-server
デフォルトでは、サーバーは基本設定で起動し、localhost:9000 で待ち受けます。NixOS で本番用途に使用する場合は、ClickHouse をシステムサービスとして設定することをおすすめします。利用可能な設定オプションについては、NixOS manual を参照してください。
5

​
ClickHouseクライアントを起動する

ClickHouseサーバーに接続するには、新しいターミナルを開いて次を実行します。
clickhouse-client

​
Nix パッケージについて

Nixpkgs の ClickHouse パッケージには、以下が含まれています。
  • clickhouse-server - ClickHouse データベースサーバー
  • clickhouse-client - ClickHouse に接続するためのコマンドラインクライアント
  • clickhouse-local - ローカルファイルに対して SQL クエリを実行するツール
  • その他の ClickHouse ユーティリティ
Nixpkgs の ClickHouse パッケージの詳細については、以下を参照してください。
最終更新日 2026年6月29日