docs: split out self-hosting into new section (#4903)

* docs: split out self-hosting into section * check for broken links * fix netlify proxy forward * use full path
2026-11-12 09:05:12 +00:00 · 2022-12-20 11:17:27 +01:00
parent 3c26b0bae4
commit 77e3d08f22
56 changed files with 111 additions and 90 deletions
@@ -0,0 +1,63 @@
+---
+title: MacOS
+---
+
+import Disclaimer from './_disclaimer.mdx'
+import DefaultUser from './_defaultuser.mdx'
+import Next from './_next.mdx'
+
+## Install CockroachDB
+
+Download a `cockroach` binary as described [in the CockroachDB docs](https://www.cockroachlabs.com/docs/v22.1/install-cockroachdb).
+ZITADEL is tested against CockroachDB v22.1.0.
+
+## Run CockroachDB
+
+```bash
+cockroach start-single-node --insecure --background --http-addr :9090 --listen-addr=localhost
+```
+
+## Install ZITADEL
+
+### Homebrew
+
+```bash
+brew install zitadel/tap/zitadel
+```
+
+### Download from GitHub
+
+Download the ZITADEL release according to your architecture from [Github](https://github.com/zitadel/zitadel/releases/latest)
+
+## Unpack the archive
+move to your download location and unpack the archive
+
+```bash
+#unpack and copy to /usr/local/bin
+LATEST=$(curl -i https://github.com/zitadel/zitadel/releases/latest | grep location: | cut -d '/' -f 8 | tr -d '\r'); wget -qO-  https://github.com/zitadel/zitadel/releases/download/$LATEST/zitadel_Darwin_$(uname -m).tar.gz  | tar -xJ zitadel && sudo mv zitadel /usr/local/bin
+```
+
+## Run ZITADEL
+
+```bash
+ZITADEL_EXTERNALSECURE=false zitadel start-from-init --masterkey "MasterkeyNeedsToHave32Characters" --tlsMode disabled
+```
+
+<DefaultUser components={props.components} />
+
+## VideoGuide
+<iframe width="100%" height="315" src="https://www.youtube.com/embed/Ob-kBzmezeg" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+
+### Setup ZITADEL with a service account
+
+```bash
+ZITADEL_EXTERNALSECURE=false ZITADEL_FIRSTINSTANCE_MACHINEKEYPATH=/tmp/zitadel-admin-sa.json ZITADEL_FIRSTINSTANCE_ORG_MACHINE_MACHINE_USERNAME=zitadel-admin-sa ZITADEL_FIRSTINSTANCE_ORG_MACHINE_MACHINE_NAME=Admin ZITADEL_FIRSTINSTANCE_ORG_MACHINE_MACHINEKEY_TYPE=1 zitadel start-from-init --masterkey "MasterkeyNeedsToHave32Characters" --tlsMode disabled
+
+# then you can move your machine key
+mv /tmp/zitadel-admin-sa.json $HOME/zitadel-admin-sa.json
+```
+
+This key can be used to provision resources with for example [Terraform](/docs/guides/manage/terraform/basics.md).
+
+<Next components={props.components} />
+<Disclaimer components={props.components} />