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

> Red Hat/CentOS Linux에 ClickHouse 설치

# rpm 기반 Linux 배포판에 ClickHouse 설치

<div id="from-rpm-packages">
  # rpm 기반 배포판에 ClickHouse 설치
</div>

> **CentOS**, **RedHat** 및 기타 모든 rpm 기반
> Linux 배포판에서는 공식 사전 컴파일 `rpm` 패키지 사용을 권장합니다.

<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>
    ## RPM 리포지토리 설정

    다음 명령을 실행하여 공식 리포지토리를 추가합니다.

    ```bash theme={null}
    sudo yum install -y yum-utils
    sudo yum-config-manager --add-repo https://packages.clickhouse.com/rpm/clickhouse.repo
    ```

    `zypper` 패키지 관리자(openSUSE, SLES)를 사용하는 시스템에서는 다음 명령을 실행합니다.

    ```bash theme={null}
    sudo zypper addrepo -r https://packages.clickhouse.com/rpm/clickhouse.repo -g
    sudo zypper --gpg-auto-import-keys refresh clickhouse-stable
    ```

    아래 단계에서는 사용 중인 패키지 관리자에 따라 `yum install` 대신
    `zypper install`을 사용할 수 있습니다.
  </Step>

  <Step>
    ## ClickHouse 서버 및 clickhouse client 설치

    ClickHouse를 설치하려면 다음 명령을 실행합니다.

    ```bash theme={null}
    sudo yum install -y clickhouse-server clickhouse-client
    ```

    * 필요에 따라 다른 [릴리스 유형](/ko/resources/support-center/knowledge-base/setup-installation/production)을 사용하려면 `stable` 대신 `lts`를 사용할 수 있습니다.
    * [packages.clickhouse.com/rpm](https://packages.clickhouse.com/rpm/stable)에서 패키지를 수동으로 다운로드하여 설치할 수도 있습니다.
    * 특정 버전을 지정하려면 패키지 이름 끝에 `-$version`을 추가합니다. 예시는 다음과 같습니다.

    ```bash theme={null}
    sudo yum install clickhouse-server-22.8.7.34
    ```
  </Step>

  <Step>
    ## ClickHouse 서버 시작

    ClickHouse 서버를 시작하려면 다음 명령을 실행합니다.

    ```bash theme={null}
    sudo systemctl enable clickhouse-server
    sudo systemctl start clickhouse-server
    sudo systemctl status clickhouse-server
    ```

    clickhouse client를 시작하려면 다음 명령을 실행합니다.

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

    서버에 비밀번호를 설정한 경우에는 다음 명령을 실행해야 합니다.

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

  <Step>
    ## standalone ClickHouse Keeper 설치

    <Tip>
      프로덕션 환경에서는 전용 노드에서 ClickHouse Keeper를 실행할 것을 강력히 권장합니다.
      테스트 환경에서 ClickHouse 서버와 ClickHouse Keeper를 동일한 서버에서 실행하는 경우,
      ClickHouse 서버에 ClickHouse Keeper가 포함되어 있으므로 별도로 설치할 필요가 없습니다.
    </Tip>

    standalone ClickHouse Keeper 서버에 `clickhouse-keeper`를 설치하려면 다음 명령을 실행합니다.

    ```bash theme={null}
    sudo yum install -y clickhouse-keeper
    ```
  </Step>

  <Step>
    ## ClickHouse Keeper 활성화 및 시작

    ```bash theme={null}
    sudo systemctl enable clickhouse-keeper
    sudo systemctl start clickhouse-keeper
    sudo systemctl status clickhouse-keeper
    ```
  </Step>
</Steps>
