Video coming soon…

🔐 Setup Zitadel — Modern Identity & Access Platform

Deploy Zitadel on Ubuntu with Docker and PostgreSQL 16 — a modern identity platform with multi-tenancy, OIDC, SAML, and passkeys, running on port 8171 with a generated masterkey.

⚠️ This script is provided for demo and testing purposes only. Not intended for production use.

📦 Resources & Setup Scripts

Grab the automated bash script from GitHub to follow along with the video.

Automated install script — one command deploys Zitadel with PostgreSQL, a 32-character masterkey, and a first admin account.
View on GitHub

Quick Install:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/security/zitadel/zitadel-ubuntu.sh
chmod +x zitadel-ubuntu.sh
sudo bash zitadel-ubuntu.sh

Tutorial Steps

1 Download the Script

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/security/zitadel/zitadel-ubuntu.sh

2 Make it Executable

chmod +x zitadel-ubuntu.sh

3 Run the Installer

The script installs Docker if needed, starts postgres:16-alpine with a generated password, generates a 32-character masterkey, and runs Zitadel with 'start-from-init --masterkey KEY --tlsMode disabled' on port 8171.

sudo bash zitadel-ubuntu.sh

4 Log In and Change the Password

Sign in as zitadel-admin@zitadel.YOUR-SERVER-IP with the password Password1! — Zitadel forces you to change it immediately:

http://<your-server-ip>:8171

Ports Used

PortPurpose
8171Web console + OIDC/SAML (host → container 8080) — ⚠️ TLS disabled
internalPostgreSQL 16 (zitadel-db, not published)
masterkey32 characters, generated — encrypts the database; back it up

Overview

Why Use It

When You Need It

    Who Should Use It

      Real Use Cases

        Main Features

          How to Use After Installation

            Security Best Practices

              Ports and Firewall Notes

              Backup and Maintenance

                Common Mistakes

                  Troubleshooting

                    Alternatives

                    When Not to Use It

                    PrismaTechWork Professional Help

                      Contact Us

                      Frequently Asked Questions