---
title: "Announcing support for ClickStack in the ClickHouse Terraform provider"
description: "The ClickHouse Terraform provider now supports managing ClickStack resources for both self-hosted deployments and ClickHouse Cloud. Dashboards, alerts, sources, saved searches, connections, and webhooks can be kept in version control, reviewed, and applied with the standard terraform plan and terraform apply workflow, helping keep configurations aligned across environments. ClickStack is implemented as a dedicated service module in the existing ClickHouse/clickhouse provider, using Cloud organization credentials plus a service ID for Managed ClickStack, or an endpoint and personal API access key for self-hosted deployments. The work also extends the API contract with named schemas, consistent integer fields, structured validation errors, and dashboard JSON validation during planning when the validation endpoint is available. Support is beta from provider version 3.25, with import and generated-configuration workflows for existing resources; if validation is unavailable, planning warns and validation is deferred to apply."
---

# Announcing support for ClickStack in the ClickHouse Terraform provider

[Clickhouse](https://yomu.fyi/company/clickhouse) · Aug 14, 2026

**Type:** Announcement

## Summary

The ClickHouse Terraform provider now supports managing ClickStack resources for both self-hosted deployments and ClickHouse Cloud. Dashboards, alerts, sources, saved searches, connections, and webhooks can be kept in version control, reviewed, and applied with the standard terraform plan and terraform apply workflow, helping keep configurations aligned across environments. ClickStack is implemented as a dedicated service module in the existing ClickHouse/clickhouse provider, using Cloud organization credentials plus a service ID for Managed ClickStack, or an endpoint and personal API access key for self-hosted deployments. The work also extends the API contract with named schemas, consistent integer fields, structured validation errors, and dashboard JSON validation during planning when the validation endpoint is available. Support is beta from provider version 3.25, with import and generated-configuration workflows for existing resources; if validation is unavailable, planning warns and validation is deferred to apply.

## Context

ClickStack dashboards and related configuration are often recreated across staging and production, making it necessary to repeat UI changes and check environments manually. ClickStack users requested Terraform support for both self-hosted and Cloud deployments, while existing resources also needed a path into Terraform management.

## Approach / What changed

ClickStack support was added as a dedicated service module within the existing ClickHouse/clickhouse Terraform provider. The implementation uses Cloud organization credentials and a ClickStack service ID for Managed ClickStack, or a self-hosted endpoint and personal API access key. API contract changes provide named schemas, consistent integer fields, structured errors, and dashboard JSON validation during terraform plan when available.

## Takeaways

- ClickStack resources are available in the regular ClickHouse Terraform provider, including dashboards, alerts, sources, saved searches, connections, and webhooks.
- Managed ClickStack uses ClickHouse Cloud credentials and a service ID, while self-hosted ClickStack uses CLICKSTACK\_ENDPOINT and a personal CLICKSTACK\_API\_KEY; the credential configurations should not share one unaliased provider block.
- Existing dashboards can be imported, and Terraform 1.5 or later can generate configuration from import blocks or bulk-exported resources.

**Tags:** [Authentication](https://yomu.fyi/topic/authentication), [Deployment](https://yomu.fyi/topic/deployment), [Developer Experience](https://yomu.fyi/topic/developer-experience), [Open Source](https://yomu.fyi/topic/open-source)

- Source: [Clickhouse](https://clickhouse.com/blog/clickstack-terraform-provider)
- Source URL: https://clickhouse.com/blog/clickstack-terraform-provider
- Ingested by Yomu: 2026-08-29T07:46:21.298Z

[Read original post](https://clickhouse.com/blog/clickstack-terraform-provider)