ZITADEL v4 Unraid Templates [Nebur692]

===================================================================

ENGLISH

===================================================================

Repository: https://github.com/Nebur692/unraid-zitadel-templates

ZITADEL is a self-hosted identity platform (SSO via OIDC/SAML, MFA, user management). The only

ZITADEL template previously available on Community Applications was written for ZITADEL's older,

single-container architecture. Since ZITADEL v4, the interactive login pages were split into their

own separate service — deploying just the core container (as the old template does) leaves every

login attempt failing with a silent 404, since the container itself reports healthy.

This repository provides two templates that work together and were built directly from ZITADEL's

own reference docker-compose files, not guessed:

- zitadel — the core/API container, with every variable ZITADEL v4 actually needs to bootstrap

correctly on first start.

- zitadel-login — the missing login UI container. There was no Community Applications template

for this at all before this repository.

The README covers install order, a full plain-language reference for every variable, the required

reverse-proxy routing, and troubleshooting for the issues that came up while building and testing

this against a real deployment (Postgres admin-user mismatches, a ZITADEL master-key env-var bug,

a silent token-write failure, and the login-page-vs-admin-console confusion that trips up almost

everyone the first time).

Post here for any issue, question, or suggestion regarding these templates.

===================================================================

ESPAÑOL

===================================================================

Repositorio: https://github.com/Nebur692/unraid-zitadel-templates

ZITADEL es una plataforma de identidad autoalojada (SSO vía OIDC/SAML, MFA, gestión de usuarios).

La única plantilla de ZITADEL antes disponible en Community Applications estaba escrita para la

arquitectura antigua de ZITADEL, de un solo contenedor. Desde ZITADEL v4, las páginas de login

interactivas se separaron en su propio servicio — desplegar solo el contenedor principal (como hace

la plantilla antigua) deja cualquier intento de login fallando con un 404 silencioso, ya que el

propio contenedor se reporta como sano.

Este repositorio aporta dos plantillas que funcionan juntas, construidas directamente a partir de

los docker-compose de referencia oficiales de ZITADEL, no por suposición:

- zitadel — el contenedor principal/API, con todas las variables que ZITADEL v4 necesita de

verdad para arrancar correctamente la primera vez.

- zitadel-login — el contenedor de login que faltaba. No existía ninguna plantilla de Community

Applications para esto antes de este repositorio.

El README cubre el orden de instalación, una referencia completa y en lenguaje sencillo de cada

variable, el enrutado de proxy inverso necesario, y solución de problemas para los fallos reales

encontrados al construir y probar esto contra un despliegue real (usuarios de administrador de

Postgres que no coinciden, un bug de ZITADEL con la variable de entorno de la master key, un fallo

silencioso al escribir el token, y la confusión entre la página de login y la consola de

administración que le pasa a casi todo el mundo la primera vez).

Escribe aquí cualquier problema, pregunta o sugerencia sobre estas plantillas.