{
  "manifest_version": "1.0.0",
  "template": {
    "id": "9f66026b-d505-4f90-b237-98979a33a3fc",
    "slug": "hyperdx",
    "name": "HyperDX",
    "description": "ClickHouse observability: logs, traces, metrics, session replay.",
    "url": "https://railway.com/deploy/hyperdx",
    "upstream": {
      "repo_url": "https://github.com/nomideusz/hyperdx-railway"
    }
  },
  "services": [
    {
      "name": "app",
      "source": {
        "repo": "https://github.com/nomideusz/hyperdx-railway"
      },
      "needs_volume": false,
      "http": true
    },
    {
      "name": "otel-collector",
      "source": {
        "repo": "https://github.com/nomideusz/hyperdx-railway"
      },
      "needs_volume": false,
      "http": true
    },
    {
      "name": "mongo",
      "source": {
        "repo": "https://github.com/nomideusz/hyperdx-railway"
      },
      "needs_volume": true,
      "volume_mount_path": "/data/db",
      "http": false
    },
    {
      "name": "clickhouse",
      "source": {
        "repo": "https://github.com/nomideusz/hyperdx-railway"
      },
      "needs_volume": true,
      "volume_mount_path": "/var/lib/clickhouse",
      "http": false
    }
  ],
  "required_inputs": [
    {
      "key": "PORT",
      "service": "app",
      "description": "UI port Railway routes to. Must match HYPERDX_APP_PORT — don't change.",
      "secret": false,
      "strategy": "default",
      "default": "8080"
    },
    {
      "key": "MONGO_URI",
      "service": "app",
      "description": "Metadata database connection string. Wired automatically — don't change.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "OPAMP_PORT",
      "service": "app",
      "description": "OpAMP port the collector pulls its pipeline config from. Don't change.",
      "secret": false,
      "strategy": "default",
      "default": "4320"
    },
    {
      "key": "SERVER_URL",
      "service": "app",
      "description": "Where the UI reaches the API, in-container. Don't change.",
      "secret": false,
      "strategy": "default",
      "default": "http://127.0.0.1:8000"
    },
    {
      "key": "FRONTEND_URL",
      "service": "app",
      "description": "Public base URL, wired to your Railway domain. Don't change.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "HYPERDX_APP_URL",
      "service": "app",
      "description": "Public base URL, wired to your Railway domain. Don't change.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "HYPERDX_API_PORT",
      "service": "app",
      "description": "API port inside the container, reached over loopback only. Don't change.",
      "secret": false,
      "strategy": "default",
      "default": "8000"
    },
    {
      "key": "HYPERDX_APP_PORT",
      "service": "app",
      "description": "Next.js UI port inside the container. Don't change.",
      "secret": false,
      "strategy": "default",
      "default": "8080"
    },
    {
      "key": "HYPERDX_LOG_LEVEL",
      "service": "app",
      "description": "Log verbosity: debug, info, warn, error.",
      "secret": false,
      "strategy": "default",
      "default": "info"
    },
    {
      "key": "DEFAULT_CONNECTIONS",
      "service": "app",
      "description": "The bundled ClickHouse, pre-selected on first login. Wired automatically — don't change.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "USAGE_STATS_ENABLED",
      "service": "app",
      "description": "Anonymous usage reporting to HyperDX. Off by default.",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "EXPRESS_SESSION_SECRET",
      "service": "app",
      "description": "Auto-generated key for signing login sessions.",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "RAILWAY_HEALTHCHECK_TIMEOUT_SEC",
      "service": "app",
      "description": "Grace period for the first boot to answer the healthcheck.",
      "secret": false,
      "strategy": "default",
      "default": "600"
    },
    {
      "key": "PORT",
      "service": "otel-collector",
      "description": "OTLP/HTTP port Railway routes to. The image exposes five ports; this pins the right one. Don't change.",
      "secret": false,
      "strategy": "default",
      "default": "4318"
    },
    {
      "key": "CLICKHOUSE_USER",
      "service": "otel-collector",
      "description": "ClickHouse user. Must match the clickhouse service — don't change.",
      "secret": false,
      "strategy": "default",
      "default": "hyperdx"
    },
    {
      "key": "OPAMP_SERVER_URL",
      "service": "otel-collector",
      "description": "Where the collector fetches its pipeline config. Wired automatically — don't change.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "HYPERDX_LOG_LEVEL",
      "service": "otel-collector",
      "description": "Log verbosity: debug, info, warn, error.",
      "secret": false,
      "strategy": "default",
      "default": "info"
    },
    {
      "key": "CLICKHOUSE_ENDPOINT",
      "service": "otel-collector",
      "description": "ClickHouse native endpoint. Wired automatically — don't change.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "CLICKHOUSE_PASSWORD",
      "service": "otel-collector",
      "description": "ClickHouse password. Wired automatically — don't change.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "MONGO_INITDB_ROOT_PASSWORD",
      "service": "mongo",
      "description": "Auto-generated metadata database password.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "MONGO_INITDB_ROOT_USERNAME",
      "service": "mongo",
      "description": "Metadata database user. Must match the app's MONGO_URI — don't change.",
      "secret": false,
      "strategy": "default",
      "default": "hyperdx"
    },
    {
      "key": "CLICKHOUSE_PASSWORD",
      "service": "clickhouse",
      "description": "Auto-generated telemetry database password.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "hyperdx"
      }
    },
    "cli": "railway deploy --template hyperdx",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "9f66026b-d505-4f90-b237-98979a33a3fc",
            "serializedConfig": {
              "buckets": {},
              "services": {
                "2bff5e6f-3009-4c7f-8f95-11f5853caddf": {
                  "icon": "https://avatars.githubusercontent.com/u/130113031?v=4",
                  "name": "app",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": "/api/installation",
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "https://github.com/nomideusz/hyperdx-railway",
                    "rootDirectory": "/app"
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "UI port Railway routes to. Must match HYPERDX_APP_PORT — don't change.",
                      "defaultValue": "8080"
                    },
                    "MONGO_URI": {
                      "isOptional": false,
                      "description": "Metadata database connection string. Wired automatically — don't change.",
                      "defaultValue": "mongodb://hyperdx:${{mongo.MONGO_INITDB_ROOT_PASSWORD}}@${{mongo.RAILWAY_PRIVATE_DOMAIN}}:27017/hyperdx?authSource=admin"
                    },
                    "OPAMP_PORT": {
                      "isOptional": false,
                      "description": "OpAMP port the collector pulls its pipeline config from. Don't change.",
                      "defaultValue": "4320"
                    },
                    "SERVER_URL": {
                      "isOptional": false,
                      "description": "Where the UI reaches the API, in-container. Don't change.",
                      "defaultValue": "http://127.0.0.1:8000"
                    },
                    "FRONTEND_URL": {
                      "isOptional": false,
                      "description": "Public base URL, wired to your Railway domain. Don't change.",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "HYPERDX_APP_URL": {
                      "isOptional": false,
                      "description": "Public base URL, wired to your Railway domain. Don't change.",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "HYPERDX_API_PORT": {
                      "isOptional": false,
                      "description": "API port inside the container, reached over loopback only. Don't change.",
                      "defaultValue": "8000"
                    },
                    "HYPERDX_APP_PORT": {
                      "isOptional": false,
                      "description": "Next.js UI port inside the container. Don't change.",
                      "defaultValue": "8080"
                    },
                    "HYPERDX_LOG_LEVEL": {
                      "isOptional": true,
                      "description": "Log verbosity: debug, info, warn, error.",
                      "defaultValue": "info"
                    },
                    "DEFAULT_CONNECTIONS": {
                      "isOptional": false,
                      "description": "The bundled ClickHouse, pre-selected on first login. Wired automatically — don't change.",
                      "defaultValue": "[{\"name\":\"Local ClickHouse\",\"host\":\"http://${{clickhouse.RAILWAY_PRIVATE_DOMAIN}}:8123\",\"username\":\"hyperdx\",\"password\":\"${{clickhouse.CLICKHOUSE_PASSWORD}}\"}]"
                    },
                    "USAGE_STATS_ENABLED": {
                      "isOptional": true,
                      "description": "Anonymous usage reporting to HyperDX. Off by default.",
                      "defaultValue": "false"
                    },
                    "EXPRESS_SESSION_SECRET": {
                      "isOptional": false,
                      "description": "Auto-generated key for signing login sessions.",
                      "defaultValue": "{{EXPRESS_SESSION_SECRET}}"
                    },
                    "RAILWAY_HEALTHCHECK_TIMEOUT_SEC": {
                      "isOptional": false,
                      "description": "Grace period for the first boot to answer the healthcheck.",
                      "defaultValue": "600"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>": {}
                    }
                  }
                },
                "53d505ec-e88d-4300-888b-b9cd9413a717": {
                  "icon": "https://devicons.railway.app/i/opentelemetry.svg",
                  "name": "otel-collector",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "https://github.com/nomideusz/hyperdx-railway",
                    "rootDirectory": "/otel-collector"
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "OTLP/HTTP port Railway routes to. The image exposes five ports; this pins the right one. Don't change.",
                      "defaultValue": "4318"
                    },
                    "CLICKHOUSE_USER": {
                      "isOptional": false,
                      "description": "ClickHouse user. Must match the clickhouse service — don't change.",
                      "defaultValue": "hyperdx"
                    },
                    "OPAMP_SERVER_URL": {
                      "isOptional": false,
                      "description": "Where the collector fetches its pipeline config. Wired automatically — don't change.",
                      "defaultValue": "http://${{app.RAILWAY_PRIVATE_DOMAIN}}:4320"
                    },
                    "HYPERDX_LOG_LEVEL": {
                      "isOptional": true,
                      "description": "Log verbosity: debug, info, warn, error.",
                      "defaultValue": "info"
                    },
                    "CLICKHOUSE_ENDPOINT": {
                      "isOptional": false,
                      "description": "ClickHouse native endpoint. Wired automatically — don't change.",
                      "defaultValue": "tcp://${{clickhouse.RAILWAY_PRIVATE_DOMAIN}}:9000?dial_timeout=10s"
                    },
                    "CLICKHOUSE_PASSWORD": {
                      "isOptional": false,
                      "description": "ClickHouse password. Wired automatically — don't change.",
                      "defaultValue": "${{clickhouse.CLICKHOUSE_PASSWORD}}"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>": {}
                    }
                  }
                },
                "6a0733d1-8a03-4b8c-a80a-d5db71540147": {
                  "icon": "https://devicons.railway.app/i/mongodb.svg",
                  "name": "mongo",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "https://github.com/nomideusz/hyperdx-railway",
                    "rootDirectory": "/mongo"
                  },
                  "variables": {
                    "MONGO_INITDB_ROOT_PASSWORD": {
                      "isOptional": false,
                      "description": "Auto-generated metadata database password.",
                      "defaultValue": "{{MONGO_INITDB_ROOT_PASSWORD}}"
                    },
                    "MONGO_INITDB_ROOT_USERNAME": {
                      "isOptional": false,
                      "description": "Metadata database user. Must match the app's MONGO_URI — don't change.",
                      "defaultValue": "hyperdx"
                    }
                  },
                  "volumeMounts": {
                    "6a0733d1-8a03-4b8c-a80a-d5db71540147": {
                      "mountPath": "/data/db"
                    }
                  }
                },
                "a0c7928c-c1b8-4dc6-bbe7-c44ac129017f": {
                  "icon": "https://devicons.railway.app/i/clickhouse.svg",
                  "name": "clickhouse",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "https://github.com/nomideusz/hyperdx-railway",
                    "rootDirectory": "/clickhouse"
                  },
                  "variables": {
                    "CLICKHOUSE_PASSWORD": {
                      "isOptional": false,
                      "description": "Auto-generated telemetry database password.",
                      "defaultValue": "{{CLICKHOUSE_PASSWORD}}"
                    }
                  },
                  "volumeMounts": {
                    "a0c7928c-c1b8-4dc6-bbe7-c44ac129017f": {
                      "mountPath": "/var/lib/clickhouse"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {
    "healthcheck": {
      "service": "app",
      "method": "GET",
      "path": "/api/installation",
      "expect_status": 200
    }
  },
  "resources": {
    "expected_services": 4,
    "needs_volume": true
  },
  "generated_at": "2026-09-19T10:14:38.021Z",
  "generator_version": "0.1.0",
  "status": "validated",
  "validated_at": "2026-09-17T07:41:09.659Z",
  "success_rate_30d": 1,
  "validation": {
    "last_run_id": "run_35e56e80b2cd4ffbaab8",
    "checks": [
      {
        "name": "workflow_completed",
        "passed": true
      },
      {
        "name": "all_services_deployed",
        "passed": true
      },
      {
        "name": "healthcheck",
        "passed": true
      },
      {
        "name": "stays_up",
        "passed": true
      }
    ],
    "typical_ready_seconds": 139,
    "typical_build_seconds": 22,
    "typical_start_seconds": 10,
    "slowest_service": "app"
  }
}