Install Guide

How to install and start using the ClickHouse Altinity Stable Release

Installing the ClickHouse Altinity Stable Release takes just a few minutes.

General Installation Instructions

When installing or upgrading from a previous version of ClickHouse Altinity Stable Release, review the Release Notes for the version to install and upgrade to before starting. This will inform you of additional steps or requirements of moving from one version to the next.

Part of the installation procedures has you specify the version to install. The Release Notes lists the version numbers available for installation.

Instructions here are provided for DEB packages or RPM packages.

Installation Instructions: DEB packages

  1. Configure repository if not already configured:

    sudo apt-get install dirmngr
    sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4
    
    echo "deb http://repo.clickhouse.tech/deb/stable/ main/" | sudo tee \
        /etc/apt/sources.list.d/clickhouse.list
    sudo apt-get update
    
  2. Install packages. We recommend you install the specific ClickHouse versions by specifying it in the install commands. The version numbers are listed in the Release Notes.

    # Use preferred Altinity stable version.
    version=20.8.7.15
    sudo apt-get install -y clickhouse-server=$version \
    clickhouse-client=$version \
    clickhouse-common-static=$version
    
  3. Restart server. Installed packages are not applied the already running server. It makes it convenient to install packages first and restart later when convenient.

    sudo service clickhouse-server restart
    clickhouse-client
    

Installation Instructions: RPM packages

  1. Configure repository, if not configured:

    curl -s https://packagecloud.io/install/repositories/Altinity/clickhouse-altinity-stable/script.rpm.sh | sudo bash
    
  2. Install packages. We recommend you install specific ClickHouse versions specified by the stable release blog articles. If the version number is omitted, you will get the latest build from the repository, which may not be yet certified as Altinity Stable.

    # Use preferred Altinity stable version.
    version=20.8.7.15
    sudo yum install -y clickhouse-server=$version clickhouse-client=$version
    
  3. Restart server. Installed packages are not applied the already running server. It makes it convenient to install packages first and restart later when convenient.

    sudo /etc/init.d/clickhouse-server restart