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

2

Start the server

3

Initialize Tell tables

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

​
Using a managed provider

For ClickHouse Cloud or Tinybird, you’ll need the connection details from your provider. Pass them to the init command:
The generated config will include your connection details.