mirror of
https://github.com/zitadel/zitadel.git
synced 2025-10-29 13:06:44 +00:00
86c124955d
# Which Problems Are Solved - `<details>` tag is rendered in some cases in the docs, instead of rendering a detail section which can be expanded - New API V2 and V3 services where not rendered correctly - The plugin which made it possible to integrate external code files and show them on the docs didn't work anymore # How the Problems Are Solved - remove / from details tag, so it is properly rendered - changing link source from tag to auto - Someone already forked the repository and made it available for docusaurus v3, we integrated the forked version --------- Co-authored-by: Stefan Benz <46600784+stebenz@users.noreply.github.com>
70 lines
3.0 KiB
Plaintext
70 lines
3.0 KiB
Plaintext
import CodeBlock from '@theme/CodeBlock';
|
|
import ExampleZITADELConfigSource from '!!raw-loader!./example-zitadel-config.yaml'
|
|
import ExampleZITADELSecretsSource from '!!raw-loader!./example-zitadel-secrets.yaml'
|
|
import ExampleZITADELInitStepsSource from '!!raw-loader!./example-zitadel-init-steps.yaml'
|
|
|
|
### Configure by Files
|
|
|
|
By executing the commands below, you will download the following files:
|
|
|
|
<details>
|
|
<summary>example-zitadel-config.yaml</summary>
|
|
<CodeBlock language="yaml">{ExampleZITADELConfigSource}</CodeBlock>
|
|
</details>
|
|
|
|
<details>
|
|
<summary>example-zitadel-secrets.yaml</summary>
|
|
<CodeBlock language="yaml">{ExampleZITADELSecretsSource}</CodeBlock>
|
|
</details>
|
|
|
|
<details>
|
|
<summary>example-zitadel-init-steps.yaml</summary>
|
|
<CodeBlock language="yaml">{ExampleZITADELInitStepsSource}</CodeBlock>
|
|
</details>
|
|
|
|
```bash
|
|
# Download and adjust the example configuration file containing standard configuration
|
|
wget https://raw.githubusercontent.com/zitadel/zitadel/main/docs/docs/self-hosting/manage/configure/example-zitadel-config.yaml
|
|
|
|
# Download and adjust the example configuration file containing secret configuration
|
|
wget https://raw.githubusercontent.com/zitadel/zitadel/main/docs/docs/self-hosting/manage/configure/example-zitadel-secrets.yaml
|
|
|
|
# Download and adjust the example configuration file containing database initialization configuration
|
|
wget https://raw.githubusercontent.com/zitadel/zitadel/main/docs/docs/self-hosting/manage/configure/example-zitadel-init-steps.yaml
|
|
|
|
# A single ZITADEL instance always needs the same 32 characters long masterkey
|
|
# If you haven't done so already, you can generate a new one
|
|
# The key must be passed as argument
|
|
ZITADEL_MASTERKEY="$(tr -dc A-Za-z0-9 </dev/urandom | head -c 32)"
|
|
|
|
# Pass zitadel configuration by configuration files
|
|
zitadel start-from-init \
|
|
--config ./example-zitadel-config.yaml \
|
|
--config ./example-zitadel-secrets.yaml \
|
|
--steps ./example-zitadel-init-steps.yaml \
|
|
--masterkey "${ZITADEL_MASTERKEY}"
|
|
```
|
|
|
|
### Configure by Environment Variables
|
|
|
|
```bash
|
|
# Set runtime environment variables
|
|
export ZITADEL_DATABASE_POSTGRES_HOST=my.database
|
|
export ZITADEL_DATABASE_POSTGRES_PORT=5432
|
|
export ZITADEL_DATABASE_POSTGRES_DATABASE=zitadel
|
|
export ZITADEL_DATABASE_POSTGRES_USER_USERNAME=my_zitadel_db_user
|
|
export ZITADEL_DATABASE_POSTGRES_USER_PASSWORD=Secret_DB_User_Password
|
|
export ZITADEL_DATABASE_POSTGRES_USER_SSL_MODE=disable
|
|
export ZITADEL_DATABASE_POSTGRES_ADMIN_USERNAME=root
|
|
export ZITADEL_DATABASE_POSTGRES_ADMIN_SSL_MODE=disable
|
|
export ZITADEL_FIRSTINSTANCE_ORG_HUMAN_USERNAME="root"
|
|
export ZITADEL_FIRSTINSTANCE_ORG_HUMAN_PASSWORD="RootPassword1!"
|
|
|
|
# A single ZITADEL instance always needs the same 32 bytes long masterkey
|
|
# Generate one to a file if you haven't done so already and pass it as environment variable
|
|
tr -dc A-Za-z0-9 </dev/urandom | head -c 32 > ./zitadel-masterkey
|
|
|
|
# Let the zitadel binary read configuration from environment variables
|
|
zitadel start-from-init --masterkey "${ZITADEL_MASTERKEY}" --tlsMode disabled --masterkeyFile ./zitadel-masterkey
|
|
```
|