Add Railway deployment configuration for full Docker-in-Docker support

DEPLOY_RAILWAY.md

@@ -0,0 +1,172 @@
+# 🚀 Deploy to Railway (Full Docker Support)
+
+## Prerequisites
+
+- Railway account (sign up at https://railway.app)
+- GitHub repository connected (already done - your code is on GitHub/HF)
+
+## Option 1: Deploy via Railway CLI (Recommended)
+
+### Install Railway CLI
+
+```powershell
+# Install via npm
+npm install -g @railway/cli
+
+# Or download from https://railway.app/cli
+```
+
+### Deploy Steps
+
+```powershell
+# 1. Login to Railway
+railway login
+
+# 2. Initialize project
+railway init
+
+# 3. Link to your project (create new or select existing)
+railway link
+
+# 4. Set environment variables (optional)
+railway variables set MAX_EXECUTION_TIME=30
+railway variables set MAX_MEMORY_MB=512
+railway variables set ENABLE_NETWORK=true
+
+# 5. Deploy!
+railway up
+
+# 6. Get your deployment URL
+railway domain
+```
+
+## Option 2: Deploy via Railway Dashboard
+
+1. **Go to Railway**: https://railway.app/new
+
+2. **Deploy from GitHub**:
+   - Click "Deploy from GitHub repo"
+   - Authorize Railway to access your repositories
+   - Select your repository
+
+3. **Configure Service**:
+   - Railway will auto-detect the Dockerfile
+   - Set environment variables:
+     - `NIXPACKS_DOCKERFILE` = `Dockerfile.railway`
+     - `MAX_EXECUTION_TIME` = `30`
+     - `MAX_MEMORY_MB` = `512`
+     - `ENABLE_NETWORK` = `true`
+
+4. **Deploy**:
+   - Click "Deploy Now"
+   - Wait 5-10 minutes for build
+   - Get your URL from the "Deployments" tab
+
+## Option 3: Deploy to Render.com
+
+### Prerequisites
+- Render account (https://render.com)
+
+### Steps
+
+1. **Create New Web Service**:
+   - Go to https://dashboard.render.com
+   - Click "New +" → "Web Service"
+   - Connect your GitHub repository
+
+2. **Configure**:
+   - **Name**: `isolated-sandbox`
+   - **Environment**: `Docker`
+   - **Region**: Select closest to you
+   - **Branch**: `master`
+   - **Dockerfile Path**: `Dockerfile.railway` (or leave default)
+   
+3. **Plan**:
+   - Free tier: Limited resources
+   - Starter ($7/mo): Recommended for production
+
+4. **Environment Variables**:
+   ```
+   MAX_EXECUTION_TIME=30
+   MAX_MEMORY_MB=512
+   ENABLE_NETWORK=true
+   ```
+
+5. **Create Web Service**:
+   - Click "Create Web Service"
+   - Wait for deployment
+
+## Verify Deployment
+
+Once deployed, test your API:
+
+```powershell
+# Replace with your Railway/Render URL
+$API_URL = "https://your-app.railway.app"
+
+# Test health
+Invoke-RestMethod "$API_URL/health"
+
+# Test stateless execution
+Invoke-RestMethod "$API_URL/execute" -Method POST -Body (@{
+    code = "print('Hello from Railway!')"
+    language = "python"
+} | ConvertTo-Json) -ContentType "application/json"
+
+# Test session creation
+$session = Invoke-RestMethod "$API_URL/sessions" -Method POST -Body (@{
+    metadata = @{user = "test"}
+    timeout_minutes = 30
+} | ConvertTo-Json) -ContentType "application/json"
+
+Write-Host "Session created: $($session.session_id)"
+```
+
+## Expected Results
+
+✅ **All features should work**:
+- Session management
+- File upload/download
+- Persistent state
+- Multi-language execution
+- Docker-in-Docker
+
+## Troubleshooting
+
+### Build fails
+- Check that `Dockerfile.railway` exists
+- Verify all files pushed to repository
+- Check Railway build logs
+
+### Container starts but sessions fail
+- Railway needs Docker-in-Docker capability
+- Ensure using `docker:dind` base image
+- Check container has sufficient resources (2GB+ RAM)
+
+### Port issues
+- Ensure app listens on `0.0.0.0:7860`
+- Railway automatically assigns `PORT` variable (we use 7860)
+
+## Cost Estimates
+
+**Railway**:
+- Hobby plan: $5/month + usage
+- ~$10-20/month for moderate use
+- Includes 512GB transfer
+
+**Render**:
+- Free tier: Limited (may sleep)
+- Starter: $7/month (recommended)
+- Professional: $25/month
+
+## Next Steps
+
+After deployment:
+1. Run verification script: `python verify_enhanced_features.py` (pointing to your Railway URL)
+2. Build devenv image on first session creation (~15 min)
+3. Test all features
+4. Update documentation with your production URL
+
+---
+
+**Need help?** Check Railway docs: https://docs.railway.app/

Dockerfile.railway

@@ -0,0 +1,35 @@
+# Railway Dockerfile - Full Docker-in-Docker Support
+# This enables ALL features: sessions, file operations, multi-language execution
+
+FROM docker:24-dind
+
+# Install Python 3.11 and dependencies
+RUN apk add --no-cache \
+    python3 \
+    py3-pip \
+    python3-dev \
+    gcc \
+    musl-dev \
+    linux-headers
+
+# Create app directory
+WORKDIR /app
+
+# Copy requirements and install
+COPY requirements.txt .
+RUN pip3 install --no-cache-dir -r requirements.txt --break-system-packages
+
+# Copy application
+COPY . .
+
+# Expose port
+EXPOSE 7860
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 \
+    CMD wget -q --spider http://localhost:7860/health || exit 1
+
+# Start Docker daemon in background and run app
+CMD dockerd-entrypoint.sh & \
+    sleep 5 && \
+    python3 app.py

railway.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://railway.app/railway.schema.json",
+  "build": {
+    "builder": "DOCKERFILE",
+    "dockerfilePath": "Dockerfile.railway"
+  },
+  "deploy": {
+    "numReplicas": 1,
+    "restartPolicyType": "ON_FAILURE",
+    "restartPolicyMaxRetries": 10
+  }
+}