{
  "manifest_version": "1.0.0",
  "template": {
    "id": "af4c495e-6d55-4631-8558-19c5b647e181",
    "slug": "openhands-ai-agent",
    "name": "OpenHands | Open Source Devin Alternative",
    "description": "Self-host the OpenHands AI software engineer agent on Railway",
    "url": "https://railway.com/deploy/openhands-ai-agent",
    "upstream": {
      "repo_url": "https://github.com/praveen-ks-2001/openhands-railway"
    }
  },
  "status": "unvalidated",
  "validated_at": null,
  "success_rate_30d": null,
  "services": [
    {
      "name": "OpenHands",
      "source": {
        "repo": "https://github.com/praveen-ks-2001/openhands-railway"
      },
      "needs_volume": true,
      "volume_mount_path": "/.openhands",
      "http": true
    }
  ],
  "required_inputs": [
    {
      "key": "PORT",
      "service": "OpenHands",
      "description": "Public port nginx listens on",
      "secret": false,
      "strategy": "default",
      "default": "3000"
    },
    {
      "key": "RUNTIME",
      "service": "OpenHands",
      "description": "Run agent in-process (Railway has no Docker socket)",
      "secret": false,
      "strategy": "default",
      "default": "local"
    },
    {
      "key": "LLM_MODEL",
      "service": "OpenHands",
      "description": "Optional: pre-fill default model name (e.g. claude-sonnet-4-6)",
      "secret": false,
      "strategy": "ask_user"
    },
    {
      "key": "FILE_STORE",
      "service": "OpenHands",
      "description": "File-based session storage",
      "secret": false,
      "strategy": "default",
      "default": "local"
    },
    {
      "key": "LLM_API_KEY",
      "service": "OpenHands",
      "description": "Optional: pre-fill LLM provider API key",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "LLM_BASE_URL",
      "service": "OpenHands",
      "description": "Optional: pre-fill custom LLM endpoint URL",
      "secret": false,
      "strategy": "ask_user"
    },
    {
      "key": "INTERNAL_PORT",
      "service": "OpenHands",
      "description": "Loopback port uvicorn binds to",
      "secret": false,
      "strategy": "default",
      "default": "3001"
    },
    {
      "key": "ENABLE_BROWSER",
      "service": "OpenHands",
      "description": "No X server in Railway containers",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "SERVE_FRONTEND",
      "service": "OpenHands",
      "description": "Serve UI from same uvicorn process",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "BASIC_AUTH_USER",
      "service": "OpenHands",
      "description": "Username for nginx basic-auth gate",
      "secret": false,
      "strategy": "default",
      "default": "admin"
    },
    {
      "key": "FILE_STORE_PATH",
      "service": "OpenHands",
      "description": "Volume mount path for sessions/settings",
      "secret": false,
      "strategy": "default",
      "default": "/.openhands"
    },
    {
      "key": "RAILWAY_RUN_UID",
      "service": "OpenHands",
      "description": "Allow Railway to start container as uid 0",
      "secret": false,
      "strategy": "default",
      "default": "0"
    },
    {
      "key": "SANDBOX_USER_ID",
      "service": "OpenHands",
      "description": "Run upstream entrypoint as root",
      "secret": false,
      "strategy": "default",
      "default": "0"
    },
    {
      "key": "PYTHONUNBUFFERED",
      "service": "OpenHands",
      "description": "Stream Python logs without buffering",
      "secret": false,
      "strategy": "default",
      "default": "1"
    },
    {
      "key": "RUN_AS_OPENHANDS",
      "service": "OpenHands",
      "description": "Match SANDBOX_USER_ID=0 branch in entrypoint",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "BASIC_AUTH_PASSWORD",
      "service": "OpenHands",
      "description": "Password for nginx basic-auth gate",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "SKIP_DEPENDENCY_CHECK",
      "service": "OpenHands",
      "description": "Tmux baked into image, skip cold-start probe",
      "secret": false,
      "strategy": "default",
      "default": "1"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "openhands-ai-agent"
      }
    },
    "cli": "railway deploy --template openhands-ai-agent",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "af4c495e-6d55-4631-8558-19c5b647e181",
            "serializedConfig": {
              "buckets": {},
              "services": {
                "7db1df47-6a86-46b8-982a-db4c9d56c356": {
                  "icon": "https://cdn.jsdelivr.net/gh/selfhst/icons/svg/openhands.svg",
                  "name": "OpenHands",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "https://github.com/praveen-ks-2001/openhands-railway",
                    "rootDirectory": null
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "Public port nginx listens on",
                      "defaultValue": "3000"
                    },
                    "RUNTIME": {
                      "isOptional": false,
                      "description": "Run agent in-process (Railway has no Docker socket)",
                      "defaultValue": "local"
                    },
                    "LLM_MODEL": {
                      "description": "Optional: pre-fill default model name (e.g. claude-sonnet-4-6)",
                      "defaultValue": "{{LLM_MODEL}}"
                    },
                    "FILE_STORE": {
                      "isOptional": false,
                      "description": "File-based session storage",
                      "defaultValue": "local"
                    },
                    "LLM_API_KEY": {
                      "description": "Optional: pre-fill LLM provider API key",
                      "defaultValue": "{{LLM_API_KEY}}"
                    },
                    "LLM_BASE_URL": {
                      "description": "Optional: pre-fill custom LLM endpoint URL",
                      "defaultValue": "{{LLM_BASE_URL}}"
                    },
                    "INTERNAL_PORT": {
                      "isOptional": false,
                      "description": "Loopback port uvicorn binds to",
                      "defaultValue": "3001"
                    },
                    "ENABLE_BROWSER": {
                      "isOptional": false,
                      "description": "No X server in Railway containers",
                      "defaultValue": "false"
                    },
                    "SERVE_FRONTEND": {
                      "isOptional": false,
                      "description": "Serve UI from same uvicorn process",
                      "defaultValue": "true"
                    },
                    "BASIC_AUTH_USER": {
                      "isOptional": false,
                      "description": "Username for nginx basic-auth gate",
                      "defaultValue": "admin"
                    },
                    "FILE_STORE_PATH": {
                      "isOptional": false,
                      "description": "Volume mount path for sessions/settings",
                      "defaultValue": "/.openhands"
                    },
                    "RAILWAY_RUN_UID": {
                      "isOptional": false,
                      "description": "Allow Railway to start container as uid 0",
                      "defaultValue": "0"
                    },
                    "SANDBOX_USER_ID": {
                      "isOptional": false,
                      "description": "Run upstream entrypoint as root",
                      "defaultValue": "0"
                    },
                    "PYTHONUNBUFFERED": {
                      "isOptional": false,
                      "description": "Stream Python logs without buffering",
                      "defaultValue": "1"
                    },
                    "RUN_AS_OPENHANDS": {
                      "isOptional": false,
                      "description": "Match SANDBOX_USER_ID=0 branch in entrypoint",
                      "defaultValue": "false"
                    },
                    "BASIC_AUTH_PASSWORD": {
                      "isOptional": false,
                      "description": "Password for nginx basic-auth gate",
                      "defaultValue": "{{BASIC_AUTH_PASSWORD}}"
                    },
                    "SKIP_DEPENDENCY_CHECK": {
                      "isOptional": false,
                      "description": "Tmux baked into image, skip cold-start probe",
                      "defaultValue": "1"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>": {}
                    }
                  },
                  "volumeMounts": {
                    "7db1df47-6a86-46b8-982a-db4c9d56c356": {
                      "mountPath": "/.openhands"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {},
  "resources": {
    "expected_services": 1,
    "needs_volume": true
  },
  "generated_at": "2026-09-21T22:14:44.200Z",
  "generator_version": "0.1.0"
}
