Skip to main content
Tell uses ClickHouse for analytics storage — events, logs, sessions, and query results all live here. You need a running ClickHouse instance before Tell can store data.

​
Pick a provider

Self-hosted

Run ClickHouse on your own infrastructure.

ClickHouse Cloud

Managed service from the ClickHouse team.

Tinybird

Managed ClickHouse with a real-time data platform.

​
Self-hosted

1

Install ClickHouse

curl https://clickhouse.com/ | sh
2

Start the server

./clickhouse server
3

Initialize Tell tables

tell clickhouse init myproject
This creates:
  • A database and all required tables
  • A ClickHouse user with the right permissions
  • A config file at configs/myproject.toml with generated credentials
4

Start Tell

tell run -c configs/myproject.toml

​
Using a managed provider

For ClickHouse Cloud or Tinybird, you’ll need the connection details from your provider. Pass them to the init command: 
tell clickhouse init myproject --host your-instance.clickhouse.cloud --port 9440 --secure
The generated config will include your connection details.