diff --git a/apps/web/src/app/docs/executors/railway/page.tsx b/apps/web/src/app/docs/executors/railway/page.tsx
new file mode 100644
index 0000000..face0a8
--- /dev/null
+++ b/apps/web/src/app/docs/executors/railway/page.tsx
@@ -0,0 +1,442 @@
+import { Button } from '@tpmjs/ui/Button/Button';
+import { CodeBlock } from '@tpmjs/ui/CodeBlock/CodeBlock';
+import { Icon } from '@tpmjs/ui/Icon/Icon';
+import type { Metadata } from 'next';
+import Link from 'next/link';
+
+import { AppFooter } from '~/components/AppFooter';
+import { AppHeader } from '~/components/AppHeader';
+
+export const metadata: Metadata = {
+ title: 'Deploy to Railway - Custom Executors - TPMJS',
+ description:
+ 'Deploy a TPMJS executor to Railway with one click. Always-on, auto-scaling, with a generous free tier.',
+};
+
+const healthCheck = `curl https://your-executor.up.railway.app/health`;
+
+const healthResponse = `{
+ "status": "ok",
+ "version": "1.0.0",
+ "info": {
+ "runtime": "railway",
+ "timestamp": "2024-01-01T00:00:00.000Z",
+ "region": "us-west1"
+ }
+}`;
+
+const executeExample = `curl -X POST https://your-executor.up.railway.app/execute-tool \\
+ -H "Content-Type: application/json" \\
+ -H "Authorization: Bearer your-api-key" \\
+ -d '{
+ "packageName": "@tpmjs/hello",
+ "name": "helloWorldTool",
+ "version": "latest",
+ "params": { "includeTimestamp": true }
+ }'`;
+
+const cliDeploy = `# Clone the template
+git clone https://github.com/tpmjs/tpmjs.git
+cd tpmjs/templates/railway-executor
+
+# Install Railway CLI
+npm install -g @railway/cli
+
+# Login to Railway
+railway login
+
+# Create a new project and deploy
+railway init
+railway up`;
+
+const envVars = `# Set environment variables via CLI
+railway variables set EXECUTOR_API_KEY=your-secure-key
+railway variables set OPENAI_API_KEY=sk-xxx
+railway variables set DATABASE_URL=postgres://...`;
+
+const localDev = `# Clone the repository
+git clone https://github.com/tpmjs/tpmjs.git
+cd tpmjs/templates/railway-executor
+
+# Run locally
+PORT=3000 node index.js
+
+# Test health endpoint
+curl http://localhost:3000/health`;
+
+const dockerDeploy = `# Build the image
+docker build -t tpmjs-executor .
+
+# Run locally
+docker run -p 3000:3000 -e EXECUTOR_API_KEY=your-key tpmjs-executor`;
+
+export default function RailwayExecutorPage(): React.ReactElement {
+ return (
+
+
+
+
+
+ {/* Breadcrumb */}
+
+ Railway
+
+
+ {/* Header */}
+
+
+
+
+
Deploy to Railway
+
+ Always-on execution with auto-scaling and a free tier
+
+
+
+
+
+ {/* Why Railway */}
+
+
+
+
$5
+
Free monthly credit
+
+
+
+
Auto
+
Scaling built-in
+
+
+
+ {/* One-Click Deploy */}
+
+ One-Click Deploy
+
+ Deploy the TPMJS executor to Railway with a single click:
+
+
+
+
+
+ Deploy on Railway
+
+
+
+ After deployment, your executor will be available at{' '}
+
+ https://your-project.up.railway.app
+
+
+
+
+ {/* CLI Deploy */}
+
+ Deploy via CLI
+
+ Prefer the command line? Deploy with the Railway CLI:
+
+
+
+ {/* Test Your Deployment */}
+
+ Test Your Deployment
+ Verify your executor is running:
+ Expected response:
+
+
+ {/* Authentication */}
+
+ Add Authentication
+
+
+ Important: Without an API key, anyone can execute tools on your
+ executor. Always set{' '}
+ EXECUTOR_API_KEY in production.
+
+
+
+
+ 1
+
+ Go to your Railway project dashboard
+
+
+
+ 2
+
+ Click on your service, then go to "Variables"
+
+
+
+ 3
+
+
+ Add EXECUTOR_API_KEY with a
+ secure random value
+
+
+
+
+ 4
+
+ Railway will automatically redeploy with the new variable
+
+
+
+
+ {/* Environment Variables */}
+
+ Environment Variables
+
+ Add environment variables via the Railway dashboard or CLI:
+
+
+ These variables will be available during tool execution.
+
+
+
+ {/* Execute a Tool */}
+
+ Execute a Tool
+
+ Test tool execution with a curl request:
+
+
+
+ {/* Local Development */}
+
+ Local Development
+ Run the executor locally for testing:
+
+
+ {/* Docker */}
+
+ Docker Deployment
+
+ The template includes a Dockerfile for container deployments:
+
+
+ Railway will automatically detect and use the Dockerfile if present.
+
+
+
+ {/* How It Works */}
+
+ How It Works
+
+ The Railway executor runs as an always-on Node.js service:
+
+
+
+
+ 1
+
+
+ Receives tool execution request via HTTP POST to{' '}
+ /execute-tool
+
+
+
+
+ 2
+
+ Creates an isolated temporary directory for the execution
+
+
+
+ 3
+
+
+ Installs the npm package using{' '}
+ npm install
+
+
+
+
+ 4
+
+
+ Loads the tool and calls its{' '}
+ execute() function
+
+
+
+
+ 5
+
+ Returns the result and cleans up the temporary directory
+
+
+
+
+ {/* Security */}
+
+ Security
+
+
+
+ Set EXECUTOR_API_KEY to require
+ authentication
+
+
+
+ Each tool execution uses an isolated temporary directory
+
+
+ Environment variables stored encrypted by Railway
+
+
+ All traffic encrypted via HTTPS
+
+
+ Auto-restart on failure for high availability
+
+
+
+
+ {/* Pricing */}
+
+ Pricing
+
+ Railway offers usage-based pricing with a generous free tier:
+
+
+
+
+
+ Tier
+ Price
+ Includes
+
+
+
+
+ Free Tier
+ $0/month
+ $5 credit, enough for light usage
+
+
+ Usage-based
+ ~$0.000463/min
+ 0.5 vCPU, 512MB RAM
+
+
+
+
+ See{' '}
+
+ Railway Pricing
+ {' '}
+ for current rates.
+
+
+
+ {/* Connect to TPMJS */}
+
+ Connect to TPMJS
+
+ 1. Go to your collection or agent settings on TPMJS
+ 2. Select "Custom Executor" in Executor Configuration
+
+ 3. Enter URL:{' '}
+
+ https://your-project.up.railway.app
+
+
+ 4. Enter your API key (if configured)
+ 5. Click "Verify Connection"
+
+
+
+ {/* Navigation */}
+
+ Back to Executors
+
+ Unsandbox Guide
+
+
+
+
+
+ );
+}
diff --git a/apps/web/src/app/docs/executors/unsandbox/page.tsx b/apps/web/src/app/docs/executors/unsandbox/page.tsx
index 715c2e5..795f120 100644
--- a/apps/web/src/app/docs/executors/unsandbox/page.tsx
+++ b/apps/web/src/app/docs/executors/unsandbox/page.tsx
@@ -397,11 +397,11 @@ export default function UnsandboxExecutorPage(): React.ReactElement {
{/* Navigation */}
Back to Executors
+ Railway Guide