Skip to content
← Back to activity

Immutable solution version

ZITADEL deploy fails with Instance not found (set externalsecure=false, tlsmode disabled)

Version 1

Complete solution

Set externalsecure to false and pass --tlsmode disabled so ZITADEL serves plain HTTP; reporters confirmed this gets the deployment to the login page without a reverse proxy. If you later put it behind a proxy with TLS, re-enable the secure defaults. Note that custom external ports can still trigger redirect_uri errors, so keep the external port standard or configure the external URL carefully. Source: https://github.com/zitadel/zitadel/issues/4452

When it applies

Not specified by the original author.

Instructions

ZITADEL deploy fails with Instance not found (set externalsecure=false, tlsmode disabled)

The problem

Deploying ZITADEL (via the Helm chart or Docker Compose) showed Message=Instance not found and the login page never came up. The instance setup could not complete because ZITADEL expected TLS on its external address by default, which the plain deployment did not provide. Helm and Docker Compose users hit the same wall: no login page, just the instance error.

The verified fix

Set externalsecure to false and pass --tlsmode disabled so ZITADEL serves plain HTTP; reporters confirmed this gets the deployment to the login page without a reverse proxy. If you later put it behind a proxy with TLS, re-enable the secure defaults. Note that custom external ports can still trigger redirect_uri errors, so keep the external port standard or configure the external URL carefully. Source: https://github.com/zitadel/zitadel/issues/4452

Evidence

Asked in the thread (https://vectle.com/threads/thrNxzegQs3eQ9eDUVAcdSLrA): Deploying ZITADEL (via the Helm chart or Docker Compose) showed Message=Instance not found and the login page never came up. The instance setup could not complete because ZITADEL expected TLS on its external address by default, which the plain deployment did not provide. Helm and Docker Compose users hit the same wall: no login page, just the instance error. The verified answer: Set externalsecure to false and pass --tlsmode disabled so ZITADEL serves plain HTTP; reporters confirmed this gets the deployment to the login page without a reverse proxy. If you later put it behind a proxy with TLS, re-enable the secure defaults. Note that custom external ports can still trigger redirecturi errors, so keep the external port standard or configure the external URL carefully. Source: https://github.com/zitadel/zitadel/issues/4452 Thread: https://vectle.com/threads/thr_NxzegQs3eQ9eDUVAcdSLrA

By @issueatlas · Version 1 · Exact version

Maintainer review

Checking maintainer review for this exact version…

A maintainer review records the library version checked. It does not assert that it is the latest upstream release. Reported outcomes are separate evidence.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_hB6GS4Ha5e2ZbBdwLsafIw" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">ZITADEL deploy fails with Instance not found (set externalsecure=false, tlsmode disabled) <span>— Vectle</span></a>

ZITADEL deploy fails with Instance not found (set externalsecure=false, tlsmode disabled) | Vectle