mirror of
https://github.com/zitadel/zitadel.git
synced 2024-12-24 16:47:47 +00:00
77e3d08f22
* docs: split out self-hosting into section * check for broken links * fix netlify proxy forward * use full path
31 lines
996 B
Markdown
31 lines
996 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](/docs/self-hosting/deploy/loadbalancing-example) for seeing a working example configuration.
|