mirror of
https://github.com/zitadel/zitadel.git
synced 2025-06-17 12:28:33 +00:00
3c3bce1a6b
* WIP: docs(proxy): describe proxy settings * fix nginx * refactor (docs): deploy and operate sections * chore: ignore package-lock since we use yarn * chore: update to rc1 * chore: broken links * chore: update yarn * docs: move disclaimer to bottom * chore: fix broken links * Update docs/docs/guides/operate/tls_modes.mdx Co-authored-by: Fabi <38692350+hifabienne@users.noreply.github.com> * test caddy files * syntax highlight * traefik example * refactor: docs * refactor * working state * got a working state * remove bar * mark rate limits for update * remove zitadel.ch * fix cases * docs: zitadel quickstart * docs: zitadel quickstart * docs: create app and project * docs: move customer portal docs to guides manage cloud * docs: move customer portal docs to guides manage cloud * docs: move customer portal docs to guides manage cloud * docs: add help me choose in the quickstart * docs: broken links * fix broken links * Update knative guide * styling * docs: support customer portal * update to main instead v2-alpha * use version 2 tag * docs: images * docs: move authentication and authorization guides to integrate * docs: quickstart use examples * docs: lb example * fix broken link * docs: update userinfo endpoints * docs: update userinfo endpoints * fix oidc endpoint * docs: remove unused endpoints in app.module Co-authored-by: Fabi <38692350+hifabienne@users.noreply.github.com> Co-authored-by: Fabienne <fabienne.gerschwiler@gmail.com> Co-authored-by: Livio Amstutz <livio.a@gmail.com>
31 lines
983 B
Markdown
31 lines
983 B
Markdown
---
|
|
title: Custom Domain
|
|
---
|
|
|
|
# Run ZITADEL on a (Sub)domain of Your Choice
|
|
|
|
This guide assumes you are already familiar with [configuring ZITADEL](./configure).
|
|
|
|
You most probably need to configure these fields for making ZITADEL work on your custom domain.
|
|
|
|
## Standard Config
|
|
|
|
For security reasons, ZITADEL only serves requests sent to the expected protocol, host and port.
|
|
If not using localhost as ExternalDomain, ExternalSecure must be true and you need to serve the ZITADEL console over HTTPS.
|
|
|
|
```yaml
|
|
ExternalSecure: true
|
|
ExternalDomain: 'zitadel.my.domain'
|
|
ExternalPort: 443
|
|
```
|
|
|
|
## Database Initialization Steps Config
|
|
|
|
ZITADEL creates random subdomains for each instance created.
|
|
However, for the first instance, this is most probably not the desired behavior.
|
|
In this case the `ExternalDomain`-field of the configuration is used.
|
|
|
|
## Example
|
|
|
|
Go to the [loadbalancing example with Traefik](../../deploy/loadbalancing-example) for seeing a working example configuration.
|