From e62fd56ce00807d97050eb5086970bcbfda47503 Mon Sep 17 00:00:00 2001
From: LeoKaynan <leokaynan@hotmail.com>
Date: Thu, 16 Oct 2025 15:15:33 -0300
Subject: [PATCH] docs: add ClickHouse environment variables and Docker Compose
 setup to v4 migration

---
 docs/migrating-from-v3.mdx | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/docs/migrating-from-v3.mdx b/docs/migrating-from-v3.mdx
index 03f0cae577..d452af22ed 100644
--- a/docs/migrating-from-v3.mdx
+++ b/docs/migrating-from-v3.mdx
@@ -304,6 +304,24 @@ const batch = await batch.retrieve(batchHandle.batchId);
 console.log(batch.runs);
 ```
 
+### ClickHouse
+
+**V4 now uses ClickHouse by default** as the database for storing run traces and analytics data. 
+If you're using Docker Compose, you need to update your `docker-compose.yml` to add the ClickHouse service and configure the webapp to connect to it. Update your configuration according to the [docker-compose.yml file on GitHub](https://github.com/triggerdotdev/trigger.dev/blob/main/hosting/docker/webapp/docker-compose.yml).
+
+You need to configure the following environment variables:
+
+```bash
+# ClickHouse configuration
+CLICKHOUSE_URL=http://default:password@clickhouse:8123?secure=false
+CLICKHOUSE_LOG_LEVEL=info
+
+# Run replication
+RUN_REPLICATION_ENABLED=1
+RUN_REPLICATION_CLICKHOUSE_URL=http://default:password@clickhouse:8123
+RUN_REPLICATION_LOG_LEVEL=info
+```
+
 ### OpenTelemetry
 
 We are now using newer versions of the OpenTelemetry packages. This means that if you're using custom exporters you may need to update the packages: