Linux
Install CockroachDB
Download a cockroach
binary as described in the CockroachDB docs.
ZITADEL is tested against CockroachDB v22.1.0 and Ubuntu 20.04.
Run CockroachDB
cockroach start-single-node --insecure --background --http-addr :9090 --listen-addr=localhost
Install ZITADEL
Download the ZITADEL release according to your architecture from Github
Unpack the archive
move to your download location and unpack the archive
#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_Linux_$(uname -m).tar.gz | tar -xz zitadel && sudo mv zitadel /usr/local/bin
Run ZITADEL
ZITADEL_EXTERNALSECURE=false zitadel start-from-init --masterkey "MasterkeyNeedsToHave32Characters" --tlsMode disabled
Open your favorite internet browser and navigate to http://localhost:8080/ui/console. This is the default IAM admin users login:
- username: zitadel-admin@zitadel.localhost
- password: Password1!
What's next
For running a production grade ZITADEL instance in your environment, go on with the configure ZITADEL section.
caution
The ZITADEL management console requires end-to-end HTTP/2 support
Disclaimer
This guide is for development / demonstration purpose only and does NOT reflect a production setup.
Things such as TLS termination and email verification will not be available unless you
- Use an API gateway with valid certificates in front of the service
- Configure an appropriate email server