> ## 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.

> Debian/Ubuntu Linux에 ClickHouse 설치하기

# Debian/Ubuntu에 ClickHouse 설치하기

<div id="install-from-deb-packages">
  # Debian/Ubuntu에 ClickHouse 설치
</div>

> **Debian** 또는 **Ubuntu**에서는 공식 사전 컴파일 `deb` 패키지 사용을 권장합니다.

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

    ClickHouse를 설치하려면 다음 명령을 실행하세요.

    ```bash theme={null}
    # 필수 패키지 설치
    sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

    # ClickHouse GPG 키를 다운로드하여 키링에 저장
    curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg

    # 시스템 아키텍처 확인
    ARCH=$(dpkg --print-architecture)

    # apt 소스에 ClickHouse 리포지토리 추가
    echo "deb [signed-by=/usr/share/keyrings/clickhouse-keyring.gpg arch=${ARCH}] https://packages.clickhouse.com/deb stable main" | sudo tee /etc/apt/sources.list.d/clickhouse.list

    # apt 패키지 목록 업데이트
    sudo apt-get update
    ```

    * 필요에 따라 다른 [릴리스 유형](/ko/resources/support-center/knowledge-base/setup-installation/production)을 사용하려면 `stable`을 `lts`로 바꿀 수 있습니다.
    * [packages.clickhouse.com](https://packages.clickhouse.com/deb/pool/main/c/)에서 패키지를 수동으로 다운로드하여 설치할 수도 있습니다.

    <br />

    <Accordion title="이전 배포판용 deb 패키지 설치 방법">
      ```bash theme={null}
      # 필수 패키지 설치
      sudo apt-get install apt-transport-https ca-certificates dirmngr

      # 패키지 인증을 위해 ClickHouse GPG 키 추가
      sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754

      # apt 소스에 ClickHouse 리포지토리 추가
      echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
          /etc/apt/sources.list.d/clickhouse.list
          
      # apt 패키지 목록 업데이트
      sudo apt-get update

      # ClickHouse 서버 및 클라이언트 패키지 설치
      sudo apt-get install -y clickhouse-server clickhouse-client

      # ClickHouse 서버 서비스 시작
      sudo service clickhouse-server start

      # ClickHouse 명령줄 클라이언트 실행
      clickhouse-client # 또는 비밀번호를 설정한 경우 "clickhouse-client --password"
      ```
    </Accordion>
  </Step>

  <Step>
    ## ClickHouse 서버 및 클라이언트 설치

    ```bash theme={null}
    sudo apt-get install -y clickhouse-server clickhouse-client
    ```
  </Step>

  <Step>
    ## ClickHouse 시작

    ClickHouse 서버를 시작하려면 다음을 실행하세요.

    ```bash theme={null}
    sudo service clickhouse-server start
    ```

    ClickHouse 클라이언트를 시작하려면 다음을 실행하세요.

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

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

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

  <Step>
    ## 독립형 ClickHouse Keeper 설치

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

    독립형 ClickHouse Keeper 서버에 `clickhouse-keeper`를 설치하려면 다음을 실행하세요.

    ```bash theme={null}
    sudo apt-get 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>

<div id="packages">
  ## 패키지
</div>

사용 가능한 deb 패키지는 아래와 같습니다.

| Package                        | Description                                                                                                                                                                              |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `clickhouse-common-static`     | 컴파일된 ClickHouse 바이너리 파일을 설치합니다.                                                                                                                                                          |
| `clickhouse-server`            | `clickhouse-server`용 심볼릭 링크를 생성하고 기본 서버 구성을 설치합니다.                                                                                                                                       |
| `clickhouse-client`            | `clickhouse-client` 및 기타 클라이언트 관련 도구용 심볼릭 링크를 생성하고 클라이언트 설정 파일을 설치합니다.                                                                                                                   |
| `clickhouse-common-static-dbg` | 디버그 정보가 포함된 컴파일된 ClickHouse 바이너리 파일을 설치합니다.                                                                                                                                              |
| `clickhouse-keeper`            | 전용 ClickHouse Keeper 노드에 ClickHouse Keeper를 설치할 때 사용합니다. ClickHouse 서버와 동일한 서버에서 ClickHouse Keeper를 실행하는 경우에는 이 패키지를 설치할 필요가 없습니다. ClickHouse Keeper와 기본 ClickHouse Keeper 설정 파일을 설치합니다. |

<br />

<Info>
  특정 버전의 ClickHouse를 설치해야 하는 경우 모든 패키지를 동일한 버전으로 설치해야 합니다.
  `sudo apt-get install clickhouse-server=21.8.5.7 clickhouse-client=21.8.5.7 clickhouse-common-static=21.8.5.7`
</Info>