{
  "manifest_version": "1.0.0",
  "template": {
    "id": "cb1b2bdf-5f1d-4907-9c5f-404cf6ba6a65",
    "slug": "zitadel-identity",
    "name": "Zitadel",
    "description": "Identity provider for logins, single sign-on and user accounts",
    "url": "https://railway.com/deploy/zitadel-identity",
    "upstream": {
      "repo_url": "https://github.com/gridalpha/zitadel-railway"
    }
  },
  "services": [
    {
      "name": "Postgres",
      "source": {
        "image": "ghcr.io/railwayapp-templates/postgres-ssl:18"
      },
      "needs_volume": true,
      "volume_mount_path": "/var/lib/postgresql/data",
      "http": false
    },
    {
      "name": "zitadel",
      "source": {
        "repo": "https://github.com/gridalpha/zitadel-railway"
      },
      "needs_volume": true,
      "volume_mount_path": "/zitadel/bootstrap",
      "http": true
    },
    {
      "name": "mailpit",
      "source": {
        "image": "axllent/mailpit:latest"
      },
      "needs_volume": true,
      "volume_mount_path": "/data",
      "http": true
    }
  ],
  "required_inputs": [
    {
      "key": "PGDATA",
      "service": "Postgres",
      "description": "Cluster location on the volume",
      "secret": false,
      "strategy": "default",
      "default": "/var/lib/postgresql/data/pgdata"
    },
    {
      "key": "PGHOST",
      "service": "Postgres",
      "description": "Data panel alias, not read by the server",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "PGPORT",
      "service": "Postgres",
      "description": "Data panel alias, not read by the server",
      "secret": false,
      "strategy": "default",
      "default": "5432"
    },
    {
      "key": "PGUSER",
      "service": "Postgres",
      "description": "Data panel alias, not read by the server",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PGDATABASE",
      "service": "Postgres",
      "description": "Data panel alias, not read by the server",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PGPASSWORD",
      "service": "Postgres",
      "description": "Data panel alias, not read by the server",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "POSTGRES_DB",
      "service": "Postgres",
      "description": "Database created on first boot",
      "secret": false,
      "strategy": "default",
      "default": "railway"
    },
    {
      "key": "DATABASE_URL",
      "service": "Postgres",
      "description": "Private connection string",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "POSTGRES_USER",
      "service": "Postgres",
      "description": "Superuser created on first boot",
      "secret": false,
      "strategy": "default",
      "default": "postgres"
    },
    {
      "key": "SSL_CERT_DAYS",
      "service": "Postgres",
      "description": "SSL certificate expiry in days",
      "secret": false,
      "strategy": "default",
      "default": "820"
    },
    {
      "key": "POSTGRES_PASSWORD",
      "service": "Postgres",
      "description": "Superuser password",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "RAILWAY_DEPLOYMENT_DRAINING_SECONDS",
      "service": "Postgres",
      "description": "Clean shutdown window",
      "secret": false,
      "strategy": "default",
      "default": "60"
    },
    {
      "key": "PORT",
      "service": "zitadel",
      "description": "Caddy listener Railway routes to",
      "secret": false,
      "strategy": "default",
      "default": "8000"
    },
    {
      "key": "ZITADEL_MASTERKEY",
      "service": "zitadel",
      "description": "At-rest secret encryption key",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "ZITADEL_ADMIN_EMAIL",
      "service": "zitadel",
      "description": "First admin email address",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "ZITADEL_EXTERNALPORT",
      "service": "zitadel",
      "description": "Public port behind Railway TLS",
      "secret": false,
      "strategy": "default",
      "default": "443"
    },
    {
      "key": "ZITADEL_ADMIN_PASSWORD",
      "service": "zitadel",
      "description": "First admin password, meets complexity policy",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "ZITADEL_ADMIN_USERNAME",
      "service": "zitadel",
      "description": "First instance administrator",
      "secret": false,
      "strategy": "default",
      "default": "zitadel-admin"
    },
    {
      "key": "ZITADEL_EXTERNALDOMAIN",
      "service": "zitadel",
      "description": "Public hostname users visit",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "ZITADEL_EXTERNALSECURE",
      "service": "zitadel",
      "description": "Public URLs use HTTPS",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "ZITADEL_DATABASE_POSTGRES_HOST",
      "service": "zitadel",
      "description": "Private database hostname",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "ZITADEL_DATABASE_POSTGRES_PORT",
      "service": "zitadel",
      "description": "Database port",
      "secret": false,
      "strategy": "default",
      "default": "5432"
    },
    {
      "key": "ZITADEL_DATABASE_POSTGRES_DATABASE",
      "service": "zitadel",
      "description": "Database created on first boot",
      "secret": false,
      "strategy": "default",
      "default": "zitadel"
    },
    {
      "key": "RAILWAY_DEPLOYMENT_DRAINING_SECONDS",
      "service": "zitadel",
      "description": "Clean shutdown window",
      "secret": false,
      "strategy": "default",
      "default": "30"
    },
    {
      "key": "ZITADEL_DATABASE_POSTGRES_USER_PASSWORD",
      "service": "zitadel",
      "description": "Scoped role password",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "ZITADEL_DATABASE_POSTGRES_USER_SSL_MODE",
      "service": "zitadel",
      "description": "Private network, no TLS needed",
      "secret": false,
      "strategy": "default",
      "default": "disable"
    },
    {
      "key": "ZITADEL_DATABASE_POSTGRES_USER_USERNAME",
      "service": "zitadel",
      "description": "Scoped application role",
      "secret": false,
      "strategy": "default",
      "default": "zitadel"
    },
    {
      "key": "ZITADEL_DATABASE_POSTGRES_ADMIN_PASSWORD",
      "service": "zitadel",
      "description": "Bootstrap superuser password",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "ZITADEL_DATABASE_POSTGRES_ADMIN_SSL_MODE",
      "service": "zitadel",
      "description": "Private network, no TLS needed",
      "secret": false,
      "strategy": "default",
      "default": "disable"
    },
    {
      "key": "ZITADEL_DATABASE_POSTGRES_ADMIN_USERNAME",
      "service": "zitadel",
      "description": "Superuser used only to bootstrap",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "ZITADEL_DEFAULTINSTANCE_SMTPCONFIGURATION_FROM",
      "service": "zitadel",
      "description": "Notification sender address",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "ZITADEL_DATABASE_POSTGRES_ADMIN_EXISTINGDATABASE",
      "service": "zitadel",
      "description": "Database to connect to first",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "ZITADEL_DEFAULTINSTANCE_SMTPCONFIGURATION_FROMNAME",
      "service": "zitadel",
      "description": "Notification sender display name",
      "secret": false,
      "strategy": "default",
      "default": "ZITADEL"
    },
    {
      "key": "ZITADEL_DEFAULTINSTANCE_SMTPCONFIGURATION_SMTP_HOST",
      "service": "zitadel",
      "description": "Notification mail host and port",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "TZ",
      "service": "mailpit",
      "description": "Timestamp timezone",
      "secret": false,
      "strategy": "default",
      "default": "UTC"
    },
    {
      "key": "PORT",
      "service": "mailpit",
      "description": "Web inbox port Railway routes to",
      "secret": false,
      "strategy": "default",
      "default": "8025"
    },
    {
      "key": "MP_UI_AUTH",
      "service": "mailpit",
      "description": "Basic auth for the web inbox",
      "secret": false,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "MP_DATABASE",
      "service": "mailpit",
      "description": "Message store on the volume",
      "secret": false,
      "strategy": "default",
      "default": "/data/mailpit.db"
    },
    {
      "key": "MP_MAX_MESSAGES",
      "service": "mailpit",
      "description": "Messages kept before rotation",
      "secret": false,
      "strategy": "default",
      "default": "5000"
    },
    {
      "key": "MP_UI_BIND_ADDR",
      "service": "mailpit",
      "description": "Web inbox bind address",
      "secret": false,
      "strategy": "default",
      "default": "[::]:8025"
    },
    {
      "key": "MP_SMTP_BIND_ADDR",
      "service": "mailpit",
      "description": "Private SMTP bind address",
      "secret": false,
      "strategy": "default",
      "default": "[::]:1025"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "zitadel-identity"
      }
    },
    "cli": "railway deploy --template zitadel-identity",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "cb1b2bdf-5f1d-4907-9c5f-404cf6ba6a65",
            "serializedConfig": {
              "buckets": {},
              "services": {
                "1236d916-1880-4502-8298-4ba318c257ce": {
                  "icon": "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/postgresql.svg",
                  "name": "Postgres",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "ghcr.io/railwayapp-templates/postgres-ssl:18"
                  },
                  "variables": {
                    "PGDATA": {
                      "isOptional": false,
                      "description": "Cluster location on the volume",
                      "defaultValue": "/var/lib/postgresql/data/pgdata"
                    },
                    "PGHOST": {
                      "isOptional": false,
                      "description": "Data panel alias, not read by the server",
                      "defaultValue": "${{RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "PGPORT": {
                      "isOptional": false,
                      "description": "Data panel alias, not read by the server",
                      "defaultValue": "5432"
                    },
                    "PGUSER": {
                      "isOptional": false,
                      "description": "Data panel alias, not read by the server",
                      "defaultValue": "${{POSTGRES_USER}}"
                    },
                    "PGDATABASE": {
                      "isOptional": false,
                      "description": "Data panel alias, not read by the server",
                      "defaultValue": "${{POSTGRES_DB}}"
                    },
                    "PGPASSWORD": {
                      "isOptional": false,
                      "description": "Data panel alias, not read by the server",
                      "defaultValue": "${{POSTGRES_PASSWORD}}"
                    },
                    "POSTGRES_DB": {
                      "isOptional": false,
                      "description": "Database created on first boot",
                      "defaultValue": "railway"
                    },
                    "DATABASE_URL": {
                      "isOptional": false,
                      "description": "Private connection string",
                      "defaultValue": "postgresql://${{PGUSER}}:${{POSTGRES_PASSWORD}}@${{RAILWAY_PRIVATE_DOMAIN}}:5432/${{PGDATABASE}}"
                    },
                    "POSTGRES_USER": {
                      "isOptional": false,
                      "description": "Superuser created on first boot",
                      "defaultValue": "postgres"
                    },
                    "SSL_CERT_DAYS": {
                      "isOptional": false,
                      "description": "SSL certificate expiry in days",
                      "defaultValue": "820"
                    },
                    "POSTGRES_PASSWORD": {
                      "isOptional": false,
                      "description": "Superuser password",
                      "defaultValue": "{{POSTGRES_PASSWORD}}"
                    },
                    "RAILWAY_DEPLOYMENT_DRAINING_SECONDS": {
                      "isOptional": false,
                      "description": "Clean shutdown window",
                      "defaultValue": "60"
                    }
                  },
                  "volumeMounts": {
                    "1236d916-1880-4502-8298-4ba318c257ce": {
                      "mountPath": "/var/lib/postgresql/data"
                    }
                  }
                },
                "653dec93-ca15-405f-8c67-f6167dc86215": {
                  "icon": "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/zitadel-light.svg",
                  "name": "zitadel",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "https://github.com/gridalpha/zitadel-railway",
                    "rootDirectory": null
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "Caddy listener Railway routes to",
                      "defaultValue": "8000"
                    },
                    "ZITADEL_MASTERKEY": {
                      "isOptional": false,
                      "description": "At-rest secret encryption key",
                      "defaultValue": "{{ZITADEL_MASTERKEY}}"
                    },
                    "ZITADEL_ADMIN_EMAIL": {
                      "isOptional": false,
                      "description": "First admin email address",
                      "defaultValue": "admin@${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "ZITADEL_EXTERNALPORT": {
                      "isOptional": false,
                      "description": "Public port behind Railway TLS",
                      "defaultValue": "443"
                    },
                    "ZITADEL_ADMIN_PASSWORD": {
                      "isOptional": false,
                      "description": "First admin password, meets complexity policy",
                      "defaultValue": "{{ZITADEL_ADMIN_PASSWORD}}"
                    },
                    "ZITADEL_ADMIN_USERNAME": {
                      "isOptional": false,
                      "description": "First instance administrator",
                      "defaultValue": "zitadel-admin"
                    },
                    "ZITADEL_EXTERNALDOMAIN": {
                      "isOptional": false,
                      "description": "Public hostname users visit",
                      "defaultValue": "${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "ZITADEL_EXTERNALSECURE": {
                      "isOptional": false,
                      "description": "Public URLs use HTTPS",
                      "defaultValue": "true"
                    },
                    "ZITADEL_DATABASE_POSTGRES_HOST": {
                      "isOptional": false,
                      "description": "Private database hostname",
                      "defaultValue": "${{Postgres.RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "ZITADEL_DATABASE_POSTGRES_PORT": {
                      "isOptional": false,
                      "description": "Database port",
                      "defaultValue": "5432"
                    },
                    "ZITADEL_DATABASE_POSTGRES_DATABASE": {
                      "isOptional": false,
                      "description": "Database created on first boot",
                      "defaultValue": "zitadel"
                    },
                    "RAILWAY_DEPLOYMENT_DRAINING_SECONDS": {
                      "isOptional": false,
                      "description": "Clean shutdown window",
                      "defaultValue": "30"
                    },
                    "ZITADEL_DATABASE_POSTGRES_USER_PASSWORD": {
                      "isOptional": false,
                      "description": "Scoped role password",
                      "defaultValue": "{{ZITADEL_DATABASE_POSTGRES_USER_PASSWORD}}"
                    },
                    "ZITADEL_DATABASE_POSTGRES_USER_SSL_MODE": {
                      "isOptional": false,
                      "description": "Private network, no TLS needed",
                      "defaultValue": "disable"
                    },
                    "ZITADEL_DATABASE_POSTGRES_USER_USERNAME": {
                      "isOptional": false,
                      "description": "Scoped application role",
                      "defaultValue": "zitadel"
                    },
                    "ZITADEL_DATABASE_POSTGRES_ADMIN_PASSWORD": {
                      "isOptional": false,
                      "description": "Bootstrap superuser password",
                      "defaultValue": "${{Postgres.PGPASSWORD}}"
                    },
                    "ZITADEL_DATABASE_POSTGRES_ADMIN_SSL_MODE": {
                      "isOptional": false,
                      "description": "Private network, no TLS needed",
                      "defaultValue": "disable"
                    },
                    "ZITADEL_DATABASE_POSTGRES_ADMIN_USERNAME": {
                      "isOptional": false,
                      "description": "Superuser used only to bootstrap",
                      "defaultValue": "${{Postgres.PGUSER}}"
                    },
                    "ZITADEL_DEFAULTINSTANCE_SMTPCONFIGURATION_FROM": {
                      "isOptional": false,
                      "description": "Notification sender address",
                      "defaultValue": "noreply@${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "ZITADEL_DATABASE_POSTGRES_ADMIN_EXISTINGDATABASE": {
                      "isOptional": false,
                      "description": "Database to connect to first",
                      "defaultValue": "${{Postgres.PGDATABASE}}"
                    },
                    "ZITADEL_DEFAULTINSTANCE_SMTPCONFIGURATION_FROMNAME": {
                      "isOptional": false,
                      "description": "Notification sender display name",
                      "defaultValue": "ZITADEL"
                    },
                    "ZITADEL_DEFAULTINSTANCE_SMTPCONFIGURATION_SMTP_HOST": {
                      "isOptional": false,
                      "description": "Notification mail host and port",
                      "defaultValue": "${{mailpit.RAILWAY_PRIVATE_DOMAIN}}:1025"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>:8000": {
                        "port": 8000
                      }
                    }
                  },
                  "volumeMounts": {
                    "653dec93-ca15-405f-8c67-f6167dc86215": {
                      "mountPath": "/zitadel/bootstrap"
                    }
                  }
                },
                "afe6d057-40f1-4047-9803-7c978bad36c2": {
                  "icon": "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/mailpit.svg",
                  "name": "mailpit",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "axllent/mailpit:latest"
                  },
                  "variables": {
                    "TZ": {
                      "isOptional": false,
                      "description": "Timestamp timezone",
                      "defaultValue": "UTC"
                    },
                    "PORT": {
                      "isOptional": false,
                      "description": "Web inbox port Railway routes to",
                      "defaultValue": "8025"
                    },
                    "MP_UI_AUTH": {
                      "isOptional": false,
                      "description": "Basic auth for the web inbox",
                      "defaultValue": "{{MP_UI_AUTH}}"
                    },
                    "MP_DATABASE": {
                      "isOptional": false,
                      "description": "Message store on the volume",
                      "defaultValue": "/data/mailpit.db"
                    },
                    "MP_MAX_MESSAGES": {
                      "isOptional": false,
                      "description": "Messages kept before rotation",
                      "defaultValue": "5000"
                    },
                    "MP_UI_BIND_ADDR": {
                      "isOptional": false,
                      "description": "Web inbox bind address",
                      "defaultValue": "[::]:8025"
                    },
                    "MP_SMTP_BIND_ADDR": {
                      "isOptional": false,
                      "description": "Private SMTP bind address",
                      "defaultValue": "[::]:1025"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>:8025": {
                        "port": 8025
                      }
                    }
                  },
                  "volumeMounts": {
                    "afe6d057-40f1-4047-9803-7c978bad36c2": {
                      "mountPath": "/data"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {},
  "resources": {
    "expected_services": 3,
    "needs_volume": true
  },
  "generated_at": "2026-09-20T16:14:49.616Z",
  "generator_version": "0.1.0",
  "status": "validated",
  "validated_at": "2026-09-19T13:45:10.476Z",
  "success_rate_30d": 0.5,
  "validation": {
    "last_run_id": "run_c3d8e58d01d540f490a4",
    "checks": [
      {
        "name": "workflow_completed",
        "passed": true
      },
      {
        "name": "all_services_deployed",
        "passed": true
      },
      {
        "name": "stays_up",
        "passed": true
      }
    ],
    "typical_ready_seconds": 100,
    "typical_build_seconds": 30,
    "typical_start_seconds": 11,
    "slowest_service": "zitadel"
  }
}