Files
Raúl MarínandClaude Haiku 4.5 4b2fe5e5bc Fix grammar issues in Docker README files
- Rephrase server instance credential sentence for clarity
- Rewrite comma splice in bare image bullet point

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-09-25 17:16:29 +02:00
..

The bare minimum ClickHouse Docker image.

It is intended as a showcase to check the amount of implicit dependencies of ClickHouse on the OS in addition to the OS kernel.

Example usage:

./prepare
docker build --tag clickhouse-bare .

Run clickhouse-local:

docker run -it --rm --network host clickhouse-bare /clickhouse local --query "SELECT 1"

Run clickhouse-client in interactive mode:

docker run -it --rm --network host clickhouse-bare /clickhouse client

Run clickhouse-server:

docker run -it --rm --network host clickhouse-bare /clickhouse server

It can be also run in chroot instead of Docker (first edit the prepare script to enable proc):

sudo chroot . /clickhouse server

What does it miss?

  • Creation of clickhouse user to run the server.
  • VOLUME for server.
  • For most details, see other docker images for comparison.

A binary built with musl (cmake -DCMAKE_TOOLCHAIN_FILE=cmake/linux/toolchain-x86_64-musl.cmake) needs none of the files installed by the prepare script: it is statically linked, CA certificates are embedded into the binary and used when none are found on the filesystem, DNS works without /etc/resolv.conf (well-known public DNS resolvers are used when the file does not exist), and localhost resolves to loopback per RFC 6761 even without /etc/hosts.