zitadel/docs/docs/guides/manage/terraform-provider.md

title, sidebar_label

title	sidebar_label
ZITADEL Terraform Provider	Terraform Provider

The ZITADEL Terraform Provider is a tool that allows you to manage ZITADEL resources through Terraform. In other words, it lets you define and provision infrastructure for ZITADEL using Terraform configuration files.

This Terraform provider acts as a bridge, allowing you to manage various aspects of your ZITADEL instance directly through the ZITADEL API, using Terraform's declarative configuration language. It can be used to create, update, and delete ZITADEL resources, as well as to manage the relationships between those resources.

Before you start

Make sure you create the following resources in ZITADEL and have Terraform installed:

• A ZITADEL Instance
• A service user with enough authorization to manage the desired resources

Manage ZITADEL resources through terraform

The full documentation and examples are available on the Terraform registry.

To provide a small guide to where to start:

1. Create a folder where all the terraform files reside.
2. Configure the provider to use the right domain, port and token, with for example a main.tffile as shown in the example.
3. Add a zitadel_org resource to the main.tf file, to create and manage a new organization in the instance, as shown in the example.
4. Add any resources to the organization in the main.tf file, as example a human user.
5. (Optional) Use Terraform in the directory with the command terraform plan, to see which resources would be created and how.
6. Apply the changes and start managing your resources with terraform with terraform apply.
7. (Optional) Delete your created resources with terraform destroy to clean-up.

References

• Deploy ZITADEL in your infrastructure
• ZITADEL CLI
• Configuration Options in ZITADEL