ClickHouse/docs/en/development/build-cross-riscv.md

---
slug: /en/development/build-cross-riscv
sidebar_position: 68
title: How to Build ClickHouse on Linux for RISC-V 64 Architecture 
sidebar_label: Build on Linux for RISC-V 64
---

As of writing (11.11.2021) building for risc-v considered to be highly experimental. Not all features can be enabled.

This is for the case when you have Linux machine and want to use it to build `clickhouse` binary that will run on another Linux machine with RISC-V 64 CPU architecture. This is intended for continuous integration checks that run on Linux servers.

The cross-build for RISC-V 64 is based on the [Build instructions](../development/build.md), follow them first.

## Install Clang-16

Follow the instructions from https://apt.llvm.org/ for your Ubuntu or Debian setup or do
```
sudo bash -c "$(wget -O - https://apt.llvm.org/llvm.sh)"
```

## Build ClickHouse {#build-clickhouse}

``` bash
cd ClickHouse
mkdir build-riscv64
CC=clang-16 CXX=clang++-16 cmake . -Bbuild-riscv64 -G Ninja -DCMAKE_TOOLCHAIN_FILE=cmake/linux/toolchain-riscv64.cmake -DGLIBC_COMPATIBILITY=OFF -DENABLE_LDAP=OFF  -DOPENSSL_NO_ASM=ON -DENABLE_JEMALLOC=ON -DENABLE_PARQUET=OFF -DENABLE_GRPC=OFF -DENABLE_HDFS=OFF -DENABLE_MYSQL=OFF
ninja -C build-riscv64
```

The resulting binary will run only on Linux with the RISC-V 64 CPU architecture.
Initial support for risc-v Make ClickHouse compilable and runnable on risc-v 64 So far only basic functionality was tested (on real hw), clickhouse server runs, exceptions works, client works, simple tests works. What doesn't work: 1. traces - they are always empty 2. system.stack_trace only have first frame 2021-11-11 18:18:41 +00:00			`---`
add slugs 2022-08-28 14:53:34 +00:00			`slug: /en/development/build-cross-riscv`
Removed /ja folder, cleaned up /ru markdown 2022-04-09 13:29:05 +00:00			`sidebar_position: 68`
replace symlinks with includes 2022-08-28 15:58:59 +00:00			`title: How to Build ClickHouse on Linux for RISC-V 64 Architecture`
Removed /ja folder, cleaned up /ru markdown 2022-04-09 13:29:05 +00:00			`sidebar_label: Build on Linux for RISC-V 64`
Initial support for risc-v Make ClickHouse compilable and runnable on risc-v 64 So far only basic functionality was tested (on real hw), clickhouse server runs, exceptions works, client works, simple tests works. What doesn't work: 1. traces - they are always empty 2. system.stack_trace only have first frame 2021-11-11 18:18:41 +00:00			`---`

			`As of writing (11.11.2021) building for risc-v considered to be highly experimental. Not all features can be enabled.`

			This is for the case when you have Linux machine and want to use it to build `clickhouse` binary that will run on another Linux machine with RISC-V 64 CPU architecture. This is intended for continuous integration checks that run on Linux servers.

			`The cross-build for RISC-V 64 is based on the [Build instructions](../development/build.md), follow them first.`

Update build-cross-riscv.md 2023-05-12 00:18:43 +00:00			`## Install Clang-16`
Initial support for risc-v Make ClickHouse compilable and runnable on risc-v 64 So far only basic functionality was tested (on real hw), clickhouse server runs, exceptions works, client works, simple tests works. What doesn't work: 1. traces - they are always empty 2. system.stack_trace only have first frame 2021-11-11 18:18:41 +00:00
			`Follow the instructions from https://apt.llvm.org/ for your Ubuntu or Debian setup or do`
			```
			`sudo bash -c "$(wget -O - https://apt.llvm.org/llvm.sh)"`
			```

			`## Build ClickHouse {#build-clickhouse}`

			``` bash
			`cd ClickHouse`
			`mkdir build-riscv64`
Force libunwind usage (removes gcc_eh support) libunwind is reentrant and signal safe, and works faster then then gcc_eh (plus it has some custom patches for problems that have been found during it's usage in ClickHouse). gcc_eh may be missing in the system (if gcc was not installed), and even if it exists clickhouse uses -nodefaultlibs, so some care should be made to make it work. Also this library is tiny and there shouln't be any problem to require it always (there is already tendency to require some contrib libraries, i.e. poco). Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com> 2023-05-03 08:09:11 +00:00			`CC=clang-16 CXX=clang++-16 cmake . -Bbuild-riscv64 -G Ninja -DCMAKE_TOOLCHAIN_FILE=cmake/linux/toolchain-riscv64.cmake -DGLIBC_COMPATIBILITY=OFF -DENABLE_LDAP=OFF -DOPENSSL_NO_ASM=ON -DENABLE_JEMALLOC=ON -DENABLE_PARQUET=OFF -DENABLE_GRPC=OFF -DENABLE_HDFS=OFF -DENABLE_MYSQL=OFF`
Initial support for risc-v Make ClickHouse compilable and runnable on risc-v 64 So far only basic functionality was tested (on real hw), clickhouse server runs, exceptions works, client works, simple tests works. What doesn't work: 1. traces - they are always empty 2. system.stack_trace only have first frame 2021-11-11 18:18:41 +00:00			`ninja -C build-riscv64`
			```

			`The resulting binary will run only on Linux with the RISC-V 64 CPU architecture.`