mirror of
https://github.com/andwati/zitadel.git
synced 2026-11-12 09:05:12 +00:00
599a1ddd78
* Modified quick start guide to reflect the new onboarding changes. * Modified titles to optimize indexing. Left thet titles in title case for now. * Added side bar labels and also made minor changes to titles. * Update docs/docs/apis/openidoauth/endpoints.mdx Co-authored-by: Fabi <[email protected]> --------- Co-authored-by: Fabi <[email protected]>
67 lines
2.4 KiB
Plaintext
67 lines
2.4 KiB
Plaintext
---
|
|
title: Install ZITADEL on MacOS
|
|
sidebar_label: MacOS
|
|
---
|
|
|
|
import Disclaimer from './_disclaimer.mdx'
|
|
import DefaultUser from './_defaultuser.mdx'
|
|
import Next from './_next.mdx'
|
|
import NoteInstanceNotFound from './troubleshooting/_note_instance_not_found.mdx';
|
|
|
|
## Install CockroachDB
|
|
|
|
Download a `cockroach` binary as described [in the CockroachDB docs](https://www.cockroachlabs.com/docs/stable/install-cockroachdb).
|
|
ZITADEL is tested against CockroachDB v22.2.2.
|
|
|
|
## 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} />
|
|
<NoteInstanceNotFound/>
|
|
|
|
## 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} />
|