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

> Installer ClickHouse sur Linux Debian/Ubuntu

# Installer ClickHouse sur Debian/Ubuntu

> Il est recommandé d’utiliser les paquets `deb` officiels précompilés pour **Debian** ou **Ubuntu**.

<Steps>
  <Step>
    ## Consulter les recommandations

    Avant d’installer ClickHouse, consultez les recommandations suivantes :

    * **Swap :** Désactivez le swap du système d’exploitation dans les environnements de production.
    * **Espace disque :** Le binaire ClickHouse nécessite au moins 2,5 Go d’espace disque pour l’installation.
    * **Réseau :** Pour les déploiements distribués (en cluster), utilisez un réseau d’au moins 10 Gbit/s. La bande passante réseau est essentielle pour traiter des requêtes distribuées avec de grands volumes de données intermédiaires, ainsi que pour la réplication.

    **Estimation des besoins de stockage**

    Pour estimer l’espace disque nécessaire à vos données :

    1. **Estimez le volume de données :** Prenez un échantillon de vos données et calculez la taille moyenne d’une ligne, puis multipliez-la par le nombre de lignes que vous prévoyez de stocker.
    2. **Appliquez le coefficient de compression :** Chargez un échantillon dans ClickHouse et comparez la taille des données d’origine à celle de la table stockée. Les données clickstream, par exemple, sont généralement compressées de 6 à 10 fois.
    3. **Tenez compte des répliques :** Si vous prévoyez de stocker les données dans plusieurs répliques, multipliez le volume estimé par le nombre de répliques.

    Pour des exigences matérielles plus détaillées, consultez ["Dimensionnement et recommandations matérielles"](/fr/guides/oss/best-practices/sizing-and-hardware-recommendations)
  </Step>

  <Step>
    ## Configurer le dépôt Debian

    Pour installer ClickHouse, exécutez les commandes suivantes :

    ```bash theme={null}
    # Installer les paquets prérequis
    sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

    # Télécharger la clé GPG de ClickHouse et la stocker dans le trousseau de clés
    curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg

    # Obtenir l'architecture du système
    ARCH=$(dpkg --print-architecture)

    # Ajouter le dépôt ClickHouse aux sources apt
    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

    # Mettre à jour les listes de paquets apt
    sudo apt-get update
    ```

    * Vous pouvez remplacer `stable` par `lts` pour utiliser différents [types de versions](/fr/resources/support-center/knowledge-base/setup-installation/production) selon vos besoins.
    * Vous pouvez télécharger et installer les paquets manuellement depuis [packages.clickhouse.com](https://packages.clickhouse.com/deb/pool/main/c/).

    <br />

    <Accordion title="Méthode d’installation des paquets deb pour les anciennes distributions">
      ```bash theme={null}
      # Installer les paquets prérequis
      sudo apt-get install apt-transport-https ca-certificates dirmngr

      # Ajouter la clé GPG de ClickHouse pour authentifier les paquets
      sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754

      # Ajouter le dépôt ClickHouse aux sources apt
      echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
          /etc/apt/sources.list.d/clickhouse.list
          
      # Mettre à jour les listes de paquets apt
      sudo apt-get update

      # Installer les paquets ClickHouse server et client
      sudo apt-get install -y clickhouse-server clickhouse-client

      # Démarrer le service ClickHouse server
      sudo service clickhouse-server start

      # Lancer le client en ligne de commande ClickHouse
      clickhouse-client # ou "clickhouse-client --password" si vous avez configuré un mot de passe.
      ```
    </Accordion>
  </Step>

  <Step>
    ## Installer ClickHouse server et le client

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

  <Step>
    ## Démarrer ClickHouse

    Pour démarrer ClickHouse server, exécutez :

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

    Pour démarrer le client ClickHouse, exécutez :

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

    Si vous avez configuré un mot de passe pour votre serveur, vous devrez exécuter :

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

  <Step>
    ## Installer ClickHouse Keeper autonome

    <Tip>
      Dans les environnements de production, nous vous recommandons vivement d’exécuter ClickHouse Keeper sur des nœuds dédiés.
      Dans les environnements de test, si vous décidez d’exécuter ClickHouse Server et ClickHouse Keeper sur le même serveur,
      vous n’avez pas besoin d’installer ClickHouse Keeper, car il est inclus avec ClickHouse server.
    </Tip>

    Pour installer `clickhouse-keeper` sur des serveurs ClickHouse Keeper autonomes, exécutez :

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

  <Step>
    ## Activer et démarrer 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">
  ## Paquets
</div>

Les différents paquets deb disponibles sont détaillés ci-dessous :

| Package                        | Description                                                                                                                                                                                                                                                                                                   |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `clickhouse-common-static`     | Installe les fichiers binaires compilés de ClickHouse.                                                                                                                                                                                                                                                        |
| `clickhouse-server`            | Crée un lien symbolique vers `clickhouse-server` et installe la configuration par défaut du serveur.                                                                                                                                                                                                          |
| `clickhouse-client`            | Crée un lien symbolique vers `clickhouse-client` et d'autres outils associés au client, et installe les fichiers de configuration du client.                                                                                                                                                                  |
| `clickhouse-common-static-dbg` | Installe les fichiers binaires compilés de ClickHouse avec les informations de débogage.                                                                                                                                                                                                                      |
| `clickhouse-keeper`            | Sert à installer ClickHouse Keeper sur des nœuds ClickHouse Keeper dédiés. Si vous exécutez ClickHouse Keeper sur le même serveur que le ClickHouse server, vous n'avez pas besoin d'installer ce paquet. Installe ClickHouse Keeper ainsi que les fichiers de configuration par défaut de ClickHouse Keeper. |

<br />

<Info>
  Si vous devez installer une version spécifique de ClickHouse, vous devez installer tous les paquets avec la même version :
  `sudo apt-get install clickhouse-server=21.8.5.7 clickhouse-client=21.8.5.7 clickhouse-common-static=21.8.5.7`
</Info>