{
  "manifest_version": "1.0.0",
  "template": {
    "id": "467da6cf-2567-4d19-b27e-be1e01f4d633",
    "slug": "ragflow-v027-document-ai-engine",
    "name": "RAGFlow v0.27 Document AI Engine",
    "description": "Chat with PDFs, contracts and docs. Deep-document RAG with Elasticsearch.",
    "url": "https://railway.com/deploy/ragflow-v027-document-ai-engine",
    "upstream": {
      "repo_url": "https://github.com/baranberkay96/ragflow-railway"
    }
  },
  "services": [
    {
      "name": "ragflow",
      "source": {
        "repo": "https://github.com/baranberkay96/ragflow-railway"
      },
      "needs_volume": false,
      "http": true
    },
    {
      "name": "ragflow-worker",
      "source": {
        "repo": "https://github.com/baranberkay96/ragflow-railway"
      },
      "needs_volume": false,
      "http": false
    },
    {
      "name": "Redis",
      "source": {
        "image": "redis:8.2"
      },
      "needs_volume": true,
      "volume_mount_path": "/data",
      "http": false
    },
    {
      "name": "MySQL",
      "source": {
        "image": "mysql:9"
      },
      "needs_volume": true,
      "volume_mount_path": "/var/lib/mysql",
      "http": false
    },
    {
      "name": "Elasticsearch",
      "source": {
        "repo": "https://github.com/baranberkay96/ragflow-railway"
      },
      "needs_volume": true,
      "volume_mount_path": "/usr/share/elasticsearch/data",
      "http": false
    }
  ],
  "required_inputs": [
    {
      "key": "TZ",
      "service": "ragflow",
      "description": "Container timezone (upstream .env uses Asia/Shanghai).",
      "secret": false,
      "strategy": "default",
      "default": "UTC"
    },
    {
      "key": "PORT",
      "service": "ragflow",
      "description": "nginx port serving the UI and proxying the API (public domain target).",
      "secret": false,
      "strategy": "default",
      "default": "80"
    },
    {
      "key": "DEVICE",
      "service": "ragflow",
      "description": "CPU image; Railway has no GPUs.",
      "secret": false,
      "strategy": "default",
      "default": "cpu"
    },
    {
      "key": "ES_HOST",
      "service": "ragflow",
      "description": "Elasticsearch host (private network, port 9200).",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "ES_USER",
      "service": "ragflow",
      "description": "Elasticsearch user.",
      "secret": false,
      "strategy": "default",
      "default": "elastic"
    },
    {
      "key": "S3_BUCKET",
      "service": "ragflow",
      "description": "Railway Bucket name (single-bucket mode).",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "S3_REGION",
      "service": "ragflow",
      "description": "Railway Bucket region.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "DOC_ENGINE",
      "service": "ragflow",
      "description": "Document/vector engine (upstream default).",
      "secret": false,
      "strategy": "default",
      "default": "elasticsearch"
    },
    {
      "key": "MYSQL_HOST",
      "service": "ragflow",
      "description": "MySQL host (private network).",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "MYSQL_PORT",
      "service": "ragflow",
      "description": "MySQL port.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "MYSQL_USER",
      "service": "ragflow",
      "description": "MySQL user (root, as upstream).",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "REDIS_HOST",
      "service": "ragflow",
      "description": "Redis host (task queue, locks, caches).",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "REDIS_PORT",
      "service": "ragflow",
      "description": "Redis port.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "HF_ENDPOINT",
      "service": "ragflow",
      "description": "Model download endpoint. The image defaults to a China mirror (hf-mirror.com).",
      "secret": false,
      "strategy": "default",
      "default": "https://huggingface.co"
    },
    {
      "key": "MYSQL_DBNAME",
      "service": "ragflow",
      "description": "Database for RAGFlow metadata (created by the MySQL image).",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "RAGFLOW_ROLE",
      "service": "ragflow",
      "description": "Runs nginx/UI, API server, admin server and data-source sync (no parsing workers).",
      "secret": false,
      "strategy": "default",
      "default": "web"
    },
    {
      "key": "STORAGE_IMPL",
      "service": "ragflow",
      "description": "Store uploaded files and parsed images in S3 (Railway Bucket) instead of MinIO.",
      "secret": false,
      "strategy": "default",
      "default": "AWS_S3"
    },
    {
      "key": "S3_ACCESS_KEY",
      "service": "ragflow",
      "description": "Bucket access key.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "S3_SECRET_KEY",
      "service": "ragflow",
      "description": "Bucket secret key.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "MYSQL_PASSWORD",
      "service": "ragflow",
      "description": "MySQL password (reference).",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "REDIS_PASSWORD",
      "service": "ragflow",
      "description": "Redis password.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "S3_PREFIX_PATH",
      "service": "ragflow",
      "description": "Key prefix; files are stored as <prefix>/<dataset-id>/<file> so per-dataset deletes stay scoped.",
      "secret": false,
      "strategy": "default",
      "default": "ragflow"
    },
    {
      "key": "S3_ENDPOINT_URL",
      "service": "ragflow",
      "description": "Railway Bucket S3 endpoint.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "API_PROXY_SCHEME",
      "service": "ragflow",
      "description": "Use the Python API server behind the bundled nginx (upstream default).",
      "secret": false,
      "strategy": "default",
      "default": "python"
    },
    {
      "key": "ELASTIC_PASSWORD",
      "service": "ragflow",
      "description": "Elasticsearch password (reference).",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "REGISTER_ENABLED",
      "service": "ragflow",
      "description": "Allow sign-up so you can create the first account. Set to 0 after your team has registered.",
      "secret": false,
      "strategy": "default",
      "default": "1"
    },
    {
      "key": "RAGFLOW_SECRET_KEY",
      "service": "ragflow",
      "description": "Signs sessions and tokens. Generated once; shared with ragflow-worker.",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "S3_ADDRESSING_STYLE",
      "service": "ragflow",
      "description": "Railway Buckets require virtual-hosted-style requests.",
      "secret": false,
      "strategy": "default",
      "default": "virtual"
    },
    {
      "key": "ADMIN_DEFAULT_PASSWORD",
      "service": "ragflow",
      "description": "Password of the built-in superuser admin@ragflow.io (admin server). Generated instead of upstream's 'admin'.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "TZ",
      "service": "ragflow-worker",
      "description": "Container timezone (upstream .env uses Asia/Shanghai).",
      "secret": false,
      "strategy": "default",
      "default": "UTC"
    },
    {
      "key": "DEVICE",
      "service": "ragflow-worker",
      "description": "CPU image; Railway has no GPUs.",
      "secret": false,
      "strategy": "default",
      "default": "cpu"
    },
    {
      "key": "ES_HOST",
      "service": "ragflow-worker",
      "description": "Elasticsearch host (private network, port 9200).",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "ES_USER",
      "service": "ragflow-worker",
      "description": "Elasticsearch user.",
      "secret": false,
      "strategy": "default",
      "default": "elastic"
    },
    {
      "key": "S3_BUCKET",
      "service": "ragflow-worker",
      "description": "Railway Bucket name (single-bucket mode).",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "S3_REGION",
      "service": "ragflow-worker",
      "description": "Railway Bucket region.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "DOC_ENGINE",
      "service": "ragflow-worker",
      "description": "Document/vector engine (upstream default).",
      "secret": false,
      "strategy": "default",
      "default": "elasticsearch"
    },
    {
      "key": "MYSQL_HOST",
      "service": "ragflow-worker",
      "description": "MySQL host (private network).",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "MYSQL_PORT",
      "service": "ragflow-worker",
      "description": "MySQL port.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "MYSQL_USER",
      "service": "ragflow-worker",
      "description": "MySQL user (root, as upstream).",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "REDIS_HOST",
      "service": "ragflow-worker",
      "description": "Redis host (task queue, locks, caches).",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "REDIS_PORT",
      "service": "ragflow-worker",
      "description": "Redis port.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "HF_ENDPOINT",
      "service": "ragflow-worker",
      "description": "Model download endpoint. The image defaults to a China mirror (hf-mirror.com).",
      "secret": false,
      "strategy": "default",
      "default": "https://huggingface.co"
    },
    {
      "key": "MYSQL_DBNAME",
      "service": "ragflow-worker",
      "description": "Database for RAGFlow metadata (created by the MySQL image).",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "RAGFLOW_ROLE",
      "service": "ragflow-worker",
      "description": "Runs only document-parsing task executors.",
      "secret": false,
      "strategy": "default",
      "default": "worker"
    },
    {
      "key": "STORAGE_IMPL",
      "service": "ragflow-worker",
      "description": "Store uploaded files and parsed images in S3 (Railway Bucket) instead of MinIO.",
      "secret": false,
      "strategy": "default",
      "default": "AWS_S3"
    },
    {
      "key": "S3_ACCESS_KEY",
      "service": "ragflow-worker",
      "description": "Bucket access key.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "S3_SECRET_KEY",
      "service": "ragflow-worker",
      "description": "Bucket secret key.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "MYSQL_PASSWORD",
      "service": "ragflow-worker",
      "description": "MySQL password (reference).",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "REDIS_PASSWORD",
      "service": "ragflow-worker",
      "description": "Redis password.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "S3_PREFIX_PATH",
      "service": "ragflow-worker",
      "description": "Key prefix; files are stored as <prefix>/<dataset-id>/<file> so per-dataset deletes stay scoped.",
      "secret": false,
      "strategy": "default",
      "default": "ragflow"
    },
    {
      "key": "S3_ENDPOINT_URL",
      "service": "ragflow-worker",
      "description": "Railway Bucket S3 endpoint.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "API_PROXY_SCHEME",
      "service": "ragflow-worker",
      "description": "Use the Python API server behind the bundled nginx (upstream default).",
      "secret": false,
      "strategy": "default",
      "default": "python"
    },
    {
      "key": "ELASTIC_PASSWORD",
      "service": "ragflow-worker",
      "description": "Elasticsearch password (reference).",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "RAGFLOW_SECRET_KEY",
      "service": "ragflow-worker",
      "description": "Must match the ragflow service.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "S3_ADDRESSING_STYLE",
      "service": "ragflow-worker",
      "description": "Railway Buckets require virtual-hosted-style requests.",
      "secret": false,
      "strategy": "default",
      "default": "virtual"
    },
    {
      "key": "RAGFLOW_TASK_EXECUTORS",
      "service": "ragflow-worker",
      "description": "Task executor processes in this container (~1.5-3 GB RAM each while parsing). Scale with this or with replicas.",
      "secret": false,
      "strategy": "default",
      "default": "1"
    },
    {
      "key": "REDISHOST",
      "service": "Redis",
      "description": "Private network hostname of the Redis service, only resolvable from services in the same environment",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "REDISPORT",
      "service": "Redis",
      "description": "Port that Redis listens on",
      "secret": false,
      "strategy": "default",
      "default": "6379"
    },
    {
      "key": "REDISUSER",
      "service": "Redis",
      "description": "Username for authenticating with Redis",
      "secret": false,
      "strategy": "default",
      "default": "default"
    },
    {
      "key": "REDIS_URL",
      "service": "Redis",
      "description": "Connection string for connecting to Redis using the private network",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "REDISPASSWORD",
      "service": "Redis",
      "description": "Alias of REDIS_PASSWORD for clients that expect the unseparated name",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "REDIS_PASSWORD",
      "service": "Redis",
      "description": "Randomly generated password for authenticating with Redis",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "MYSQLHOST",
      "service": "MySQL",
      "description": "Railway Private Domain Name.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "MYSQLPORT",
      "service": "MySQL",
      "description": "MySQL port.",
      "secret": false,
      "strategy": "default",
      "default": "3306"
    },
    {
      "key": "MYSQLUSER",
      "service": "MySQL",
      "description": "MySQL user, used for the Data panel.",
      "secret": false,
      "strategy": "default",
      "default": "root"
    },
    {
      "key": "MYSQL_URL",
      "service": "MySQL",
      "description": "URL to connect to MySQL.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "MYSQLDATABASE",
      "service": "MySQL",
      "description": "Default database, used for Data panel.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "MYSQLPASSWORD",
      "service": "MySQL",
      "description": "Root password, used for Data panel.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "MYSQL_DATABASE",
      "service": "MySQL",
      "description": "Database to be created on image startup.",
      "secret": false,
      "strategy": "default",
      "default": "railway"
    },
    {
      "key": "MYSQL_ROOT_PASSWORD",
      "service": "MySQL",
      "description": "Root password for MySQL DB.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "ES_JAVA_OPTS",
      "service": "Elasticsearch",
      "description": "JVM heap. Keep about half of the RAM you want ES to use; without it ES sizes the heap from the host.",
      "secret": false,
      "strategy": "default",
      "default": "-Xms2g -Xmx2g"
    },
    {
      "key": "network.host",
      "service": "Elasticsearch",
      "description": "Bind address. 0.0.0.0, not '::': the image writes these settings to YAML unquoted and '::' breaks the parse. Java binds dual-stack here.",
      "secret": false,
      "strategy": "default",
      "default": "0.0.0.0"
    },
    {
      "key": "discovery.type",
      "service": "Elasticsearch",
      "description": "Single-node cluster (also skips production bootstrap checks).",
      "secret": false,
      "strategy": "default",
      "default": "single-node"
    },
    {
      "key": "ELASTIC_PASSWORD",
      "service": "Elasticsearch",
      "description": "Password of the elastic user, generated.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "bootstrap.memory_lock",
      "service": "Elasticsearch",
      "description": "memlock ulimits cannot be raised on Railway.",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "node.store.allow_mmap",
      "service": "Elasticsearch",
      "description": "Do not depend on the host's vm.max_map_count, which containers cannot change.",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "xpack.security.enabled",
      "service": "Elasticsearch",
      "description": "Require the elastic user's password (as upstream).",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "ingest.geoip.downloader.enabled",
      "service": "Elasticsearch",
      "description": "Skip GeoIP database downloads (unused by RAGFlow).",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "xpack.security.http.ssl.enabled",
      "service": "Elasticsearch",
      "description": "Plain HTTP inside the private network (as upstream).",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "RAILWAY_DEPLOYMENT_DRAINING_SECONDS",
      "service": "Elasticsearch",
      "description": "Allow a clean shutdown on redeploy.",
      "secret": false,
      "strategy": "default",
      "default": "60"
    },
    {
      "key": "xpack.security.transport.ssl.enabled",
      "service": "Elasticsearch",
      "description": "No transport TLS for a single node (as upstream).",
      "secret": false,
      "strategy": "default",
      "default": "false"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "ragflow-v027-document-ai-engine"
      }
    },
    "cli": "railway deploy --template ragflow-v027-document-ai-engine",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "467da6cf-2567-4d19-b27e-be1e01f4d633",
            "serializedConfig": {
              "buckets": {
                "db9594db-185a-5b52-b04f-df9304ef0c8d": {
                  "name": "Bucket"
                }
              },
              "services": {
                "a73b04cc-7b89-5fba-8d1e-1ad5f295f819": {
                  "icon": "https://raw.githubusercontent.com/infiniflow/ragflow/main/web/public/logo.svg",
                  "name": "ragflow",
                  "build": {
                    "builder": "DOCKERFILE"
                  },
                  "deploy": {
                    "healthcheckPath": "/api/v1/system/healthz",
                    "restartPolicyType": "ON_FAILURE",
                    "healthcheckTimeout": 900,
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "baranberkay96/ragflow-railway",
                    "branch": "main",
                    "rootDirectory": "/services/ragflow"
                  },
                  "variables": {
                    "TZ": {
                      "isOptional": true,
                      "description": "Container timezone (upstream .env uses Asia/Shanghai).",
                      "defaultValue": "UTC"
                    },
                    "PORT": {
                      "isOptional": true,
                      "description": "nginx port serving the UI and proxying the API (public domain target).",
                      "defaultValue": "80"
                    },
                    "DEVICE": {
                      "isOptional": true,
                      "description": "CPU image; Railway has no GPUs.",
                      "defaultValue": "cpu"
                    },
                    "ES_HOST": {
                      "isOptional": true,
                      "description": "Elasticsearch host (private network, port 9200).",
                      "defaultValue": "${{Elasticsearch.RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "ES_USER": {
                      "isOptional": true,
                      "description": "Elasticsearch user.",
                      "defaultValue": "elastic"
                    },
                    "S3_BUCKET": {
                      "isOptional": true,
                      "description": "Railway Bucket name (single-bucket mode).",
                      "defaultValue": "${{Bucket.BUCKET}}"
                    },
                    "S3_REGION": {
                      "isOptional": true,
                      "description": "Railway Bucket region.",
                      "defaultValue": "${{Bucket.REGION}}"
                    },
                    "DOC_ENGINE": {
                      "isOptional": true,
                      "description": "Document/vector engine (upstream default).",
                      "defaultValue": "elasticsearch"
                    },
                    "MYSQL_HOST": {
                      "isOptional": true,
                      "description": "MySQL host (private network).",
                      "defaultValue": "${{MySQL.MYSQLHOST}}"
                    },
                    "MYSQL_PORT": {
                      "isOptional": true,
                      "description": "MySQL port.",
                      "defaultValue": "${{MySQL.MYSQLPORT}}"
                    },
                    "MYSQL_USER": {
                      "isOptional": true,
                      "description": "MySQL user (root, as upstream).",
                      "defaultValue": "${{MySQL.MYSQLUSER}}"
                    },
                    "REDIS_HOST": {
                      "isOptional": true,
                      "description": "Redis host (task queue, locks, caches).",
                      "defaultValue": "${{Redis.REDISHOST}}"
                    },
                    "REDIS_PORT": {
                      "isOptional": true,
                      "description": "Redis port.",
                      "defaultValue": "${{Redis.REDISPORT}}"
                    },
                    "HF_ENDPOINT": {
                      "isOptional": true,
                      "description": "Model download endpoint. The image defaults to a China mirror (hf-mirror.com).",
                      "defaultValue": "https://huggingface.co"
                    },
                    "MYSQL_DBNAME": {
                      "isOptional": true,
                      "description": "Database for RAGFlow metadata (created by the MySQL image).",
                      "defaultValue": "${{MySQL.MYSQL_DATABASE}}"
                    },
                    "RAGFLOW_ROLE": {
                      "isOptional": true,
                      "description": "Runs nginx/UI, API server, admin server and data-source sync (no parsing workers).",
                      "defaultValue": "web"
                    },
                    "STORAGE_IMPL": {
                      "isOptional": true,
                      "description": "Store uploaded files and parsed images in S3 (Railway Bucket) instead of MinIO.",
                      "defaultValue": "AWS_S3"
                    },
                    "S3_ACCESS_KEY": {
                      "isOptional": true,
                      "description": "Bucket access key.",
                      "defaultValue": "${{Bucket.ACCESS_KEY_ID}}"
                    },
                    "S3_SECRET_KEY": {
                      "isOptional": true,
                      "description": "Bucket secret key.",
                      "defaultValue": "${{Bucket.SECRET_ACCESS_KEY}}"
                    },
                    "MYSQL_PASSWORD": {
                      "isOptional": true,
                      "description": "MySQL password (reference).",
                      "defaultValue": "${{MySQL.MYSQL_ROOT_PASSWORD}}"
                    },
                    "REDIS_PASSWORD": {
                      "isOptional": true,
                      "description": "Redis password.",
                      "defaultValue": "${{Redis.REDIS_PASSWORD}}"
                    },
                    "S3_PREFIX_PATH": {
                      "isOptional": true,
                      "description": "Key prefix; files are stored as <prefix>/<dataset-id>/<file> so per-dataset deletes stay scoped.",
                      "defaultValue": "ragflow"
                    },
                    "S3_ENDPOINT_URL": {
                      "isOptional": true,
                      "description": "Railway Bucket S3 endpoint.",
                      "defaultValue": "${{Bucket.ENDPOINT}}"
                    },
                    "API_PROXY_SCHEME": {
                      "isOptional": true,
                      "description": "Use the Python API server behind the bundled nginx (upstream default).",
                      "defaultValue": "python"
                    },
                    "ELASTIC_PASSWORD": {
                      "isOptional": true,
                      "description": "Elasticsearch password (reference).",
                      "defaultValue": "${{Elasticsearch.ELASTIC_PASSWORD}}"
                    },
                    "REGISTER_ENABLED": {
                      "isOptional": true,
                      "description": "Allow sign-up so you can create the first account. Set to 0 after your team has registered.",
                      "defaultValue": "1"
                    },
                    "RAGFLOW_SECRET_KEY": {
                      "isOptional": true,
                      "description": "Signs sessions and tokens. Generated once; shared with ragflow-worker.",
                      "defaultValue": "{{RAGFLOW_SECRET_KEY}}"
                    },
                    "S3_ADDRESSING_STYLE": {
                      "isOptional": true,
                      "description": "Railway Buckets require virtual-hosted-style requests.",
                      "defaultValue": "virtual"
                    },
                    "ADMIN_DEFAULT_PASSWORD": {
                      "isOptional": true,
                      "description": "Password of the built-in superuser admin@ragflow.io (admin server). Generated instead of upstream's 'admin'.",
                      "defaultValue": "{{ADMIN_DEFAULT_PASSWORD}}"
                    }
                  },
                  "networking": {
                    "tcpProxies": {},
                    "serviceDomains": {
                      "<hasDomain>:80": {
                        "port": 80
                      }
                    }
                  }
                },
                "d32c4c68-4119-5414-b602-c102fda2c3af": {
                  "icon": "https://raw.githubusercontent.com/infiniflow/ragflow/main/web/public/logo.svg",
                  "name": "ragflow-worker",
                  "build": {
                    "builder": "DOCKERFILE"
                  },
                  "deploy": {
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "baranberkay96/ragflow-railway",
                    "branch": "main",
                    "rootDirectory": "/services/ragflow"
                  },
                  "variables": {
                    "TZ": {
                      "isOptional": true,
                      "description": "Container timezone (upstream .env uses Asia/Shanghai).",
                      "defaultValue": "UTC"
                    },
                    "DEVICE": {
                      "isOptional": true,
                      "description": "CPU image; Railway has no GPUs.",
                      "defaultValue": "cpu"
                    },
                    "ES_HOST": {
                      "isOptional": true,
                      "description": "Elasticsearch host (private network, port 9200).",
                      "defaultValue": "${{Elasticsearch.RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "ES_USER": {
                      "isOptional": true,
                      "description": "Elasticsearch user.",
                      "defaultValue": "elastic"
                    },
                    "S3_BUCKET": {
                      "isOptional": true,
                      "description": "Railway Bucket name (single-bucket mode).",
                      "defaultValue": "${{Bucket.BUCKET}}"
                    },
                    "S3_REGION": {
                      "isOptional": true,
                      "description": "Railway Bucket region.",
                      "defaultValue": "${{Bucket.REGION}}"
                    },
                    "DOC_ENGINE": {
                      "isOptional": true,
                      "description": "Document/vector engine (upstream default).",
                      "defaultValue": "elasticsearch"
                    },
                    "MYSQL_HOST": {
                      "isOptional": true,
                      "description": "MySQL host (private network).",
                      "defaultValue": "${{MySQL.MYSQLHOST}}"
                    },
                    "MYSQL_PORT": {
                      "isOptional": true,
                      "description": "MySQL port.",
                      "defaultValue": "${{MySQL.MYSQLPORT}}"
                    },
                    "MYSQL_USER": {
                      "isOptional": true,
                      "description": "MySQL user (root, as upstream).",
                      "defaultValue": "${{MySQL.MYSQLUSER}}"
                    },
                    "REDIS_HOST": {
                      "isOptional": true,
                      "description": "Redis host (task queue, locks, caches).",
                      "defaultValue": "${{Redis.REDISHOST}}"
                    },
                    "REDIS_PORT": {
                      "isOptional": true,
                      "description": "Redis port.",
                      "defaultValue": "${{Redis.REDISPORT}}"
                    },
                    "HF_ENDPOINT": {
                      "isOptional": true,
                      "description": "Model download endpoint. The image defaults to a China mirror (hf-mirror.com).",
                      "defaultValue": "https://huggingface.co"
                    },
                    "MYSQL_DBNAME": {
                      "isOptional": true,
                      "description": "Database for RAGFlow metadata (created by the MySQL image).",
                      "defaultValue": "${{MySQL.MYSQL_DATABASE}}"
                    },
                    "RAGFLOW_ROLE": {
                      "isOptional": true,
                      "description": "Runs only document-parsing task executors.",
                      "defaultValue": "worker"
                    },
                    "STORAGE_IMPL": {
                      "isOptional": true,
                      "description": "Store uploaded files and parsed images in S3 (Railway Bucket) instead of MinIO.",
                      "defaultValue": "AWS_S3"
                    },
                    "S3_ACCESS_KEY": {
                      "isOptional": true,
                      "description": "Bucket access key.",
                      "defaultValue": "${{Bucket.ACCESS_KEY_ID}}"
                    },
                    "S3_SECRET_KEY": {
                      "isOptional": true,
                      "description": "Bucket secret key.",
                      "defaultValue": "${{Bucket.SECRET_ACCESS_KEY}}"
                    },
                    "MYSQL_PASSWORD": {
                      "isOptional": true,
                      "description": "MySQL password (reference).",
                      "defaultValue": "${{MySQL.MYSQL_ROOT_PASSWORD}}"
                    },
                    "REDIS_PASSWORD": {
                      "isOptional": true,
                      "description": "Redis password.",
                      "defaultValue": "${{Redis.REDIS_PASSWORD}}"
                    },
                    "S3_PREFIX_PATH": {
                      "isOptional": true,
                      "description": "Key prefix; files are stored as <prefix>/<dataset-id>/<file> so per-dataset deletes stay scoped.",
                      "defaultValue": "ragflow"
                    },
                    "S3_ENDPOINT_URL": {
                      "isOptional": true,
                      "description": "Railway Bucket S3 endpoint.",
                      "defaultValue": "${{Bucket.ENDPOINT}}"
                    },
                    "API_PROXY_SCHEME": {
                      "isOptional": true,
                      "description": "Use the Python API server behind the bundled nginx (upstream default).",
                      "defaultValue": "python"
                    },
                    "ELASTIC_PASSWORD": {
                      "isOptional": true,
                      "description": "Elasticsearch password (reference).",
                      "defaultValue": "${{Elasticsearch.ELASTIC_PASSWORD}}"
                    },
                    "RAGFLOW_SECRET_KEY": {
                      "isOptional": true,
                      "description": "Must match the ragflow service.",
                      "defaultValue": "${{ragflow.RAGFLOW_SECRET_KEY}}"
                    },
                    "S3_ADDRESSING_STYLE": {
                      "isOptional": true,
                      "description": "Railway Buckets require virtual-hosted-style requests.",
                      "defaultValue": "virtual"
                    },
                    "RAGFLOW_TASK_EXECUTORS": {
                      "isOptional": true,
                      "description": "Task executor processes in this container (~1.5-3 GB RAM each while parsing). Scale with this or with replicas.",
                      "defaultValue": "1"
                    }
                  },
                  "networking": {
                    "tcpProxies": {},
                    "serviceDomains": {}
                  }
                },
                "dc74aee0-1e98-5c0a-81f2-e65b6d2c38b8": {
                  "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\"",
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "redis:8.2"
                  },
                  "variables": {
                    "REDISHOST": {
                      "isOptional": true,
                      "description": "Private network hostname of the Redis service, only resolvable from services in the same environment",
                      "defaultValue": "${{RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "REDISPORT": {
                      "isOptional": true,
                      "description": "Port that Redis listens on",
                      "defaultValue": "6379"
                    },
                    "REDISUSER": {
                      "isOptional": true,
                      "description": "Username for authenticating with Redis",
                      "defaultValue": "default"
                    },
                    "REDIS_URL": {
                      "isOptional": true,
                      "description": "Connection string for connecting to Redis using the private network",
                      "defaultValue": "redis://${{ REDISUSER }}:${{ REDIS_PASSWORD }}@${{ REDISHOST }}:${{ REDISPORT }}"
                    },
                    "REDISPASSWORD": {
                      "isOptional": true,
                      "description": "Alias of REDIS_PASSWORD for clients that expect the unseparated name",
                      "defaultValue": "${{REDIS_PASSWORD}}"
                    },
                    "REDIS_PASSWORD": {
                      "isOptional": true,
                      "description": "Randomly generated password for authenticating with Redis",
                      "defaultValue": "{{REDIS_PASSWORD}}"
                    }
                  },
                  "networking": {
                    "tcpProxies": {},
                    "serviceDomains": {}
                  },
                  "volumeMounts": {
                    "37b577d1-c736-5be1-af2a-b16cd9136016": {
                      "mountPath": "/data"
                    }
                  }
                },
                "e0f790ee-a852-56a6-b1e7-4a0539f9da55": {
                  "icon": "https://devicons.railway.app/i/mysql.svg",
                  "name": "MySQL",
                  "deploy": {
                    "startCommand": "docker-entrypoint.sh mysqld --innodb-use-native-aio=0 --disable-log-bin --performance_schema=0 --innodb-buffer-pool-size=1G --max-connections=1000 --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci",
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "mysql:9"
                  },
                  "variables": {
                    "MYSQLHOST": {
                      "isOptional": true,
                      "description": "Railway Private Domain Name.",
                      "defaultValue": "${{RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "MYSQLPORT": {
                      "isOptional": true,
                      "description": "MySQL port.",
                      "defaultValue": "3306"
                    },
                    "MYSQLUSER": {
                      "isOptional": true,
                      "description": "MySQL user, used for the Data panel.",
                      "defaultValue": "root"
                    },
                    "MYSQL_URL": {
                      "isOptional": true,
                      "description": "URL to connect to MySQL.",
                      "defaultValue": "mysql://${{ MYSQLUSER }}:${{ MYSQL_ROOT_PASSWORD }}@${{ RAILWAY_PRIVATE_DOMAIN }}:3306/${{ MYSQL_DATABASE }}"
                    },
                    "MYSQLDATABASE": {
                      "isOptional": true,
                      "description": "Default database, used for Data panel.",
                      "defaultValue": "${{ MYSQL_DATABASE }}"
                    },
                    "MYSQLPASSWORD": {
                      "isOptional": true,
                      "description": "Root password, used for Data panel.",
                      "defaultValue": "${{ MYSQL_ROOT_PASSWORD }}"
                    },
                    "MYSQL_DATABASE": {
                      "isOptional": true,
                      "description": "Database to be created on image startup.",
                      "defaultValue": "railway"
                    },
                    "MYSQL_ROOT_PASSWORD": {
                      "isOptional": true,
                      "description": "Root password for MySQL DB.",
                      "defaultValue": "{{MYSQL_ROOT_PASSWORD}}"
                    }
                  },
                  "networking": {
                    "tcpProxies": {},
                    "serviceDomains": {}
                  },
                  "volumeMounts": {
                    "d4bf0835-903c-5f48-b22b-2c951ebbec89": {
                      "mountPath": "/var/lib/mysql"
                    }
                  }
                },
                "fd00117a-2fd4-52c4-b6f4-e9c6b3118ca7": {
                  "icon": "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/elasticsearch.svg",
                  "name": "Elasticsearch",
                  "build": {
                    "builder": "DOCKERFILE"
                  },
                  "deploy": {
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "baranberkay96/ragflow-railway",
                    "branch": "main",
                    "rootDirectory": "/services/elasticsearch"
                  },
                  "variables": {
                    "ES_JAVA_OPTS": {
                      "isOptional": true,
                      "description": "JVM heap. Keep about half of the RAM you want ES to use; without it ES sizes the heap from the host.",
                      "defaultValue": "-Xms2g -Xmx2g"
                    },
                    "network.host": {
                      "isOptional": true,
                      "description": "Bind address. 0.0.0.0, not '::': the image writes these settings to YAML unquoted and '::' breaks the parse. Java binds dual-stack here.",
                      "defaultValue": "0.0.0.0"
                    },
                    "discovery.type": {
                      "isOptional": true,
                      "description": "Single-node cluster (also skips production bootstrap checks).",
                      "defaultValue": "single-node"
                    },
                    "ELASTIC_PASSWORD": {
                      "isOptional": true,
                      "description": "Password of the elastic user, generated.",
                      "defaultValue": "{{ELASTIC_PASSWORD}}"
                    },
                    "bootstrap.memory_lock": {
                      "isOptional": true,
                      "description": "memlock ulimits cannot be raised on Railway.",
                      "defaultValue": "false"
                    },
                    "node.store.allow_mmap": {
                      "isOptional": true,
                      "description": "Do not depend on the host's vm.max_map_count, which containers cannot change.",
                      "defaultValue": "false"
                    },
                    "xpack.security.enabled": {
                      "isOptional": true,
                      "description": "Require the elastic user's password (as upstream).",
                      "defaultValue": "true"
                    },
                    "ingest.geoip.downloader.enabled": {
                      "isOptional": true,
                      "description": "Skip GeoIP database downloads (unused by RAGFlow).",
                      "defaultValue": "false"
                    },
                    "xpack.security.http.ssl.enabled": {
                      "isOptional": true,
                      "description": "Plain HTTP inside the private network (as upstream).",
                      "defaultValue": "false"
                    },
                    "RAILWAY_DEPLOYMENT_DRAINING_SECONDS": {
                      "isOptional": true,
                      "description": "Allow a clean shutdown on redeploy.",
                      "defaultValue": "60"
                    },
                    "xpack.security.transport.ssl.enabled": {
                      "isOptional": true,
                      "description": "No transport TLS for a single node (as upstream).",
                      "defaultValue": "false"
                    }
                  },
                  "networking": {
                    "tcpProxies": {},
                    "serviceDomains": {}
                  },
                  "volumeMounts": {
                    "d923fef4-dbd0-5c17-b727-4c3197c1a1e2": {
                      "mountPath": "/usr/share/elasticsearch/data"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {
    "healthcheck": {
      "service": "ragflow",
      "method": "GET",
      "path": "/api/v1/system/healthz",
      "expect_status": 200
    }
  },
  "resources": {
    "expected_services": 5,
    "needs_volume": true
  },
  "generated_at": "2026-10-11T16:14:40.554Z",
  "generator_version": "0.1.0",
  "status": "degraded",
  "validated_at": "2026-10-11T14:41:20.191Z",
  "success_rate_30d": 0,
  "validation": {
    "last_run_id": "run_048324aff25e46eeb452",
    "checks": [
      {
        "name": "workflow_completed",
        "passed": false,
        "detail": "Your workspace has been restricted. Please contact support to resolve this."
      }
    ]
  }
}
