{
  "manifest_version": "1.0.0",
  "template": {
    "id": "89410bfd-24b9-4db4-be11-e4d546347f16",
    "slug": "keycloak-iam",
    "name": "KEYCLOAK",
    "description": "Auth0 Alternative. Open-source SSO, OIDC and SAML identity server",
    "url": "https://railway.com/deploy/keycloak-iam",
    "upstream": {
      "image": "quay.io/keycloak/keycloak:26.7.1"
    }
  },
  "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": "keycloak",
      "source": {
        "image": "quay.io/keycloak/keycloak:26.7.1"
      },
      "needs_volume": false,
      "http": true
    }
  ],
  "required_inputs": [
    {
      "key": "PGDATA",
      "service": "Postgres",
      "description": "Data directory on the volume",
      "secret": false,
      "strategy": "default",
      "default": "/var/lib/postgresql/data/pgdata"
    },
    {
      "key": "PGHOST",
      "service": "Postgres",
      "description": "Private hostname",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "PGPORT",
      "service": "Postgres",
      "description": "Postgres port",
      "secret": false,
      "strategy": "default",
      "default": "5432"
    },
    {
      "key": "PGUSER",
      "service": "Postgres",
      "description": "Role name for client tools",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PGDATABASE",
      "service": "Postgres",
      "description": "Database name for client tools",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PGPASSWORD",
      "service": "Postgres",
      "description": "Role password for client tools",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "POSTGRES_DB",
      "service": "Postgres",
      "description": "Default database name",
      "secret": false,
      "strategy": "default",
      "default": "railway"
    },
    {
      "key": "DATABASE_URL",
      "service": "Postgres",
      "description": "Private connection URL",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "POSTGRES_USER",
      "service": "Postgres",
      "description": "Default database role",
      "secret": false,
      "strategy": "default",
      "default": "postgres"
    },
    {
      "key": "POSTGRES_PASSWORD",
      "service": "Postgres",
      "description": "Database role password",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "DATABASE_PUBLIC_URL",
      "service": "Postgres",
      "description": "Public connection URL",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PORT",
      "service": "keycloak",
      "description": "Railway health-check target port",
      "secret": false,
      "strategy": "default",
      "default": "9000"
    },
    {
      "key": "KC_DB",
      "service": "keycloak",
      "description": "Database vendor, build-time option",
      "secret": false,
      "strategy": "default",
      "default": "postgres"
    },
    {
      "key": "KC_DB_URL",
      "service": "keycloak",
      "description": "Private JDBC connection URL",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "KC_HOSTNAME",
      "service": "keycloak",
      "description": "Full public URL, set before first boot",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "KC_DB_PASSWORD",
      "service": "keycloak",
      "description": "Database role password",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "KC_DB_USERNAME",
      "service": "keycloak",
      "description": "Database role name",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "KC_HTTP_ENABLED",
      "service": "keycloak",
      "description": "Accept HTTP behind Railway's TLS edge",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "JAVA_OPTS_APPEND",
      "service": "keycloak",
      "description": "JVM heap ceiling in the container",
      "secret": false,
      "strategy": "default",
      "default": "-XX:MaxRAMPercentage=70"
    },
    {
      "key": "KC_PROXY_HEADERS",
      "service": "keycloak",
      "description": "Trust X-Forwarded-* from the edge",
      "secret": false,
      "strategy": "default",
      "default": "xforwarded"
    },
    {
      "key": "KC_HEALTH_ENABLED",
      "service": "keycloak",
      "description": "Enable /health on port 9000",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "KC_METRICS_ENABLED",
      "service": "keycloak",
      "description": "Enable /metrics on port 9000",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "KC_DB_POOL_MAX_SIZE",
      "service": "keycloak",
      "description": "Connection cap, protects max_connections",
      "secret": false,
      "strategy": "default",
      "default": "20"
    },
    {
      "key": "KC_DB_POOL_MIN_SIZE",
      "service": "keycloak",
      "description": "Idle connection floor",
      "secret": false,
      "strategy": "default",
      "default": "2"
    },
    {
      "key": "KC_LOG_CONSOLE_COLOR",
      "service": "keycloak",
      "description": "Plain-text logs for Railway",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "KC_DB_POOL_INITIAL_SIZE",
      "service": "keycloak",
      "description": "Connections opened at startup",
      "secret": false,
      "strategy": "default",
      "default": "2"
    },
    {
      "key": "KC_PROXY_TRUSTED_ADDRESSES",
      "service": "keycloak",
      "description": "Railway edge address ranges",
      "secret": false,
      "strategy": "default",
      "default": "100.64.0.0/10,fd00::/8"
    },
    {
      "key": "KC_BOOTSTRAP_ADMIN_PASSWORD",
      "service": "keycloak",
      "description": "Temporary first admin password",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "KC_BOOTSTRAP_ADMIN_USERNAME",
      "service": "keycloak",
      "description": "Temporary first admin username",
      "secret": false,
      "strategy": "default",
      "default": "admin"
    },
    {
      "key": "KC_HTTP_MAX_QUEUED_REQUESTS",
      "service": "keycloak",
      "description": "Shed excess load with 503s",
      "secret": false,
      "strategy": "default",
      "default": "1000"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "keycloak-iam"
      }
    },
    "cli": "railway deploy --template keycloak-iam",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "89410bfd-24b9-4db4-be11-e4d546347f16",
            "serializedConfig": {
              "buckets": {},
              "services": {
                "4ec8cbb0-206b-4c0c-87f3-dd47bfdd8dcd": {
                  "icon": "https://devicons.railway.app/i/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": "Data directory on the volume",
                      "defaultValue": "/var/lib/postgresql/data/pgdata"
                    },
                    "PGHOST": {
                      "isOptional": false,
                      "description": "Private hostname",
                      "defaultValue": "${{RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "PGPORT": {
                      "isOptional": false,
                      "description": "Postgres port",
                      "defaultValue": "5432"
                    },
                    "PGUSER": {
                      "isOptional": false,
                      "description": "Role name for client tools",
                      "defaultValue": "${{POSTGRES_USER}}"
                    },
                    "PGDATABASE": {
                      "isOptional": false,
                      "description": "Database name for client tools",
                      "defaultValue": "${{POSTGRES_DB}}"
                    },
                    "PGPASSWORD": {
                      "isOptional": false,
                      "description": "Role password for client tools",
                      "defaultValue": "${{POSTGRES_PASSWORD}}"
                    },
                    "POSTGRES_DB": {
                      "isOptional": false,
                      "description": "Default database name",
                      "defaultValue": "railway"
                    },
                    "DATABASE_URL": {
                      "isOptional": false,
                      "description": "Private connection URL",
                      "defaultValue": "postgresql://${{PGUSER}}:${{POSTGRES_PASSWORD}}@${{RAILWAY_PRIVATE_DOMAIN}}:5432/${{PGDATABASE}}"
                    },
                    "POSTGRES_USER": {
                      "isOptional": false,
                      "description": "Default database role",
                      "defaultValue": "postgres"
                    },
                    "POSTGRES_PASSWORD": {
                      "isOptional": false,
                      "description": "Database role password",
                      "defaultValue": "{{POSTGRES_PASSWORD}}"
                    },
                    "DATABASE_PUBLIC_URL": {
                      "description": "Public connection URL",
                      "defaultValue": "postgresql://${{PGUSER}}:${{POSTGRES_PASSWORD}}@${{RAILWAY_TCP_PROXY_DOMAIN}}:${{RAILWAY_TCP_PROXY_PORT}}/${{PGDATABASE}}"
                    }
                  },
                  "volumeMounts": {
                    "4ec8cbb0-206b-4c0c-87f3-dd47bfdd8dcd": {
                      "mountPath": "/var/lib/postgresql/data"
                    }
                  }
                },
                "9b838a5a-bd8d-477b-887a-ab3eadd1cf83": {
                  "icon": "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/keycloak.svg",
                  "name": "keycloak",
                  "deploy": {
                    "startCommand": "/opt/keycloak/bin/kc.sh start",
                    "healthcheckPath": "/health/ready",
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "quay.io/keycloak/keycloak:26.7.1"
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "Railway health-check target port",
                      "defaultValue": "9000"
                    },
                    "KC_DB": {
                      "isOptional": false,
                      "description": "Database vendor, build-time option",
                      "defaultValue": "postgres"
                    },
                    "KC_DB_URL": {
                      "isOptional": false,
                      "description": "Private JDBC connection URL",
                      "defaultValue": "jdbc:postgresql://${{Postgres.RAILWAY_PRIVATE_DOMAIN}}:5432/${{Postgres.PGDATABASE}}"
                    },
                    "KC_HOSTNAME": {
                      "isOptional": false,
                      "description": "Full public URL, set before first boot",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "KC_DB_PASSWORD": {
                      "isOptional": false,
                      "description": "Database role password",
                      "defaultValue": "${{Postgres.POSTGRES_PASSWORD}}"
                    },
                    "KC_DB_USERNAME": {
                      "isOptional": false,
                      "description": "Database role name",
                      "defaultValue": "${{Postgres.PGUSER}}"
                    },
                    "KC_HTTP_ENABLED": {
                      "isOptional": false,
                      "description": "Accept HTTP behind Railway's TLS edge",
                      "defaultValue": "true"
                    },
                    "JAVA_OPTS_APPEND": {
                      "isOptional": false,
                      "description": "JVM heap ceiling in the container",
                      "defaultValue": "-XX:MaxRAMPercentage=70"
                    },
                    "KC_PROXY_HEADERS": {
                      "isOptional": false,
                      "description": "Trust X-Forwarded-* from the edge",
                      "defaultValue": "xforwarded"
                    },
                    "KC_HEALTH_ENABLED": {
                      "isOptional": false,
                      "description": "Enable /health on port 9000",
                      "defaultValue": "true"
                    },
                    "KC_METRICS_ENABLED": {
                      "isOptional": false,
                      "description": "Enable /metrics on port 9000",
                      "defaultValue": "true"
                    },
                    "KC_DB_POOL_MAX_SIZE": {
                      "isOptional": false,
                      "description": "Connection cap, protects max_connections",
                      "defaultValue": "20"
                    },
                    "KC_DB_POOL_MIN_SIZE": {
                      "isOptional": false,
                      "description": "Idle connection floor",
                      "defaultValue": "2"
                    },
                    "KC_LOG_CONSOLE_COLOR": {
                      "isOptional": false,
                      "description": "Plain-text logs for Railway",
                      "defaultValue": "false"
                    },
                    "KC_DB_POOL_INITIAL_SIZE": {
                      "isOptional": false,
                      "description": "Connections opened at startup",
                      "defaultValue": "2"
                    },
                    "KC_PROXY_TRUSTED_ADDRESSES": {
                      "isOptional": false,
                      "description": "Railway edge address ranges",
                      "defaultValue": "100.64.0.0/10,fd00::/8"
                    },
                    "KC_BOOTSTRAP_ADMIN_PASSWORD": {
                      "isOptional": false,
                      "description": "Temporary first admin password",
                      "defaultValue": "{{KC_BOOTSTRAP_ADMIN_PASSWORD}}"
                    },
                    "KC_BOOTSTRAP_ADMIN_USERNAME": {
                      "isOptional": false,
                      "description": "Temporary first admin username",
                      "defaultValue": "admin"
                    },
                    "KC_HTTP_MAX_QUEUED_REQUESTS": {
                      "isOptional": false,
                      "description": "Shed excess load with 503s",
                      "defaultValue": "1000"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>:8080": {
                        "port": 8080
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {
    "healthcheck": {
      "service": "keycloak",
      "method": "GET",
      "path": "/health/ready",
      "expect_status": 200
    }
  },
  "resources": {
    "expected_services": 2,
    "needs_volume": true
  },
  "generated_at": "2026-09-10T10:14:45.332Z",
  "generator_version": "0.1.0",
  "status": "degraded",
  "validated_at": "2026-09-04T14:15:53.737Z",
  "success_rate_30d": 0,
  "validation": {
    "last_run_id": "run_6aae5396370044449357",
    "checks": [
      {
        "name": "workflow_completed",
        "passed": true
      },
      {
        "name": "all_services_deployed",
        "passed": true
      },
      {
        "name": "healthcheck",
        "passed": false,
        "detail": "got 404, expected 200"
      },
      {
        "name": "stays_up",
        "passed": true
      }
    ]
  }
}
