> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> NixOS および Nix を使用した ClickHouse のインストール

# NixOS への ClickHouse のインストール

<div id="install-from-nix">
  # NixOS に ClickHouse をインストールする
</div>

> ClickHouse は Nixpkgs リポジトリで提供されており、**Linux** と **macOS** では Nix を使ってインストールできます。

<Steps>
  <Step>
    ## 推奨事項を確認する

    ClickHouse をインストールする前に、次の推奨事項を確認してください。

    * **スワップ:** 本番環境では、オペレーティングシステムのスワップファイルを無効にしてください。
    * **ディスク容量:** ClickHouse バイナリのインストールには、少なくとも 2.5 GB のディスク容量が必要です。
    * **ネットワーク:** 分散デプロイメント (クラスター構成) では、少なくとも 10 Gbit のネットワーク接続を使用してください。大量の中間データを伴う分散クエリの処理やレプリケーションでは、ネットワーク帯域幅が重要です。

    **ストレージ要件の見積もり**

    データに必要なディスク容量を見積もるには:

    1. **データ量を見積もる:** データのサンプルを取得して平均的な行サイズを計算し、それに保存予定の行数を掛けます。
    2. **圧縮係数を適用する:** サンプルを ClickHouse にロードし、元のデータサイズと保存後のテーブルサイズを比較します。たとえば、クリックストリームデータは通常 6～10 倍に圧縮されます。
    3. **レプリカを考慮する:** 複数のレプリカにデータを保存する予定がある場合は、見積もり容量にレプリカ数を掛けます。

    より詳細なハードウェア要件については、["サイジングとハードウェアの推奨事項"](/ja/guides/oss/best-practices/sizing-and-hardware-recommendations) を参照してください。
  </Step>

  <Step>
    ## Nix を使って ClickHouse をインストールする

    Nix を使うと、システムに恒久的に追加することなく ClickHouse をインストールできます。

    ```bash theme={null}
    # 最新の stable バージョンをインストール
    nix shell nixpkgs#clickhouse

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

    これにより、現在のシェルセッションで `clickhouse` バイナリを利用できるようになります。

    * `nixpkgs#clickhouse` パッケージは最新の stable バージョンを提供します。
    * `nixpkgs#clickhouse-lts` パッケージは Long Term Support バージョンを提供します。
    * どちらのパッケージも Linux と macOS で動作します。
  </Step>

  <Step>
    ## 恒久的なインストール

    ClickHouse をシステムに恒久的にインストールするには、次の手順を実行します。

    **NixOS ユーザーの場合**、`configuration.nix` に以下を追加します。

    ```nix theme={null}
    environment.systemPackages = with pkgs; [
      clickhouse
    ];
    ```

    次に、システムを再ビルドします。

    ```bash theme={null}
    sudo nixos-rebuild switch
    ```

    **NixOS 以外のユーザーの場合**、Nix profile を使ってインストールします。

    ```bash theme={null}
    # 最新の stable バージョンをインストール
    nix profile install nixpkgs#clickhouse

    # または LTS バージョンをインストール
    nix profile install nixpkgs#clickhouse-lts
    ```
  </Step>

  <Step>
    ## ClickHouse server を起動する

    インストール後、ClickHouse server を起動できます。

    ```bash theme={null}
    clickhouse-server
    ```

    デフォルトでは、server は基本的な構成で起動し、`localhost:9000` で待ち受けます。

    NixOS で本番利用する場合は、ClickHouse を system service として構成することをおすすめします。利用可能な構成オプションについては、[NixOS マニュアル](https://search.nixos.org/options?query=clickhouse) を参照してください。
  </Step>

  <Step>
    ## ClickHouse client を起動する

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

    ```bash theme={null}
    clickhouse-client
    ```
  </Step>
</Steps>

<div id="about-nix-package">
  ## Nix パッケージについて
</div>

Nixpkgs の ClickHouse パッケージには、以下が含まれます。

* `clickhouse-server` - ClickHouse データベースサーバー
* `clickhouse-client` - ClickHouse に接続するためのコマンドラインクライアント
* `clickhouse-local` - ローカルファイルに対して SQL クエリを実行するツール
* その他の ClickHouse ユーティリティ

Nixpkgs の ClickHouse パッケージの詳細については、以下を参照してください。

* [Nixpkgs ClickHouse package](https://search.nixos.org/packages?query=clickhouse)
* [NixOS ClickHouse service options](https://search.nixos.org/options?query=clickhouse)