{
  "manifest_version": "1.0.0",
  "template": {
    "id": "800bbf6c-c7e3-4b38-adc4-36b6fa7faf2a",
    "slug": "breadcrumb",
    "name": "Breadcrumb",
    "description": "Simple, self-hosted LLM observability for TypeScript",
    "url": "https://railway.com/deploy/breadcrumb",
    "upstream": {
      "repo_url": "https://github.com/joshuaKnauber/breadcrumb"
    }
  },
  "services": [
    {
      "name": "breadcrumb",
      "source": {
        "repo": "https://github.com/joshuaKnauber/breadcrumb"
      },
      "needs_volume": false,
      "http": true
    },
    {
      "name": "Postgres",
      "source": {
        "image": "ghcr.io/railwayapp-templates/postgres-ssl:18"
      },
      "needs_volume": true,
      "volume_mount_path": "/var/lib/postgresql/data",
      "tcp_ports": [
        5432
      ],
      "http": false
    },
    {
      "name": "ClickHouse",
      "source": {
        "image": "clickhouse/clickhouse-server:25.8"
      },
      "needs_volume": true,
      "volume_mount_path": "/var/lib/clickhouse",
      "http": true
    }
  ],
  "required_inputs": [
    {
      "key": "APP_BASE_URL",
      "service": "breadcrumb",
      "description": "Base url of the hosted app without trailing slash",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "DATABASE_URL",
      "service": "breadcrumb",
      "description": "Postgres DB url",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "CLICKHOUSE_DB",
      "service": "breadcrumb",
      "description": "Clickhouse DB name",
      "secret": false,
      "strategy": "default",
      "default": "breadcrumb"
    },
    {
      "key": "CLICKHOUSE_URL",
      "service": "breadcrumb",
      "description": "Clickhouse host url",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "ENCRYPTION_KEY",
      "service": "breadcrumb",
      "description": "Encrypts sensitive data. openssl rand -hex 32",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "CLICKHOUSE_USER",
      "service": "breadcrumb",
      "description": "Clickhouse user",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "BETTER_AUTH_SECRET",
      "service": "breadcrumb",
      "description": "Signs auth session tokens. openssl rand -hex 32",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "CLICKHOUSE_PASSWORD",
      "service": "breadcrumb",
      "description": "Clickhouse password",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "RAILWAY_DOCKERFILE_PATH",
      "service": "breadcrumb",
      "description": "Provide a value for RAILWAY_DOCKERFILE_PATH.",
      "secret": false,
      "strategy": "default",
      "default": "/services/server/Dockerfile"
    },
    {
      "key": "PGDATA",
      "service": "Postgres",
      "description": "Location where the database will be initialized",
      "secret": false,
      "strategy": "default",
      "default": "/var/lib/postgresql/data/pgdata"
    },
    {
      "key": "PGHOST",
      "service": "Postgres",
      "description": "Railway Private Domain Name.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "PGPORT",
      "service": "Postgres",
      "description": "Port to connect to Postgres.",
      "secret": false,
      "strategy": "default",
      "default": "5432"
    },
    {
      "key": "PGUSER",
      "service": "Postgres",
      "description": "Required variable for Data panel",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PGDATABASE",
      "service": "Postgres",
      "description": "Required variable for the data panel.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PGPASSWORD",
      "service": "Postgres",
      "description": "Required variable for Data panel",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "POSTGRES_DB",
      "service": "Postgres",
      "description": "Default database created when image is started.",
      "secret": false,
      "strategy": "default",
      "default": "railway"
    },
    {
      "key": "DATABASE_URL",
      "service": "Postgres",
      "description": "URL to connect to Postgres database.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "POSTGRES_USER",
      "service": "Postgres",
      "description": "User to connect to Postgres DB",
      "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": "Password to connect to DB",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "DATABASE_PUBLIC_URL",
      "service": "Postgres",
      "description": "Public URL to connect to Postgres database, used by the Data panel.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "RAILWAY_DEPLOYMENT_DRAINING_SECONDS",
      "service": "Postgres",
      "description": "Allow Postgres to cleanly shut down",
      "secret": false,
      "strategy": "default",
      "default": "60"
    },
    {
      "key": "HOST",
      "service": "ClickHouse",
      "description": "Clickhouse host url",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "PORT",
      "service": "ClickHouse",
      "description": "Clickhouse port",
      "secret": false,
      "strategy": "default",
      "default": "8123"
    },
    {
      "key": "HOST_PORT",
      "service": "ClickHouse",
      "description": "Clickhouse host port",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PUBLIC_HOST",
      "service": "ClickHouse",
      "description": "Clickhouse host",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "PUBLIC_PORT",
      "service": "ClickHouse",
      "description": "Clickhouse public port",
      "secret": false,
      "strategy": "default",
      "default": "443"
    },
    {
      "key": "DATABASE_URL",
      "service": "ClickHouse",
      "description": "Clickhouse database url",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "CLICKHOUSE_DB",
      "service": "ClickHouse",
      "description": "Clickhouse DB name",
      "secret": false,
      "strategy": "default",
      "default": "breadcrumb"
    },
    {
      "key": "CLICKHOUSE_USER",
      "service": "ClickHouse",
      "description": "Clickhouse user name",
      "secret": false,
      "strategy": "default",
      "default": "clickhouse"
    },
    {
      "key": "PUBLIC_HOST_PORT",
      "service": "ClickHouse",
      "description": "Clickhouse public host port",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "DATABASE_JDBC_URL",
      "service": "ClickHouse",
      "description": "Clickhouse JDBC url",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "CLICKHOUSE_PASSWORD",
      "service": "ClickHouse",
      "description": "Clickhouse password",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "PUBLIC_DATABASE_URL",
      "service": "ClickHouse",
      "description": "Clickhouse public databse url",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PUBLIC_DATABASE_JDBC_URL",
      "service": "ClickHouse",
      "description": "Clickhouse public database jdbc url",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "CLICKHOUSE_DEFAULT_ACCESS_MANAGEMENT",
      "service": "ClickHouse",
      "description": "Default role permissions",
      "secret": false,
      "strategy": "default",
      "default": "1"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "breadcrumb"
      }
    },
    "cli": "railway deploy --template breadcrumb",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "800bbf6c-c7e3-4b38-adc4-36b6fa7faf2a",
            "serializedConfig": {
              "buckets": {},
              "services": {
                "6f52092f-cb1b-4088-a006-c7e3410b4d93": {
                  "icon": "https://breadcrumb.sh/favicon.svg",
                  "name": "breadcrumb",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": "/health",
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "https://github.com/joshuaKnauber/breadcrumb",
                    "rootDirectory": "/"
                  },
                  "variables": {
                    "APP_BASE_URL": {
                      "isOptional": false,
                      "description": "Base url of the hosted app without trailing slash",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "DATABASE_URL": {
                      "isOptional": false,
                      "description": "Postgres DB url",
                      "defaultValue": "${{Postgres.DATABASE_URL}}"
                    },
                    "CLICKHOUSE_DB": {
                      "isOptional": false,
                      "description": "Clickhouse DB name",
                      "defaultValue": "breadcrumb"
                    },
                    "CLICKHOUSE_URL": {
                      "isOptional": false,
                      "description": "Clickhouse host url",
                      "defaultValue": "${{ClickHouse.DATABASE_URL}}"
                    },
                    "ENCRYPTION_KEY": {
                      "isOptional": false,
                      "description": "Encrypts sensitive data. openssl rand -hex 32",
                      "defaultValue": "{{ENCRYPTION_KEY}}"
                    },
                    "CLICKHOUSE_USER": {
                      "isOptional": false,
                      "description": "Clickhouse user",
                      "defaultValue": "${{ClickHouse.CLICKHOUSE_USER}}"
                    },
                    "BETTER_AUTH_SECRET": {
                      "isOptional": false,
                      "description": "Signs auth session tokens. openssl rand -hex 32",
                      "defaultValue": "{{BETTER_AUTH_SECRET}}"
                    },
                    "CLICKHOUSE_PASSWORD": {
                      "isOptional": false,
                      "description": "Clickhouse password",
                      "defaultValue": "${{ClickHouse.CLICKHOUSE_PASSWORD}}"
                    },
                    "RAILWAY_DOCKERFILE_PATH": {
                      "isOptional": false,
                      "description": "",
                      "defaultValue": "/services/server/Dockerfile"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>": {}
                    }
                  }
                },
                "753ef4cf-53a2-4d9f-b2bc-62058adb4fbf": {
                  "icon": "https://devicons.railway.app/i/postgresql.svg",
                  "name": "Postgres",
                  "build": {},
                  "deploy": {
                    "requiredMountPath": "/var/lib/postgresql/data"
                  },
                  "source": {
                    "image": "ghcr.io/railwayapp-templates/postgres-ssl:18"
                  },
                  "variables": {
                    "PGDATA": {
                      "isOptional": false,
                      "description": "Location where the database will be initialized",
                      "defaultValue": "/var/lib/postgresql/data/pgdata"
                    },
                    "PGHOST": {
                      "isOptional": false,
                      "description": "Railway Private Domain Name.",
                      "defaultValue": "${{RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "PGPORT": {
                      "isOptional": false,
                      "description": "Port to connect to Postgres.",
                      "defaultValue": "5432"
                    },
                    "PGUSER": {
                      "isOptional": false,
                      "description": "Required variable for Data panel",
                      "defaultValue": "${{ POSTGRES_USER }}"
                    },
                    "PGDATABASE": {
                      "isOptional": false,
                      "description": "Required variable for the data panel.",
                      "defaultValue": "${{POSTGRES_DB}}"
                    },
                    "PGPASSWORD": {
                      "isOptional": false,
                      "description": "Required variable for Data panel",
                      "defaultValue": "${{POSTGRES_PASSWORD}}"
                    },
                    "POSTGRES_DB": {
                      "isOptional": false,
                      "description": "Default database created when image is started.",
                      "defaultValue": "railway"
                    },
                    "DATABASE_URL": {
                      "isOptional": false,
                      "description": "URL to connect to Postgres database.",
                      "defaultValue": "postgresql://${{PGUSER}}:${{POSTGRES_PASSWORD}}@${{RAILWAY_PRIVATE_DOMAIN}}:5432/${{PGDATABASE}}"
                    },
                    "POSTGRES_USER": {
                      "isOptional": false,
                      "description": "User to connect to Postgres DB",
                      "defaultValue": "postgres"
                    },
                    "SSL_CERT_DAYS": {
                      "isOptional": true,
                      "description": "SSL certificate expiry in days.",
                      "defaultValue": "820"
                    },
                    "POSTGRES_PASSWORD": {
                      "isOptional": false,
                      "description": "Password to connect to DB",
                      "defaultValue": "{{POSTGRES_PASSWORD}}"
                    },
                    "DATABASE_PUBLIC_URL": {
                      "description": "Public URL to connect to Postgres database, used by the Data panel.",
                      "defaultValue": "postgresql://${{PGUSER}}:${{POSTGRES_PASSWORD}}@${{RAILWAY_TCP_PROXY_DOMAIN}}:${{RAILWAY_TCP_PROXY_PORT}}/${{PGDATABASE}}"
                    },
                    "RAILWAY_DEPLOYMENT_DRAINING_SECONDS": {
                      "isOptional": false,
                      "description": "Allow Postgres to cleanly shut down",
                      "defaultValue": "60"
                    }
                  },
                  "networking": {
                    "tcpProxies": {
                      "5432": {}
                    },
                    "serviceDomains": {}
                  },
                  "volumeMounts": {
                    "753ef4cf-53a2-4d9f-b2bc-62058adb4fbf": {
                      "mountPath": "/var/lib/postgresql/data"
                    }
                  },
                  "haTemplateCode": "postgres-ha",
                  "haConversionConfig": {
                    "edge": {
                      "label": "Reverse Proxy",
                      "options": [
                        2,
                        3,
                        4,
                        5
                      ],
                      "nodeLabel": "HAProxy",
                      "description": "Routes traffic to the primary",
                      "defaultValue": 3
                    },
                    "replica": {
                      "label": "Replicas",
                      "options": [
                        2,
                        3,
                        4,
                        5,
                        6,
                        7
                      ],
                      "nodeLabel": "Postgres",
                      "description": "Streaming replicas for automatic failover",
                      "defaultValue": 2
                    },
                    "internal": {
                      "label": "Coordinator Nodes",
                      "options": [
                        3,
                        5,
                        7,
                        9
                      ],
                      "nodeLabel": "etcd",
                      "defaultValue": 3
                    },
                    "description": "This will convert your Postgres database to an HA cluster with Patroni failover and etcd consensus."
                  }
                },
                "dcfb0565-7781-492a-805e-39b727b0ddad": {
                  "icon": "https://devicons.railway.app/ClickHouse?variant=light",
                  "name": "ClickHouse",
                  "deploy": {
                    "startCommand": "bash -c 'echo \"<clickhouse><custom_settings_prefixes>SQL_</custom_settings_prefixes></clickhouse>\" > /etc/clickhouse-server/config.d/custom.xml && /entrypoint.sh'",
                    "healthcheckPath": "/ping",
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "clickhouse/clickhouse-server:25.8"
                  },
                  "variables": {
                    "HOST": {
                      "isOptional": false,
                      "description": "Clickhouse host url",
                      "defaultValue": "${{RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "PORT": {
                      "isOptional": false,
                      "description": "Clickhouse port",
                      "defaultValue": "8123"
                    },
                    "HOST_PORT": {
                      "isOptional": false,
                      "description": "Clickhouse host port",
                      "defaultValue": "${{HOST}}:${{PORT}}"
                    },
                    "PUBLIC_HOST": {
                      "isOptional": false,
                      "description": "Clickhouse host",
                      "defaultValue": "${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "PUBLIC_PORT": {
                      "isOptional": false,
                      "description": "Clickhouse public port",
                      "defaultValue": "443"
                    },
                    "DATABASE_URL": {
                      "isOptional": false,
                      "description": "Clickhouse database url",
                      "defaultValue": "http://${{CLICKHOUSE_USER}}:${{CLICKHOUSE_PASSWORD}}@${{HOST}}:${{PORT}}/${{CLICKHOUSE_DB}}"
                    },
                    "CLICKHOUSE_DB": {
                      "isOptional": false,
                      "description": "Clickhouse DB name",
                      "defaultValue": "breadcrumb"
                    },
                    "CLICKHOUSE_USER": {
                      "isOptional": false,
                      "description": "Clickhouse user name",
                      "defaultValue": "clickhouse"
                    },
                    "PUBLIC_HOST_PORT": {
                      "isOptional": false,
                      "description": "Clickhouse public host port",
                      "defaultValue": "${{PUBLIC_HOST}}:${{PUBLIC_PORT}}"
                    },
                    "DATABASE_JDBC_URL": {
                      "isOptional": false,
                      "description": "Clickhouse JDBC url",
                      "defaultValue": "jdbc:clickhouse://${{CLICKHOUSE_USER}}:${{CLICKHOUSE_PASSWORD}}@${{HOST}}:${{PORT}}/${{CLICKHOUSE_DB}}"
                    },
                    "CLICKHOUSE_PASSWORD": {
                      "isOptional": false,
                      "description": "Clickhouse password",
                      "defaultValue": "{{CLICKHOUSE_PASSWORD}}"
                    },
                    "PUBLIC_DATABASE_URL": {
                      "isOptional": false,
                      "description": "Clickhouse public databse url",
                      "defaultValue": "https://${{CLICKHOUSE_USER}}:${{CLICKHOUSE_PASSWORD}}@${{PUBLIC_HOST}}:${{PUBLIC_PORT}}/${{CLICKHOUSE_DB}}"
                    },
                    "PUBLIC_DATABASE_JDBC_URL": {
                      "isOptional": false,
                      "description": "Clickhouse public database jdbc url",
                      "defaultValue": "jdbc:clickhouse://${{CLICKHOUSE_USER}}:${{CLICKHOUSE_PASSWORD}}@${{PUBLIC_HOST}}:${{PUBLIC_PORT}}/${{CLICKHOUSE_DB}}"
                    },
                    "CLICKHOUSE_DEFAULT_ACCESS_MANAGEMENT": {
                      "isOptional": false,
                      "description": "Default role permissions",
                      "defaultValue": "1"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>": {}
                    }
                  },
                  "volumeMounts": {
                    "dcfb0565-7781-492a-805e-39b727b0ddad": {
                      "mountPath": "/var/lib/clickhouse"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {
    "healthcheck": {
      "service": "breadcrumb",
      "method": "GET",
      "path": "/health",
      "expect_status": 200
    }
  },
  "resources": {
    "expected_services": 3,
    "needs_volume": true
  },
  "generated_at": "2026-09-20T10:14:37.339Z",
  "generator_version": "0.1.0",
  "status": "degraded",
  "validated_at": "2026-09-18T11:22:28.323Z",
  "success_rate_30d": 0,
  "validation": {
    "last_run_id": "run_7a14340c51c74953a7ee",
    "checks": [
      {
        "name": "workflow_completed",
        "passed": true
      },
      {
        "name": "all_services_deployed",
        "passed": false,
        "detail": "FAILED,SUCCESS,DEPLOYING"
      }
    ]
  }
}