{
  "manifest_version": "1.0.0",
  "template": {
    "id": "14a4e7e4-0106-43ae-a653-885e3013cc51",
    "slug": "firecrawl-api",
    "name": "Firecrawl API [Updated Sep '26]",
    "description": "Firecrawl [Sep '26] (Web Scraping & Crawling API for LLMs) Self Host",
    "url": "https://railway.com/deploy/firecrawl-api",
    "upstream": {
      "repo_url": "https://github.com/shruti060701/firecrawl-railway"
    }
  },
  "services": [
    {
      "name": "Redis",
      "source": {
        "image": "redis:8.2.1"
      },
      "needs_volume": true,
      "volume_mount_path": "/data",
      "http": false
    },
    {
      "name": "observant-dream",
      "source": {
        "repo": "https://github.com/shruti060701/firecrawl-railway"
      },
      "needs_volume": false,
      "http": false
    },
    {
      "name": "poetic-wonder",
      "source": {
        "repo": "https://github.com/shruti060701/firecrawl-railway"
      },
      "needs_volume": false,
      "http": false
    },
    {
      "name": "independent-cat",
      "source": {
        "repo": "https://github.com/shruti060701/firecrawl-railway"
      },
      "needs_volume": true,
      "volume_mount_path": "/var/lib/postgresql/data",
      "http": false
    },
    {
      "name": "firecrawl-railway",
      "source": {
        "repo": "https://github.com/shruti060701/firecrawl-railway"
      },
      "needs_volume": false,
      "http": true
    }
  ],
  "required_inputs": [
    {
      "key": "REDISHOST",
      "service": "Redis",
      "description": "Internal hostname.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "REDISPORT",
      "service": "Redis",
      "description": "Port Redis listens on internally. Confirmed live, already filled in.",
      "secret": false,
      "strategy": "default",
      "default": "6379"
    },
    {
      "key": "REDISUSER",
      "service": "Redis",
      "description": "Redis username. ",
      "secret": false,
      "strategy": "default",
      "default": "default"
    },
    {
      "key": "REDIS_URL",
      "service": "Redis",
      "description": "Standard internal connection string, confirmed live and referenced directly by `firecrawl-railway`'s `REDIS_URL`/`REDIS_RATE_LIMIT_URL` above.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "REDISPASSWORD",
      "service": "Redis",
      "description": "Auto-generated password.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "REDIS_PASSWORD",
      "service": "Redis",
      "description": "Auto-generated password.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "REDIS_PUBLIC_URL",
      "service": "Redis",
      "description": "Public/external connection string. Confirmed live this shows as incomplete (`redis://default:<password>@:`) until a TCP Proxy is added under Settings → Networking, same pattern already documented for this project's pgvector template. Not needed for this template's own internal use.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PORT",
      "service": "poetic-wonder",
      "description": "Internal port the Playwright rendering service listens on. No public domain needed, confirmed live: this service has no `RAILWAY_PUBLIC_DOMAIN` variable at all, only `firecrawl-railway` connects to it over the private network.",
      "secret": false,
      "strategy": "default",
      "default": "3000"
    },
    {
      "key": "POSTGRES_DB",
      "service": "independent-cat",
      "description": "**Must be exactly `postgres`**, same pg_cron constraint as above. Must match `firecrawl-railway`'s own `POSTGRES_DB` exactly, confirmed matching live.",
      "secret": false,
      "strategy": "default",
      "default": "postgres"
    },
    {
      "key": "POSTGRES_USER",
      "service": "independent-cat",
      "description": "Must match `firecrawl-railway`'s own `POSTGRES_USER` exactly, confirmed matching live.",
      "secret": false,
      "strategy": "default",
      "default": "firecrawl"
    },
    {
      "key": "POSTGRES_PASSWORD",
      "service": "independent-cat",
      "description": "Must match exactly, not independently generated, or the API can't connect. Confirmed matching live.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "HOST",
      "service": "firecrawl-railway",
      "description": "Binds the server to all network interfaces so Railway's edge can route to it.",
      "secret": false,
      "strategy": "default",
      "default": "0.0.0.0"
    },
    {
      "key": "PORT",
      "service": "firecrawl-railway",
      "description": "Port Railway routes external traffic to. Must be an explicit Railway variable, this project has confirmed the hard way on multiple prior templates that a Dockerfile-only default alone doesn't reliably get picked up by Railway's edge routing. ",
      "secret": false,
      "strategy": "default",
      "default": "3002"
    },
    {
      "key": "REDIS_URL",
      "service": "firecrawl-railway",
      "description": "Redis connection string for the job queue and cache. Confirmed live: resolves to `redis://default:<password>@redis.railway.internal:6379`.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "POSTGRES_DB",
      "service": "firecrawl-railway",
      "description": "Database name. **Must be exactly `postgres`, confirmed via a real deploy crash: `pg_cron` is hardcoded to only work in a database literally named `postgres`** (`cron.database_name = 'postgres'` baked into the image), using any other name silently aborts the entire nuq schema init script, not just the pg_cron extension. Must match the postgres service's own `POSTGRES_DB` exactly.",
      "secret": false,
      "strategy": "default",
      "default": "postgres"
    },
    {
      "key": "BULL_AUTH_KEY",
      "service": "firecrawl-railway",
      "description": "Secures the Bull queue admin dashboard at `/admin/<key>/queues`. Confirmed live and working via a real request returning `200`. Firecrawl's own docs explicitly warn against leaving this at its documented default (`CHANGEME`) on any publicly-reachable deployment.",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "POSTGRES_HOST",
      "service": "firecrawl-railway",
      "description": "Internal hostname for the dedicated nuq-postgres queue backend. Confirmed live: resolves to `independent-cat.railway.internal`.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "POSTGRES_PORT",
      "service": "firecrawl-railway",
      "description": "Port the dedicated Postgres listens on.",
      "secret": false,
      "strategy": "default",
      "default": "5432"
    },
    {
      "key": "POSTGRES_USER",
      "service": "firecrawl-railway",
      "description": "Username for the dedicated Postgres. Must match the postgres service's own `POSTGRES_USER` exactly, confirmed matching live on both services.",
      "secret": false,
      "strategy": "default",
      "default": "firecrawl"
    },
    {
      "key": "NUQ_RABBITMQ_URL",
      "service": "firecrawl-railway",
      "description": "RabbitMQ connection string. Confirmed live: resolves to `amqp://observant-dream.railway.internal:5672`. **Critical, confirmed via Firecrawl's own docker-compose: the API container hard-depends on this being reachable to start at all.**",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "POSTGRES_PASSWORD",
      "service": "firecrawl-railway",
      "description": "Password for the dedicated Postgres.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "REDIS_RATE_LIMIT_URL",
      "service": "firecrawl-railway",
      "description": "Same Redis instance, used specifically for rate limiting.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "USE_DB_AUTHENTICATION",
      "service": "firecrawl-railway",
      "description": "Whether Supabase-based API authentication is enabled. **Confirmed via Firecrawl's own official docs that this is currently not configurable for self-hosted instances at all**, do not imply it can be turned on.",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "PLAYWRIGHT_MICROSERVICE_URL",
      "service": "firecrawl-railway",
      "description": "Internal URL of the Playwright rendering service. Confirmed live: resolves to `http://poetic-wonder.railway.internal:3000/scrape`.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "firecrawl-api"
      }
    },
    "cli": "railway deploy --template firecrawl-api",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "14a4e7e4-0106-43ae-a653-885e3013cc51",
            "serializedConfig": {
              "buckets": {},
              "services": {
                "0567c9b6-324e-4d65-90bb-024f404a98a5": {
                  "icon": "https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg",
                  "name": "Redis",
                  "deploy": {
                    "startCommand": "/bin/sh -c \"rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH\"",
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "redis:8.2.1"
                  },
                  "variables": {
                    "REDISHOST": {
                      "isOptional": false,
                      "description": "Internal hostname.",
                      "defaultValue": "${{RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "REDISPORT": {
                      "isOptional": false,
                      "description": "Port Redis listens on internally. Confirmed live, already filled in.",
                      "defaultValue": "6379"
                    },
                    "REDISUSER": {
                      "isOptional": false,
                      "description": "Redis username. ",
                      "defaultValue": "default"
                    },
                    "REDIS_URL": {
                      "isOptional": false,
                      "description": "Standard internal connection string, confirmed live and referenced directly by `firecrawl-railway`'s `REDIS_URL`/`REDIS_RATE_LIMIT_URL` above.",
                      "defaultValue": "redis://${{REDISUSER}}:${{REDIS_PASSWORD}}@${{REDISHOST}}:${{REDISPORT}}"
                    },
                    "REDISPASSWORD": {
                      "isOptional": false,
                      "description": "Auto-generated password.",
                      "defaultValue": "${{REDIS_PASSWORD}}"
                    },
                    "REDIS_PASSWORD": {
                      "isOptional": false,
                      "description": "Auto-generated password.",
                      "defaultValue": "{{REDIS_PASSWORD}}"
                    },
                    "REDIS_PUBLIC_URL": {
                      "isOptional": false,
                      "description": "Public/external connection string. Confirmed live this shows as incomplete (`redis://default:<password>@:`) until a TCP Proxy is added under Settings → Networking, same pattern already documented for this project's pgvector template. Not needed for this template's own internal use.",
                      "defaultValue": "redis://default:${{REDIS_PASSWORD}}@${{RAILWAY_TCP_PROXY_DOMAIN}}:${{RAILWAY_TCP_PROXY_PORT}}"
                    }
                  },
                  "volumeMounts": {
                    "0567c9b6-324e-4d65-90bb-024f404a98a5": {
                      "mountPath": "/data"
                    }
                  },
                  "haTemplateCode": "redis-ha",
                  "haConversionConfig": {
                    "edge": {
                      "label": "Reverse Proxies",
                      "options": [
                        1,
                        2
                      ],
                      "nodeLabel": "HAProxy",
                      "description": "HAProxy instances routing writes to the primary",
                      "defaultValue": 2
                    },
                    "replica": {
                      "label": "Redis Replicas",
                      "options": [
                        2,
                        3,
                        4,
                        5
                      ],
                      "nodeLabel": "Redis",
                      "description": "Nodes running Redis + colocated Sentinel",
                      "defaultValue": 2
                    },
                    "internal": null,
                    "description": "This will convert your Redis instance to an HA cluster with Sentinel failover and HAProxy routing to the primary."
                  }
                },
                "13e46c44-f426-4ece-a592-4a0d3bf8f100": {
                  "icon": "https://www.vectorlogo.zone/logos/rabbitmq/rabbitmq-icon.svg",
                  "name": "observant-dream",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "https://github.com/shruti060701/firecrawl-railway",
                    "rootDirectory": null
                  },
                  "variables": {}
                },
                "9746625c-f3ee-4480-b678-933ed09f42c7": {
                  "icon": "https://playwright.dev/python/img/playwright-logo.svg",
                  "name": "poetic-wonder",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "https://github.com/shruti060701/firecrawl-railway",
                    "rootDirectory": null
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "Internal port the Playwright rendering service listens on. No public domain needed, confirmed live: this service has no `RAILWAY_PUBLIC_DOMAIN` variable at all, only `firecrawl-railway` connects to it over the private network.",
                      "defaultValue": "3000"
                    }
                  }
                },
                "a910cb63-34bc-47d1-809a-bacc13d60a0f": {
                  "icon": "https://devicons.railway.app/postgres",
                  "name": "independent-cat",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "https://github.com/shruti060701/firecrawl-railway",
                    "rootDirectory": null
                  },
                  "variables": {
                    "POSTGRES_DB": {
                      "isOptional": true,
                      "description": "**Must be exactly `postgres`**, same pg_cron constraint as above. Must match `firecrawl-railway`'s own `POSTGRES_DB` exactly, confirmed matching live.",
                      "defaultValue": "postgres"
                    },
                    "POSTGRES_USER": {
                      "isOptional": true,
                      "description": "Must match `firecrawl-railway`'s own `POSTGRES_USER` exactly, confirmed matching live.",
                      "defaultValue": "firecrawl"
                    },
                    "POSTGRES_PASSWORD": {
                      "isOptional": false,
                      "description": "Must match exactly, not independently generated, or the API can't connect. Confirmed matching live.",
                      "defaultValue": "${{firecrawl-railway.POSTGRES_PASSWORD}}"
                    }
                  },
                  "volumeMounts": {
                    "a910cb63-34bc-47d1-809a-bacc13d60a0f": {
                      "mountPath": "/var/lib/postgresql/data"
                    }
                  }
                },
                "d982deaa-3380-45d9-9ed8-57af257dc79c": {
                  "icon": "https://res.cloudinary.com/dh2nt6hgh/image/upload/v1758463059/New_Project_2_bxehtv.webp",
                  "name": "firecrawl-railway",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": "/",
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "https://github.com/shruti060701/firecrawl-railway",
                    "rootDirectory": null
                  },
                  "variables": {
                    "HOST": {
                      "isOptional": false,
                      "description": "Binds the server to all network interfaces so Railway's edge can route to it.",
                      "defaultValue": "0.0.0.0"
                    },
                    "PORT": {
                      "isOptional": false,
                      "description": "Port Railway routes external traffic to. Must be an explicit Railway variable, this project has confirmed the hard way on multiple prior templates that a Dockerfile-only default alone doesn't reliably get picked up by Railway's edge routing. ",
                      "defaultValue": "3002"
                    },
                    "REDIS_URL": {
                      "isOptional": false,
                      "description": "Redis connection string for the job queue and cache. Confirmed live: resolves to `redis://default:<password>@redis.railway.internal:6379`.",
                      "defaultValue": "${{Redis.REDIS_URL}}"
                    },
                    "POSTGRES_DB": {
                      "isOptional": true,
                      "description": "Database name. **Must be exactly `postgres`, confirmed via a real deploy crash: `pg_cron` is hardcoded to only work in a database literally named `postgres`** (`cron.database_name = 'postgres'` baked into the image), using any other name silently aborts the entire nuq schema init script, not just the pg_cron extension. Must match the postgres service's own `POSTGRES_DB` exactly.",
                      "defaultValue": "postgres"
                    },
                    "BULL_AUTH_KEY": {
                      "isOptional": false,
                      "description": "Secures the Bull queue admin dashboard at `/admin/<key>/queues`. Confirmed live and working via a real request returning `200`. Firecrawl's own docs explicitly warn against leaving this at its documented default (`CHANGEME`) on any publicly-reachable deployment.",
                      "defaultValue": "{{BULL_AUTH_KEY}}"
                    },
                    "POSTGRES_HOST": {
                      "isOptional": false,
                      "description": "Internal hostname for the dedicated nuq-postgres queue backend. Confirmed live: resolves to `independent-cat.railway.internal`.",
                      "defaultValue": "${{independent-cat.RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "POSTGRES_PORT": {
                      "isOptional": false,
                      "description": "Port the dedicated Postgres listens on.",
                      "defaultValue": "5432"
                    },
                    "POSTGRES_USER": {
                      "isOptional": true,
                      "description": "Username for the dedicated Postgres. Must match the postgres service's own `POSTGRES_USER` exactly, confirmed matching live on both services.",
                      "defaultValue": "firecrawl"
                    },
                    "NUQ_RABBITMQ_URL": {
                      "isOptional": false,
                      "description": "RabbitMQ connection string. Confirmed live: resolves to `amqp://observant-dream.railway.internal:5672`. **Critical, confirmed via Firecrawl's own docker-compose: the API container hard-depends on this being reachable to start at all.**",
                      "defaultValue": "amqp://${{observant-dream.RAILWAY_PRIVATE_DOMAIN}}:5672"
                    },
                    "POSTGRES_PASSWORD": {
                      "isOptional": false,
                      "description": "Password for the dedicated Postgres.",
                      "defaultValue": "{{POSTGRES_PASSWORD}}"
                    },
                    "REDIS_RATE_LIMIT_URL": {
                      "isOptional": false,
                      "description": "Same Redis instance, used specifically for rate limiting.",
                      "defaultValue": "${{Redis.REDIS_URL}}"
                    },
                    "USE_DB_AUTHENTICATION": {
                      "isOptional": true,
                      "description": "Whether Supabase-based API authentication is enabled. **Confirmed via Firecrawl's own official docs that this is currently not configurable for self-hosted instances at all**, do not imply it can be turned on.",
                      "defaultValue": "false"
                    },
                    "PLAYWRIGHT_MICROSERVICE_URL": {
                      "isOptional": false,
                      "description": "Internal URL of the Playwright rendering service. Confirmed live: resolves to `http://poetic-wonder.railway.internal:3000/scrape`.",
                      "defaultValue": "http://${{poetic-wonder.RAILWAY_PRIVATE_DOMAIN}}:3000/scrape"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>": {}
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {
    "healthcheck": {
      "service": "firecrawl-railway",
      "method": "GET",
      "path": "/",
      "expect_status": 200
    }
  },
  "resources": {
    "expected_services": 5,
    "needs_volume": true
  },
  "generated_at": "2026-09-20T16:14:49.616Z",
  "generator_version": "0.1.0",
  "status": "degraded",
  "validated_at": "2026-09-20T01:12:52.644Z",
  "success_rate_30d": 0,
  "validation": {
    "last_run_id": "run_7f951be002454955bbda",
    "checks": [
      {
        "name": "workflow_completed",
        "passed": true
      },
      {
        "name": "all_services_deployed",
        "passed": false,
        "detail": "SUCCESS,QUEUED,DEPLOYING,CRASHED,SUCCESS"
      }
    ]
  }
}