> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.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. **레플리카 고려:** 여러 레플리카에 데이터를 저장할 계획이라면 추정 용량에 레플리카 수를 곱합니다.

    더 자세한 하드웨어 요구 사항은 ["사이징 및 하드웨어 권장 사항"](/ko/guides/oss/best-practices/sizing-and-hardware-recommendations)을 참조하십시오.
  </Step>

  <Step>
    ## Nix를 사용해 ClickHouse 설치

    Nix를 사용하면 시스템에 영구적으로 추가하지 않고도 ClickHouse를 설치할 수 있습니다:

    ```bash theme={null}
    # 최신 안정 버전 설치
    nix shell nixpkgs#clickhouse

    # 또는 LTS 버전 설치
    nix shell nixpkgs#clickhouse-lts
    ```

    이렇게 하면 현재 셸 세션에서 `clickhouse` 실행 파일을 사용할 수 있습니다.

    * `nixpkgs#clickhouse` 패키지는 최신 안정 버전을 제공합니다.
    * `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}
    # 최신 안정 버전 설치
    nix profile install nixpkgs#clickhouse

    # 또는 LTS 버전 설치
    nix profile install nixpkgs#clickhouse-lts
    ```
  </Step>

  <Step>
    ## ClickHouse 서버 시작

    설치 후 ClickHouse 서버를 시작할 수 있습니다:

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

    기본적으로 서버는 기본 구성으로 시작되며 `localhost:9000`에서 연결을 수신 대기합니다.

    NixOS를 프로덕션 환경에서 사용하는 경우 ClickHouse를 시스템 서비스로 구성하는 것이 좋습니다. 사용 가능한 구성 옵션은 [NixOS 설명서](https://search.nixos.org/options?query=clickhouse)를 참조하십시오.
  </Step>

  <Step>
    ## ClickHouse client 시작

    ClickHouse 서버에 연결하려면 새 터미널을 열고 다음을 실행하십시오:

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

<div id="about-nix-package">
  ## Nix 패키지 소개
</div>

Nixpkgs의 ClickHouse 패키지에는 다음이 포함되어 있습니다.

* `clickhouse-server` - ClickHouse 데이터베이스 서버
* `clickhouse-client` - ClickHouse에 연결하기 위한 command-line client
* `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)