ClickHouse 25.5.6 is required for SigNoz v0.94.0 and later.
Upgrade your ClickHouse server to version 25.5.6 before installing or running SigNoz v0.94.0 or any newer release. Running SigNoz with an older ClickHouse version is not supported.
Upgrade Instructions
Docker Standalone
Before upgrading, add the following environment variable to your clickhouse service:
services:
clickhouse:
image: clickhouse/clickhouse-server:25.5.6
environment:
- CLICKHOUSE_SKIP_SETUP_USER=1
Then follow the standard upgrade guide.
Docker Swarm
Before upgrading, ensure your Swarm stack's clickhouse service sets the image and env var as below, then follow the Standard Upgrade Guide.
services:
clickhouse:
image: clickhouse/clickhouse-server:25.5.6
environment:
- CLICKHOUSE_SKIP_SETUP_USER=1
Then follow the standard upgrade guide.
Kubernetes
Follow the standard upgrade guide. Ensure your ClickHouse version is 25.5.6 (set the ClickHouse image tag to 25.5.6) before starting SigNoz v0.94.0.
If you encounter issues with ClickHouse not updating or pods failing during the upgrade, you can manually patch the ClickHouse resource using the following commands:
kubectl patch chi -n <YOUR_SIGNOZ_INSTALLATION_NAMESPACE> signoz-clickhouse --type='json' \
-p='[{"op":"replace","path":"/spec/templates/podTemplates/0/spec/containers/0/image","value":"docker.io/clickhouse/clickhouse-server:25.5.6"}]'
kubectl patch chi -n <YOUR_SIGNOZ_INSTALLATION_NAMESPACE> signoz-clickhouse --type='merge' \
-p '{"spec":{"restart":"RollingUpdate"}}'
Linux Binary Installation
Follow the standard upgrade guide, ensuring your ClickHouse is on 25.5.6 before starting SigNoz v0.94.0.
Getting Help
If you need assistance with the upgrade:
