> ## 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 NixOS et avec Nix

# Installer ClickHouse sur NixOS

> ClickHouse est disponible dans le dépôt Nixpkgs et peut être installé avec Nix sur **Linux** et **macOS**.

<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>
    ## Installer ClickHouse avec Nix

    Vous pouvez utiliser Nix pour installer ClickHouse sans l’ajouter définitivement à votre système :

    ```bash theme={null}
    # Install the latest stable version
    nix shell nixpkgs#clickhouse

    # Or install the LTS version
    nix shell nixpkgs#clickhouse-lts
    ```

    Le binaire `clickhouse` sera alors disponible dans votre session shell actuelle.

    * Le paquet `nixpkgs#clickhouse` fournit la dernière version stable.
    * Le paquet `nixpkgs#clickhouse-lts` fournit la version LTS.
    * Les deux paquets fonctionnent sur Linux et macOS.
  </Step>

  <Step>
    ## Installation permanente

    Pour installer ClickHouse de façon permanente sur votre système :

    **Pour les utilisateurs de NixOS**, ajoutez ceci à votre `configuration.nix` :

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

    Recompilez ensuite votre système :

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

    **Pour les utilisateurs d’un autre système que NixOS**, installez-le avec le profil Nix :

    ```bash theme={null}
    # Install the latest stable version
    nix profile install nixpkgs#clickhouse

    # Or install the LTS version
    nix profile install nixpkgs#clickhouse-lts
    ```
  </Step>

  <Step>
    ## Démarrer le serveur ClickHouse

    Après l’installation, vous pouvez démarrer le serveur ClickHouse :

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

    Par défaut, le serveur démarre avec une configuration de base et écoute sur `localhost:9000`.

    Pour une utilisation en production sur NixOS, vous pouvez configurer ClickHouse comme service système. Consultez le [manuel NixOS](https://search.nixos.org/options?query=clickhouse) pour voir les options de configuration disponibles.
  </Step>

  <Step>
    ## Démarrer le client ClickHouse

    Pour vous connecter au serveur ClickHouse, ouvrez un nouveau terminal et exécutez :

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

<div id="about-nix-package">
  ## À propos du paquet Nix
</div>

Le paquet ClickHouse dans Nixpkgs comprend :

* `clickhouse-server` - Le serveur de base de données ClickHouse
* `clickhouse-client` - Le client en ligne de commande pour se connecter à ClickHouse
* `clickhouse-local` - Un outil permettant d’exécuter des requêtes SQL sur des fichiers locaux
* D’autres utilitaires ClickHouse

Pour en savoir plus sur le paquet ClickHouse dans Nixpkgs, consultez :

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