Files

Victor Lee a0e58448e7 add doc for Zitadel configuration (#221 )

* add doc for Zitadel configuration

Add instructions to set up Zitadel

* add link from configuration doc

2026-03-15 21:30:51 +01:00

1.1 KiB

Raw Blame History

Zitadel

Zitadel configuration

From the Zitadel home screen, go to Projects and click Create New Project
Enter "Home Assistant" or your preferred name
Click on New to create a new Application
Enter "Home Assistant" or your preferred name
Select Web and Continue
Select CODE (not PKCE) and Continue
Enter https://hass.example.com/auth/oidc/callback as the Redirect URI, and click Continue
Click Create. A pop-up will dispay the ClientId and ClientSecret

Home Assistant configuration

Important

For HTTPS configuration make sure to have a public valid SSL certificate (i.e. LetsEncrypt), if not, use HTTP instead (more insecure) or add your Zitadel CA certificate to network.tls_ca_path.

After installing this HACS addon, edit your configuration.yaml file and add:

auth_oidc:
  client_id: <ClientID from above>
  client_secret: <ClientSecret from above>
  discovery_url: "https://auth.example.com/.well-known/openid-configuration"

Restart Home Assistant and go to https://hass.example.com/auth/oidc/welcome

1.1 KiB Raw Blame History

Zitadel

Zitadel configuration

Home Assistant configuration

1.1 KiB

Raw Blame History