Skip to content

Deployment Overview of ClickHouse on Server

Prerequisites and Basic Requirements

To ensure a successful installation, the server must meet the following requirements:

  • Operating System: Ubuntu (versions prior to 24.04 or version 24.04).

  • Privileges: Root access or sudo privileges are required for package management and service configuration.

  • Dependencies: For Ubuntu 24.04, the python3-pexpect package is required during the installation process to handle interactive prompts.

  • Network Access: The server must have outbound internet access to download the ClickHouse installation script from https://clickhouse.com/.

Application Installation Process

The application is installed using an official installation script provided by the developer. The process follows these steps:

  1. System Update: The package lists are updated via apt-get update to ensure all dependencies are current.

  2. Script Acquisition: An installation script is downloaded from https://clickhouse.com/ and stored in the /root directory.

  3. Automated Installation: The installer is executed using the command:

    /root/clickhouse install
    
    During this process, the following configurations are applied automatically:

  4. A password for the default user is set.

  5. Remote connections are enabled to allow the server to accept external requests.

  6. Service Initialization: Once the installation is complete, the ClickHouse services are started using the clickhouse start command.

Access Rights and Security

  • User Authentication: The default user is configured with a specific password during the installation phase to secure database access.

  • Network Security: The installer configures the server to accept remote connections; ensure that your local firewall (e.g., ufw) is configured to allow traffic only on required ClickHouse ports.

Application Update Instructions

To update the ClickHouse application, you must re-run the installation script to apply any new versions or patches:

  1. Download the latest installer:

    curl https://clickhouse.com/ | sh
    

  2. Execute the installation command:

    /root/clickhouse install
    

Available Ports for Connection

While specific ports may vary based on custom configuration, ClickHouse typically utilizes the following default port for client connections:

  • TCP Port: 9000 (Default)

  • HTTP Port: 8123 (Default)

question_mark
Is there anything I can help you with?
question_mark
AI Assistant ×