☁️ Using the Cloud (SaaS)

The fastest way to start — no setup required.

1. Create a free account at casc8.io/signup
2. Click New Workflow on the dashboard
3. Drag a Schedule Trigger or Webhook Trigger onto the canvas
4. Add nodes — HTTP Request, AI, Code — and connect them
5. Set the workflow to Active and it will run automatically

🐳 Self-Hosting

One command to run Casc8 on your own server.

Prerequisites

• Docker & Docker Compose (v2+)
• Linux/macOS server with port 3000 accessible

1. Create docker-compose.yml

services:
  casc8:
    image: ghcr.io/casc8/casc8:latest
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - casc8_data:/data
    environment:
      - NODE_ENV=production
      - SESSION_SECRET=your_random_32_char_secret_here
      - SELF_HOSTED=true
      # Optional SMTP for email notifications:
      # - SMTP_HOST=smtp.resend.com
      # - SMTP_PORT=465
      # - SMTP_USER=resend
      # - SMTP_PASS=re_xxxx
      # - SMTP_FROM=Casc8 <noreply@yourdomain.com>

volumes:
  casc8_data:

2. Start the container

docker compose up -d

3. Open the app

Navigate to http://your-server-ip:3000 and create your admin account on first run.

Updating

docker compose pull && docker compose up -d

# HTTP body field
{"email": "{{input.body.user_email}}", "plan": "{{vars.selectedPlan}}"}

# Authorization header using a secret
Bearer {{$secret.STRIPE_SECRET_KEY}}

# Template node message
Hello {{input.name}}! Your order {{input.orderId}} has shipped.

# Reference a node output by UUID (copy from config panel)
{{nodes.a1b2c3d4-0000-0000-0000-000000000000.content}}

body.user.email              → nested field
body.items[0].name           → first item in array
body.items.0.name            → same, dot notation
body.metadata.tags.1         → second element of tags

# HTTP node — Authorization header
Bearer {{$secret.OPENAI_API_KEY}}

# Slack webhook URL field
https://hooks.slack.com/services/{{$secret.SLACK_WEBHOOK}}

# HTTP body — mix secrets and dynamic data
{"api_key": "{{$secret.STRIPE_KEY}}", "customer": "{{input.customerId}}"}

const users = input.body.data;
return users.map(u => ({
  id: u.id,
  name: u.first_name + ' ' + u.last_name,
  email: u.email.toLowerCase(),
  isAdmin: u.role === 'admin',
}));

const active = input.filter(u => u.status === 'active' && u.plan === 'premium');
console.log('Found ' + active.length + ' qualifying users');
return { users: active, count: active.length };

const expiresAt = new Date(input.subscription.expires_at);
const daysLeft = Math.ceil((expiresAt - new Date()) / 86400000);
return { ...input, daysLeft, isExpiringSoon: daysLeft <= 7 && daysLeft >= 0 };

const score = input.riskScore ?? 0;
return {
  ...input,
  verdict: score > 80 ? 'block' : score > 50 ? 'review' : 'allow',
};
// Downstream Condition: input.verdict === 'block'

const ok = input.status === 'success';
return {
  text: (ok ? '✅' : '❌') + ' Deployment ' + input.service + ' ' + input.status,
  username: 'Casc8 Bot',
  icon_emoji: ':rocket:',
  color: ok ? '#10b981' : '#ef4444',
};

// Hover a node on canvas → config panel header shows the UUID
const httpOut = nodes['abc12345-dead-beef-cafe-000000000000'];
const aiOut   = nodes['def67890-1234-5678-abcd-000000000001'];
return {
  httpData: httpOut?.body?.data,
  aiContent: aiOut?.content,
};

// Set Variable node earlier: variable_name=userPlan, value={{input.plan}}
const plan  = vars.userPlan;            // 'free' | 'pro' | 'team'
const limit = plan === 'pro' ? 10000 : 100;
return { ...input, limit, planName: plan };

// Note: fetch is available. Use this only when the HTTP node config isn't flexible enough.
if (!input.email) return { skipped: true };

const res = await fetch('https://api.example.com/notify', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ to: input.email, message: 'Hello!' }),
});
const data = await res.json();
return { notified: res.ok, response: data };

Execute a Workflow

Manually triggers a workflow and waits for completion. Returns the execution result.

Path parameters

Request body

Optional. Any JSON object — passed as input to the trigger node.

curl -X POST https://casc8.io/api/workflows/wf_abc123/execute \
  -H "Content-Type: application/json" \
  -H "Cookie: casc8_session=<your_session>" \
  -d '{"userId": "123", "action": "send_report"}'

Response

{
  "executionId": "exec_xyz789",
  "status": "success",
  "output": { "emailSent": true },
  "durationMs": 1240
}

Error — quota exceeded

HTTP 402
{
  "error": "Monthly execution limit reached (100/100). Upgrade your plan.",
  "quota": { "used": 100, "limit": 100, "plan": "free" }
}

Webhook Trigger

Fires a workflow from any external service — no authentication required. The full request (method, headers, query, body) is passed as the trigger input.

# POST with JSON body
curl -X POST https://casc8.io/api/workflows/wf_abc123/webhook \
  -H "Content-Type: application/json" \
  -d '{"event": "payment.success", "amount": 49.99}'

# GET with query parameters
curl "https://casc8.io/api/workflows/wf_abc123/webhook?user=456&action=sync"

Trigger input shape

{
  "method": "POST",
  "path": "/api/workflows/wf_abc123/webhook",
  "query": { "user": "456" },
  "headers": { "content-type": "application/json" },
  "body": { "event": "payment.success" },
  "timestamp": "2026-04-19T12:00:00.000Z"
}

Response

{
  "executionId": "exec_xyz789",
  "status": "success",
  "output": null,
  "durationMs": 340
}

If the workflow contains a Response node, its value becomes the HTTP response body.

Execution History

Returns the last 50 executions for a workflow, newest first.

curl https://casc8.io/api/workflows/wf_abc123/execute \
  -H "Cookie: casc8_session=<your_session>"

[
  {
    "id": "exec_xyz789",
    "workflow_id": "wf_abc123",
    "status": "success",
    "trigger_type": "webhook",
    "started_at": "2026-04-19T12:00:00.000Z",
    "duration_ms": 340,
    "output": { "emailSent": true },
    "error": null
  },
  ...
]

# Manual backup
docker cp casc8:/data/casc8.db ./casc8-backup-$(date +%Y%m%d).db

# Cron backup (daily at 2 AM)
0 2 * * * docker cp casc8:/data/casc8.db /backups/casc8-$(date +\%Y\%m\%d).db

yourdomain.com {
    reverse_proxy localhost:3000
    encode gzip
}

docker compose pull && docker compose up -d --force-recreate

curl http://localhost:3000/api/config
# Returns: {"selfHosted":true,"googleAuth":false,"appleAuth":false}