{
  "manifest_version": "1.0.0",
  "template": {
    "id": "3982ddd1-c18e-47f0-a50b-938bf6636007",
    "slug": "hoppscotch-api-client",
    "name": "Hoppscotch",
    "description": "Postman alternative. Test REST and GraphQL APIs in the browser",
    "url": "https://railway.com/deploy/hoppscotch-api-client",
    "upstream": {
      "image": "hoppscotch/hoppscotch:latest"
    }
  },
  "services": [
    {
      "name": "hoppscotch",
      "source": {
        "image": "hoppscotch/hoppscotch:latest"
      },
      "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",
      "http": false
    }
  ],
  "required_inputs": [
    {
      "key": "PORT",
      "service": "hoppscotch",
      "description": "Backend HTTP listening port",
      "secret": false,
      "strategy": "default",
      "default": "8080"
    },
    {
      "key": "TRUST_PROXY",
      "service": "hoppscotch",
      "description": "Read client IPs from proxy headers",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "DATABASE_URL",
      "service": "hoppscotch",
      "description": "Postgres connection string",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "NODE_OPTIONS",
      "service": "hoppscotch",
      "description": "Node heap ceiling for the container",
      "secret": false,
      "strategy": "default",
      "default": "--max-old-space-size=2048"
    },
    {
      "key": "VITE_BASE_URL",
      "service": "hoppscotch",
      "description": "Public app URL",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "VITE_ADMIN_URL",
      "service": "hoppscotch",
      "description": "Self-hosted admin dashboard URL",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "VITE_APP_TOS_LINK",
      "service": "hoppscotch",
      "description": "Terms of Service link",
      "secret": false,
      "strategy": "default",
      "default": "https://docs.hoppscotch.io/support/terms"
    },
    {
      "key": "DATA_ENCRYPTION_KEY",
      "service": "hoppscotch",
      "description": "32-char key encrypting all stored secrets",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "VITE_BACKEND_WS_URL",
      "service": "hoppscotch",
      "description": "Backend GraphQL subscriptions endpoint",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "WHITELISTED_ORIGINS",
      "service": "hoppscotch",
      "description": "Allowed request origins",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "VITE_BACKEND_API_URL",
      "service": "hoppscotch",
      "description": "Backend REST API endpoint",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "VITE_BACKEND_GQL_URL",
      "service": "hoppscotch",
      "description": "Backend GraphQL endpoint",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "VITE_SHORTCODE_BASE_URL",
      "service": "hoppscotch",
      "description": "Base URL for shared request links",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "ENABLE_SUBPATH_BASED_ACCESS",
      "service": "hoppscotch",
      "description": "Serve app, admin and backend on one domain",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "VITE_APP_PRIVACY_POLICY_LINK",
      "service": "hoppscotch",
      "description": "Privacy Policy link",
      "secret": false,
      "strategy": "default",
      "default": "https://docs.hoppscotch.io/support/privacy"
    },
    {
      "key": "WEBAPP_SERVER_SIGNING_SECRET",
      "service": "hoppscotch",
      "description": "Seeds the bundle signing key",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "PGDATA",
      "service": "Postgres",
      "description": "Data directory, a subdirectory of the volume mount",
      "secret": false,
      "strategy": "default",
      "default": "/var/lib/postgresql/data/pgdata"
    },
    {
      "key": "PGHOST",
      "service": "Postgres",
      "description": "Private hostname, reachable only inside the project",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "PGPORT",
      "service": "Postgres",
      "description": "Standard PostgreSQL port",
      "secret": false,
      "strategy": "default",
      "default": "5432"
    },
    {
      "key": "PGUSER",
      "service": "Postgres",
      "description": "libpq alias of the superuser name",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PGDATABASE",
      "service": "Postgres",
      "description": "libpq alias of the default database",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PGPASSWORD",
      "service": "Postgres",
      "description": "libpq alias of the superuser password",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "POSTGRES_DB",
      "service": "Postgres",
      "description": "Default database created on first boot",
      "secret": false,
      "strategy": "default",
      "default": "railway"
    },
    {
      "key": "DATABASE_URL",
      "service": "Postgres",
      "description": "Private connection string, use this from other services",
      "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": "Validity window of the generated self-signed TLS certificate",
      "secret": false,
      "strategy": "default",
      "default": "820"
    },
    {
      "key": "POSTGRES_PASSWORD",
      "service": "Postgres",
      "description": "Generated superuser password",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "DATABASE_PUBLIC_URL",
      "service": "Postgres",
      "description": "Public connection string over the TCP proxy, for external tools",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "RAILWAY_DEPLOYMENT_DRAINING_SECONDS",
      "service": "Postgres",
      "description": "Grace period for in-flight connections on redeploy",
      "secret": false,
      "strategy": "default",
      "default": "60"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "hoppscotch-api-client"
      }
    },
    "cli": "railway deploy --template hoppscotch-api-client",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "3982ddd1-c18e-47f0-a50b-938bf6636007",
            "serializedConfig": {
              "buckets": {},
              "services": {
                "43c3a0d4-7771-44af-9a62-045cd074d3a3": {
                  "icon": "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/hoppscotch.svg",
                  "name": "hoppscotch",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": "/health",
                    "preDeployCommand": [
                      "/bin/sh -c 'cd /dist/backend && for i in $(seq 1 30); do pnpm exec prisma migrate deploy && exit 0; echo \"migrate: database not ready, retry $i\"; sleep 5; done; echo \"migrate: giving up\"; exit 1'"
                    ],
                    "restartPolicyType": "ALWAYS",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "hoppscotch/hoppscotch:latest"
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "Backend HTTP listening port",
                      "defaultValue": "8080"
                    },
                    "TRUST_PROXY": {
                      "isOptional": false,
                      "description": "Read client IPs from proxy headers",
                      "defaultValue": "true"
                    },
                    "DATABASE_URL": {
                      "isOptional": false,
                      "description": "Postgres connection string",
                      "defaultValue": "${{Postgres.DATABASE_URL}}?connect_timeout=300"
                    },
                    "NODE_OPTIONS": {
                      "isOptional": false,
                      "description": "Node heap ceiling for the container",
                      "defaultValue": "--max-old-space-size=2048"
                    },
                    "VITE_BASE_URL": {
                      "isOptional": false,
                      "description": "Public app URL",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "VITE_ADMIN_URL": {
                      "isOptional": false,
                      "description": "Self-hosted admin dashboard URL",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}/admin"
                    },
                    "VITE_APP_TOS_LINK": {
                      "isOptional": false,
                      "description": "Terms of Service link",
                      "defaultValue": "https://docs.hoppscotch.io/support/terms"
                    },
                    "DATA_ENCRYPTION_KEY": {
                      "isOptional": false,
                      "description": "32-char key encrypting all stored secrets",
                      "defaultValue": "{{DATA_ENCRYPTION_KEY}}"
                    },
                    "VITE_BACKEND_WS_URL": {
                      "isOptional": false,
                      "description": "Backend GraphQL subscriptions endpoint",
                      "defaultValue": "wss://${{RAILWAY_PUBLIC_DOMAIN}}/backend/graphql"
                    },
                    "WHITELISTED_ORIGINS": {
                      "isOptional": false,
                      "description": "Allowed request origins",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}},app://hoppscotch,app://localhost_3200"
                    },
                    "VITE_BACKEND_API_URL": {
                      "isOptional": false,
                      "description": "Backend REST API endpoint",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}/backend/v1"
                    },
                    "VITE_BACKEND_GQL_URL": {
                      "isOptional": false,
                      "description": "Backend GraphQL endpoint",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}/backend/graphql"
                    },
                    "VITE_SHORTCODE_BASE_URL": {
                      "isOptional": false,
                      "description": "Base URL for shared request links",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "ENABLE_SUBPATH_BASED_ACCESS": {
                      "isOptional": false,
                      "description": "Serve app, admin and backend on one domain",
                      "defaultValue": "true"
                    },
                    "VITE_APP_PRIVACY_POLICY_LINK": {
                      "isOptional": false,
                      "description": "Privacy Policy link",
                      "defaultValue": "https://docs.hoppscotch.io/support/privacy"
                    },
                    "WEBAPP_SERVER_SIGNING_SECRET": {
                      "isOptional": false,
                      "description": "Seeds the bundle signing key",
                      "defaultValue": "{{WEBAPP_SERVER_SIGNING_SECRET}}"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>:80": {
                        "port": 80
                      }
                    }
                  }
                },
                "a6046404-942c-4c16-8df6-e1e3ebf13fa6": {
                  "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, a subdirectory of the volume mount",
                      "defaultValue": "/var/lib/postgresql/data/pgdata"
                    },
                    "PGHOST": {
                      "isOptional": false,
                      "description": "Private hostname, reachable only inside the project",
                      "defaultValue": "${{RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "PGPORT": {
                      "isOptional": false,
                      "description": "Standard PostgreSQL port",
                      "defaultValue": "5432"
                    },
                    "PGUSER": {
                      "isOptional": false,
                      "description": "libpq alias of the superuser name",
                      "defaultValue": "${{POSTGRES_USER}}"
                    },
                    "PGDATABASE": {
                      "isOptional": false,
                      "description": "libpq alias of the default database",
                      "defaultValue": "${{POSTGRES_DB}}"
                    },
                    "PGPASSWORD": {
                      "isOptional": false,
                      "description": "libpq alias of the superuser password",
                      "defaultValue": "${{POSTGRES_PASSWORD}}"
                    },
                    "POSTGRES_DB": {
                      "isOptional": false,
                      "description": "Default database created on first boot",
                      "defaultValue": "railway"
                    },
                    "DATABASE_URL": {
                      "isOptional": false,
                      "description": "Private connection string, use this from other services",
                      "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": "Validity window of the generated self-signed TLS certificate",
                      "defaultValue": "820"
                    },
                    "POSTGRES_PASSWORD": {
                      "isOptional": false,
                      "description": "Generated superuser password",
                      "defaultValue": "{{POSTGRES_PASSWORD}}"
                    },
                    "DATABASE_PUBLIC_URL": {
                      "description": "Public connection string over the TCP proxy, for external tools",
                      "defaultValue": "postgresql://${{PGUSER}}:${{POSTGRES_PASSWORD}}@${{RAILWAY_TCP_PROXY_DOMAIN}}:${{RAILWAY_TCP_PROXY_PORT}}/${{PGDATABASE}}"
                    },
                    "RAILWAY_DEPLOYMENT_DRAINING_SECONDS": {
                      "isOptional": false,
                      "description": "Grace period for in-flight connections on redeploy",
                      "defaultValue": "60"
                    }
                  },
                  "volumeMounts": {
                    "a6046404-942c-4c16-8df6-e1e3ebf13fa6": {
                      "mountPath": "/var/lib/postgresql/data"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {
    "healthcheck": {
      "service": "hoppscotch",
      "method": "GET",
      "path": "/health",
      "expect_status": 200
    }
  },
  "resources": {
    "expected_services": 2,
    "needs_volume": true
  },
  "generated_at": "2026-09-10T22:14:43.398Z",
  "generator_version": "0.1.0",
  "status": "validated",
  "validated_at": "2026-09-10T17:23:59.879Z",
  "success_rate_30d": 1,
  "validation": {
    "last_run_id": "run_e1050a6eb6ab48b8b839",
    "checks": [
      {
        "name": "workflow_completed",
        "passed": true
      },
      {
        "name": "all_services_deployed",
        "passed": true
      },
      {
        "name": "healthcheck",
        "passed": true
      },
      {
        "name": "stays_up",
        "passed": true
      }
    ],
    "typical_ready_seconds": 96,
    "typical_build_seconds": 0,
    "typical_start_seconds": 13,
    "slowest_service": "hoppscotch"
  }
}