Add Webdock provider

manifest.json

@@ -795,6 +795,21 @@
  "region": "zrh"
  },
  "notes": "API-centric cloud platform with regions in ZRH (Zurich), WDC (Washington DC), and LVS (Las Vegas). Granular resource control (CPU/RAM/Disk independently configurable). Uses 'cloudsigma' user for SSH."
+ },
+ "webdock": {
+ "name": "Webdock",
+ "description": "European VPS provider with affordable plans",
+ "url": "https://webdock.io/",
+ "type": "api",
+ "auth": "WEBDOCK_API_TOKEN",
+ "provision_method": "POST /v1/servers",
+ "exec_method": "ssh root@IP",
+ "interactive_method": "ssh -t root@IP",
+ "defaults": {
+ "profile": "webdockmicro",
+ "location": "fi",
+ "image": "ubuntu2404"
+ }
  }
  },
  "matrix": {
@@ -1337,6 +1352,21 @@
  "cloudsigma/opencode": "missing",
  "cloudsigma/plandex": "missing",
  "cloudsigma/kilocode": "missing",
- "cloudsigma/continue": "implemented"
+ "cloudsigma/continue": "implemented",
+ "webdock/claude": "implemented",
+ "webdock/openclaw": "missing",
+ "webdock/nanoclaw": "missing",
+ "webdock/aider": "implemented",
+ "webdock/goose": "missing",
+ "webdock/codex": "missing",
+ "webdock/interpreter": "missing",
+ "webdock/gemini": "missing",
+ "webdock/amazonq": "missing",
+ "webdock/cline": "implemented",
+ "webdock/gptme": "missing",
+ "webdock/opencode": "missing",
+ "webdock/plandex": "missing",
+ "webdock/kilocode": "missing",
+ "webdock/continue": "missing"
  }
-}
+}

test/mock.sh

@@ -263,6 +263,7 @@ _strip_api_base() {
  https://cloudapi.atlantic.net/*) ENDPOINT=$(echo "$URL" | sed 's|https://cloudapi.atlantic.net/\?||') ;;
  https://invapi.hostkey.com*) ENDPOINT="${URL#https://invapi.hostkey.com}" ;;
  https://*.cloudsigma.com/api/2.0*) ENDPOINT=$(echo "$URL" | sed 's|https://[^/]*.cloudsigma.com/api/2.0||') ;;
+ https://api.webdock.io/v1*) ENDPOINT="${URL#https://api.webdock.io/v1}" ;;
  esac
  EP_CLEAN=$(echo "$ENDPOINT" | sed 's|?.*||')
 }
@@ -288,6 +289,7 @@ _validate_body() {
  vultr) case "$EP_CLEAN" in /instances) _check_fields "label region plan os_id" ;; esac ;;
  linode) case "$EP_CLEAN" in /linode/instances) _check_fields "label region type image" ;; esac ;;
  civo) case "$EP_CLEAN" in /instances) _check_fields "hostname size region" ;; esac ;;
+ webdock) case "$EP_CLEAN" in /servers) _check_fields "name slug locationId profileSlug imageSlug" ;; esac ;;
  esac
 }
 

test/record.sh

@@ -31,7 +31,7 @@ ERRORS=0
 PROMPT_FOR_CREDS=true
 
 # All clouds with REST APIs that we can record from
-ALL_RECORDABLE_CLOUDS="hetzner digitalocean vultr linode lambda civo upcloud binarylane ovh scaleway genesiscloud kamatera latitude hyperstack atlanticnet hostkey cloudsigma"
+ALL_RECORDABLE_CLOUDS="hetzner digitalocean vultr linode lambda civo upcloud binarylane ovh scaleway genesiscloud kamatera latitude hyperstack atlanticnet hostkey cloudsigma webdock"
 
 # --- Endpoint registry ---
 # Format: "fixture_name:endpoint"
@@ -141,6 +141,14 @@ get_endpoints() {
  "keypairs:/keypairs/" \
  "servers:/servers/"
  ;;
+ webdock)
+ printf '%s\n' \
+ "account:/account" \
+ "publicKeys:/account/publicKeys" \
+ "servers:/servers" \
+ "profiles:/profiles" \
+ "locations:/locations"
+ ;;
  esac
 }
 
@@ -165,6 +173,7 @@ get_auth_env_var() {
  atlanticnet) printf "ATLANTICNET_API_KEY" ;;
  hostkey) printf "HOSTKEY_API_KEY" ;;
  cloudsigma) printf "CLOUDSIGMA_EMAIL" ;;
+ webdock) printf "WEBDOCK_API_TOKEN" ;;
  esac
 }
 
@@ -399,6 +408,7 @@ call_api() {
  atlanticnet) atlanticnet_api "$endpoint" ;;
  hostkey) hostkey_api "$endpoint" ;;
  cloudsigma) cloudsigma_api GET "$endpoint" ;;
+ webdock) webdock_api GET "$endpoint" ;;
  esac
 }
 
@@ -444,6 +454,9 @@ elif cloud == 'hostkey':
 elif cloud == 'cloudsigma':
  # CloudSigma returns error objects with 'error_message', 'error_type', etc
  sys.exit(0 if 'error_message' in d or 'error_type' in d else 1)
+elif cloud == 'webdock':
+ # Webdock returns error objects with 'message' field
+ sys.exit(0 if 'message' in d and len(d) <= 3 and not any(k in d for k in ('slug','name','status','ipv4')) else 1)
 else:
  sys.exit(1)
 " "$cloud" 2>/dev/null
@@ -822,6 +835,12 @@ _live_cloudsigma() {
  return 0
 }
 
+_live_webdock() {
+ local fixture_dir="$1"
+ printf '%b\n' " ${YELLOW}skip${NC} Webdock live test (not implemented yet)" >&2
+ return 0
+}
+
 # --- Record one cloud ---
 # Check credentials and prompt if needed; returns 1 to skip this cloud
 _record_ensure_credentials() {

webdock/README.md

@@ -0,0 +1,134 @@
+# Webdock
+
+Webdock is a European VPS provider offering affordable cloud servers with API access.
+
+## Features
+
+- **REST API**: Full-featured API for server management
+- **Affordable pricing**: Starting from €2.15/month (Intel Xeon) or €4.30/month (AMD EPYC)
+- **Multiple locations**: Data centers in Europe (Finland, Netherlands, UK)
+- **Developer-friendly**: Free API, automated backups, free SSL, 1-click deployments
+- **SSH access**: Full root SSH access to all servers
+- **GDPR compliant**: European data protection standards
+
+## Authentication
+
+Set your Webdock API token as an environment variable:
+
+```bash
+export WEBDOCK_API_TOKEN="your-api-token-here"
+```
+
+To obtain an API token:
+1. Log in to [https://my.webdock.io](https://my.webdock.io)
+2. Go to Account Area > API & Integrations
+3. Generate a new API key
+
+The token will be automatically saved to `~/.config/spawn/webdock.json` for future use.
+
+## Usage
+
+Launch Claude Code on a Webdock server:
+
+```bash
+bash webdock/claude.sh
+```
+
+Or use the CLI:
+
+```bash
+spawn run webdock claude
+```
+
+## Available Scripts
+
+- `claude.sh` — Claude Code (Anthropic's CLI coding agent)
+- `cline.sh` — Cline (AI pair programming in your editor)
+- `aider.sh` — Aider (AI pair programming in the terminal)
+
+## Configuration
+
+### Server Profile
+
+Set the server profile (hardware tier) via environment variable:
+
+```bash
+export WEBDOCK_PROFILE="webdockmicro" # Default
+```
+
+Available profiles:
+- `webdockmicro` — 1 vCPU, 1GB RAM, 25GB SSD (€2.15-4.30/mo)
+- `webdocksmall` — 1 vCPU, 2GB RAM, 50GB SSD
+- `webdockmedium` — 2 vCPU, 4GB RAM, 80GB SSD
+- `webdocklarge` — 4 vCPU, 8GB RAM, 160GB SSD
+- `webdockxl` — 6 vCPU, 16GB RAM, 320GB SSD
+
+Check [Webdock pricing](https://webdock.io/en/pricing) for the full list and current prices.
+
+### Location
+
+Set the server location via environment variable:
+
+```bash
+export WEBDOCK_LOCATION="fi" # Default (Finland)
+```
+
+Available locations:
+- `fi` — Finland (Helsinki)
+- `nl` — Netherlands (Amsterdam)
+- `uk` — United Kingdom (London)
+
+### Image
+
+Set the OS image via environment variable:
+
+```bash
+export WEBDOCK_IMAGE="ubuntu2404" # Default
+```
+
+Available images include Ubuntu, Debian, and various pre-configured stacks (LEMP, WordPress, etc.).
+Check the Webdock control panel for the full list of available images.
+
+### Server Name
+
+Set a custom server name:
+
+```bash
+export WEBDOCK_SERVER_NAME="my-ai-server"
+```
+
+If not set, you'll be prompted to enter one.
+
+## How It Works
+
+1. **Authenticate**: Validates your API token with Webdock
+2. **SSH Key**: Ensures your SSH key is registered (generates ed25519 key if needed)
+3. **Provision**: Creates a new server with the specified profile, location, and image
+4. **Wait**: Polls until the server is online and SSH-ready
+5. **Setup**: Installs the agent and configures OpenRouter API credentials
+6. **Launch**: Drops you into an interactive session with the agent
+
+## Cleanup
+
+Servers persist after the script exits. To destroy a server:
+
+```bash
+# Using the Webdock API
+curl -X DELETE "https://api.webdock.io/v1/servers/SERVER_SLUG" \
+ -H "Authorization: Bearer $WEBDOCK_API_TOKEN"
+```
+
+Or delete from the Webdock control panel: https://my.webdock.io/servers
+
+## Limitations
+
+- Webdock is primarily European-focused (data centers in EU only)
+- Profile availability may vary by location
+- Server creation can take 1-3 minutes depending on load
+
+## Links
+
+- Website: https://webdock.io
+- API Documentation: https://api.webdock.io/v1
+- Control Panel: https://my.webdock.io
+- Pricing: https://webdock.io/en/pricing

webdock/aider.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+# shellcheck source=webdock/lib/common.sh
+if [[ -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+ source "${SCRIPT_DIR}/lib/common.sh"
+else
+ eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/webdock/lib/common.sh)"
+fi
+
+log_info "Aider on Webdock"
+echo ""
+
+ensure_webdock_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "${SERVER_NAME}"
+verify_server_connectivity "${WEBDOCK_SERVER_IP}"
+wait_for_cloud_init "${WEBDOCK_SERVER_IP}" 60
+
+log_step "Installing Aider..."
+run_server "${WEBDOCK_SERVER_IP}" "pip install aider-chat 2>/dev/null || pip3 install aider-chat"
+log_info "Aider installed"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+MODEL_ID=$(get_model_id_interactive "openrouter/auto" "Aider") || exit 1
+
+log_step "Setting up environment variables..."
+inject_env_vars_ssh "${WEBDOCK_SERVER_IP}" upload_file run_server \
+ "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}"
+
+echo ""
+log_info "Webdock server setup completed successfully!"
+log_info "Server: ${SERVER_NAME} (slug: ${WEBDOCK_SERVER_SLUG}, IP: ${WEBDOCK_SERVER_IP})"
+echo ""
+
+log_step "Starting Aider..."
+sleep 1
+clear
+interactive_session "${WEBDOCK_SERVER_IP}" "source ~/.zshrc && aider --model openrouter/${MODEL_ID}"

webdock/claude.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+# shellcheck source=webdock/lib/common.sh
+if [[ -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+ source "${SCRIPT_DIR}/lib/common.sh"
+else
+ eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/webdock/lib/common.sh)"
+fi
+
+log_info "Claude Code on Webdock"
+echo ""
+
+ensure_webdock_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "${SERVER_NAME}"
+verify_server_connectivity "${WEBDOCK_SERVER_IP}"
+wait_for_cloud_init "${WEBDOCK_SERVER_IP}" 60
+
+log_step "Verifying Claude Code installation..."
+if ! run_server "${WEBDOCK_SERVER_IP}" "export PATH=\$HOME/.local/bin:\$PATH && command -v claude" >/dev/null 2>&1; then
+ log_step "Claude Code not found, installing manually..."
+ run_server "${WEBDOCK_SERVER_IP}" "curl -fsSL https://claude.ai/install.sh | bash"
+fi
+log_info "Claude Code is installed"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+log_step "Setting up environment variables..."
+inject_env_vars_ssh "${WEBDOCK_SERVER_IP}" upload_file run_server \
+ "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}" \
+ "ANTHROPIC_BASE_URL=https://openrouter.ai/api" \
+ "ANTHROPIC_AUTH_TOKEN=${OPENROUTER_API_KEY}" \
+ "ANTHROPIC_API_KEY=" \
+ "CLAUDE_CODE_SKIP_ONBOARDING=1" \
+ "CLAUDE_CODE_ENABLE_TELEMETRY=0"
+
+setup_claude_code_config "${OPENROUTER_API_KEY}" \
+ "upload_file ${WEBDOCK_SERVER_IP}" \
+ "run_server ${WEBDOCK_SERVER_IP}"
+
+echo ""
+log_info "Webdock server setup completed successfully!"
+log_info "Server: ${SERVER_NAME} (slug: ${WEBDOCK_SERVER_SLUG}, IP: ${WEBDOCK_SERVER_IP})"
+echo ""
+
+log_step "Starting Claude Code..."
+sleep 1
+clear
+interactive_session "${WEBDOCK_SERVER_IP}" "export PATH=\$HOME/.local/bin:\$PATH && source ~/.zshrc && claude"

manifest.json

@@ -795,6 +795,21 @@
  "region": "zrh"
  },
  "notes": "API-centric cloud platform with regions in ZRH (Zurich), WDC (Washington DC), and LVS (Las Vegas). Granular resource control (CPU/RAM/Disk independently configurable). Uses 'cloudsigma' user for SSH."
+ },
+ "webdock": {
+ "name": "Webdock",
+ "description": "European VPS provider with affordable plans",
+ "url": "https://webdock.io/",
+ "type": "api",
+ "auth": "WEBDOCK_API_TOKEN",
+ "provision_method": "POST /v1/servers",
+ "exec_method": "ssh root@IP",
+ "interactive_method": "ssh -t root@IP",
+ "defaults": {
+ "profile": "webdockmicro",
+ "location": "fi",
+ "image": "ubuntu2404"
+ }
  }
  },
  "matrix": {
@@ -1337,6 +1352,21 @@
  "cloudsigma/opencode": "missing",
  "cloudsigma/plandex": "missing",
  "cloudsigma/kilocode": "missing",
- "cloudsigma/continue": "implemented"
+ "cloudsigma/continue": "implemented",
+ "webdock/claude": "implemented",
+ "webdock/openclaw": "missing",
+ "webdock/nanoclaw": "missing",
+ "webdock/aider": "implemented",
+ "webdock/goose": "missing",
+ "webdock/codex": "missing",
+ "webdock/interpreter": "missing",
+ "webdock/gemini": "missing",
+ "webdock/amazonq": "missing",
+ "webdock/cline": "implemented",
+ "webdock/gptme": "missing",
+ "webdock/opencode": "missing",
+ "webdock/plandex": "missing",
+ "webdock/kilocode": "missing",
+ "webdock/continue": "missing"
  }
-}
+}

test/mock.sh

@@ -263,6 +263,7 @@ _strip_api_base() {
  https://cloudapi.atlantic.net/*) ENDPOINT=$(echo "$URL" | sed 's|https://cloudapi.atlantic.net/\?||') ;;
  https://invapi.hostkey.com*) ENDPOINT="${URL#https://invapi.hostkey.com}" ;;
  https://*.cloudsigma.com/api/2.0*) ENDPOINT=$(echo "$URL" | sed 's|https://[^/]*.cloudsigma.com/api/2.0||') ;;
+ https://api.webdock.io/v1*) ENDPOINT="${URL#https://api.webdock.io/v1}" ;;
  esac
  EP_CLEAN=$(echo "$ENDPOINT" | sed 's|?.*||')
 }
@@ -288,6 +289,7 @@ _validate_body() {
  vultr) case "$EP_CLEAN" in /instances) _check_fields "label region plan os_id" ;; esac ;;
  linode) case "$EP_CLEAN" in /linode/instances) _check_fields "label region type image" ;; esac ;;
  civo) case "$EP_CLEAN" in /instances) _check_fields "hostname size region" ;; esac ;;
+ webdock) case "$EP_CLEAN" in /servers) _check_fields "name slug locationId profileSlug imageSlug" ;; esac ;;
  esac
 }
 

test/record.sh

@@ -31,7 +31,7 @@ ERRORS=0
 PROMPT_FOR_CREDS=true
 
 # All clouds with REST APIs that we can record from
-ALL_RECORDABLE_CLOUDS="hetzner digitalocean vultr linode lambda civo upcloud binarylane ovh scaleway genesiscloud kamatera latitude hyperstack atlanticnet hostkey cloudsigma"
+ALL_RECORDABLE_CLOUDS="hetzner digitalocean vultr linode lambda civo upcloud binarylane ovh scaleway genesiscloud kamatera latitude hyperstack atlanticnet hostkey cloudsigma webdock"
 
 # --- Endpoint registry ---
 # Format: "fixture_name:endpoint"
@@ -141,6 +141,14 @@ get_endpoints() {
  "keypairs:/keypairs/" \
  "servers:/servers/"
  ;;
+ webdock)
+ printf '%s\n' \
+ "account:/account" \
+ "publicKeys:/account/publicKeys" \
+ "servers:/servers" \
+ "profiles:/profiles" \
+ "locations:/locations"
+ ;;
  esac
 }
 
@@ -165,6 +173,7 @@ get_auth_env_var() {
  atlanticnet) printf "ATLANTICNET_API_KEY" ;;
  hostkey) printf "HOSTKEY_API_KEY" ;;
  cloudsigma) printf "CLOUDSIGMA_EMAIL" ;;
+ webdock) printf "WEBDOCK_API_TOKEN" ;;
  esac
 }
 
@@ -399,6 +408,7 @@ call_api() {
  atlanticnet) atlanticnet_api "$endpoint" ;;
  hostkey) hostkey_api "$endpoint" ;;
  cloudsigma) cloudsigma_api GET "$endpoint" ;;
+ webdock) webdock_api GET "$endpoint" ;;
  esac
 }
 
@@ -444,6 +454,9 @@ elif cloud == 'hostkey':
 elif cloud == 'cloudsigma':
  # CloudSigma returns error objects with 'error_message', 'error_type', etc
  sys.exit(0 if 'error_message' in d or 'error_type' in d else 1)
+elif cloud == 'webdock':
+ # Webdock returns error objects with 'message' field
+ sys.exit(0 if 'message' in d and len(d) <= 3 and not any(k in d for k in ('slug','name','status','ipv4')) else 1)
 else:
  sys.exit(1)
 " "$cloud" 2>/dev/null
@@ -822,6 +835,12 @@ _live_cloudsigma() {
  return 0
 }
 
+_live_webdock() {
+ local fixture_dir="$1"
+ printf '%b\n' " ${YELLOW}skip${NC} Webdock live test (not implemented yet)" >&2
+ return 0
+}
+
 # --- Record one cloud ---
 # Check credentials and prompt if needed; returns 1 to skip this cloud
 _record_ensure_credentials() {

webdock/README.md

@@ -0,0 +1,134 @@
+# Webdock
+
+Webdock is a European VPS provider offering affordable cloud servers with API access.
+
+## Features
+
+- **REST API**: Full-featured API for server management
+- **Affordable pricing**: Starting from €2.15/month (Intel Xeon) or €4.30/month (AMD EPYC)
+- **Multiple locations**: Data centers in Europe (Finland, Netherlands, UK)
+- **Developer-friendly**: Free API, automated backups, free SSL, 1-click deployments
+- **SSH access**: Full root SSH access to all servers
+- **GDPR compliant**: European data protection standards
+
+## Authentication
+
+Set your Webdock API token as an environment variable:
+
+```bash
+export WEBDOCK_API_TOKEN="your-api-token-here"
+```
+
+To obtain an API token:
+1. Log in to [https://my.webdock.io](https://my.webdock.io)
+2. Go to Account Area > API & Integrations
+3. Generate a new API key
+
+The token will be automatically saved to `~/.config/spawn/webdock.json` for future use.
+
+## Usage
+
+Launch Claude Code on a Webdock server:
+
+```bash
+bash webdock/claude.sh
+```
+
+Or use the CLI:
+
+```bash
+spawn run webdock claude
+```
+
+## Available Scripts
+
+- `claude.sh` — Claude Code (Anthropic's CLI coding agent)
+- `cline.sh` — Cline (AI pair programming in your editor)
+- `aider.sh` — Aider (AI pair programming in the terminal)
+
+## Configuration
+
+### Server Profile
+
+Set the server profile (hardware tier) via environment variable:
+
+```bash
+export WEBDOCK_PROFILE="webdockmicro" # Default
+```
+
+Available profiles:
+- `webdockmicro` — 1 vCPU, 1GB RAM, 25GB SSD (€2.15-4.30/mo)
+- `webdocksmall` — 1 vCPU, 2GB RAM, 50GB SSD
+- `webdockmedium` — 2 vCPU, 4GB RAM, 80GB SSD
+- `webdocklarge` — 4 vCPU, 8GB RAM, 160GB SSD
+- `webdockxl` — 6 vCPU, 16GB RAM, 320GB SSD
+
+Check [Webdock pricing](https://webdock.io/en/pricing) for the full list and current prices.
+
+### Location
+
+Set the server location via environment variable:
+
+```bash
+export WEBDOCK_LOCATION="fi" # Default (Finland)
+```
+
+Available locations:
+- `fi` — Finland (Helsinki)
+- `nl` — Netherlands (Amsterdam)
+- `uk` — United Kingdom (London)
+
+### Image
+
+Set the OS image via environment variable:
+
+```bash
+export WEBDOCK_IMAGE="ubuntu2404" # Default
+```
+
+Available images include Ubuntu, Debian, and various pre-configured stacks (LEMP, WordPress, etc.).
+Check the Webdock control panel for the full list of available images.
+
+### Server Name
+
+Set a custom server name:
+
+```bash
+export WEBDOCK_SERVER_NAME="my-ai-server"
+```
+
+If not set, you'll be prompted to enter one.
+
+## How It Works
+
+1. **Authenticate**: Validates your API token with Webdock
+2. **SSH Key**: Ensures your SSH key is registered (generates ed25519 key if needed)
+3. **Provision**: Creates a new server with the specified profile, location, and image
+4. **Wait**: Polls until the server is online and SSH-ready
+5. **Setup**: Installs the agent and configures OpenRouter API credentials
+6. **Launch**: Drops you into an interactive session with the agent
+
+## Cleanup
+
+Servers persist after the script exits. To destroy a server:
+
+```bash
+# Using the Webdock API
+curl -X DELETE "https://api.webdock.io/v1/servers/SERVER_SLUG" \
+ -H "Authorization: Bearer $WEBDOCK_API_TOKEN"
+```
+
+Or delete from the Webdock control panel: https://my.webdock.io/servers
+
+## Limitations
+
+- Webdock is primarily European-focused (data centers in EU only)
+- Profile availability may vary by location
+- Server creation can take 1-3 minutes depending on load
+
+## Links
+
+- Website: https://webdock.io
+- API Documentation: https://api.webdock.io/v1
+- Control Panel: https://my.webdock.io
+- Pricing: https://webdock.io/en/pricing

webdock/aider.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+# shellcheck source=webdock/lib/common.sh
+if [[ -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+ source "${SCRIPT_DIR}/lib/common.sh"
+else
+ eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/webdock/lib/common.sh)"
+fi
+
+log_info "Aider on Webdock"
+echo ""
+
+ensure_webdock_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "${SERVER_NAME}"
+verify_server_connectivity "${WEBDOCK_SERVER_IP}"
+wait_for_cloud_init "${WEBDOCK_SERVER_IP}" 60
+
+log_step "Installing Aider..."
+run_server "${WEBDOCK_SERVER_IP}" "pip install aider-chat 2>/dev/null || pip3 install aider-chat"
+log_info "Aider installed"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+MODEL_ID=$(get_model_id_interactive "openrouter/auto" "Aider") || exit 1
+
+log_step "Setting up environment variables..."
+inject_env_vars_ssh "${WEBDOCK_SERVER_IP}" upload_file run_server \
+ "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}"
+
+echo ""
+log_info "Webdock server setup completed successfully!"
+log_info "Server: ${SERVER_NAME} (slug: ${WEBDOCK_SERVER_SLUG}, IP: ${WEBDOCK_SERVER_IP})"
+echo ""
+
+log_step "Starting Aider..."
+sleep 1
+clear
+interactive_session "${WEBDOCK_SERVER_IP}" "source ~/.zshrc && aider --model openrouter/${MODEL_ID}"

webdock/claude.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+# shellcheck source=webdock/lib/common.sh
+if [[ -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+ source "${SCRIPT_DIR}/lib/common.sh"
+else
+ eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/webdock/lib/common.sh)"
+fi
+
+log_info "Claude Code on Webdock"
+echo ""
+
+ensure_webdock_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "${SERVER_NAME}"
+verify_server_connectivity "${WEBDOCK_SERVER_IP}"
+wait_for_cloud_init "${WEBDOCK_SERVER_IP}" 60
+
+log_step "Verifying Claude Code installation..."
+if ! run_server "${WEBDOCK_SERVER_IP}" "export PATH=\$HOME/.local/bin:\$PATH && command -v claude" >/dev/null 2>&1; then
+ log_step "Claude Code not found, installing manually..."
+ run_server "${WEBDOCK_SERVER_IP}" "curl -fsSL https://claude.ai/install.sh | bash"
+fi
+log_info "Claude Code is installed"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+log_step "Setting up environment variables..."
+inject_env_vars_ssh "${WEBDOCK_SERVER_IP}" upload_file run_server \
+ "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}" \
+ "ANTHROPIC_BASE_URL=https://openrouter.ai/api" \
+ "ANTHROPIC_AUTH_TOKEN=${OPENROUTER_API_KEY}" \
+ "ANTHROPIC_API_KEY=" \
+ "CLAUDE_CODE_SKIP_ONBOARDING=1" \
+ "CLAUDE_CODE_ENABLE_TELEMETRY=0"
+
+setup_claude_code_config "${OPENROUTER_API_KEY}" \
+ "upload_file ${WEBDOCK_SERVER_IP}" \
+ "run_server ${WEBDOCK_SERVER_IP}"
+
+echo ""
+log_info "Webdock server setup completed successfully!"
+log_info "Server: ${SERVER_NAME} (slug: ${WEBDOCK_SERVER_SLUG}, IP: ${WEBDOCK_SERVER_IP})"
+echo ""
+
+log_step "Starting Claude Code..."
+sleep 1
+clear
+interactive_session "${WEBDOCK_SERVER_IP}" "export PATH=\$HOME/.local/bin:\$PATH && source ~/.zshrc && claude"

manifest.json

@@ -795,6 +795,21 @@
  "region": "zrh"
  },
  "notes": "API-centric cloud platform with regions in ZRH (Zurich), WDC (Washington DC), and LVS (Las Vegas). Granular resource control (CPU/RAM/Disk independently configurable). Uses 'cloudsigma' user for SSH."
+ },
+ "webdock": {
+ "name": "Webdock",
+ "description": "European VPS provider with affordable plans",
+ "url": "https://webdock.io/",
+ "type": "api",
+ "auth": "WEBDOCK_API_TOKEN",
+ "provision_method": "POST /v1/servers",
+ "exec_method": "ssh root@IP",
+ "interactive_method": "ssh -t root@IP",
+ "defaults": {
+ "profile": "webdockmicro",
+ "location": "fi",
+ "image": "ubuntu2404"
+ }
  }
  },
  "matrix": {
@@ -1337,6 +1352,21 @@
  "cloudsigma/opencode": "missing",
  "cloudsigma/plandex": "missing",
  "cloudsigma/kilocode": "missing",
- "cloudsigma/continue": "implemented"
+ "cloudsigma/continue": "implemented",
+ "webdock/claude": "implemented",
+ "webdock/openclaw": "missing",
+ "webdock/nanoclaw": "missing",
+ "webdock/aider": "implemented",
+ "webdock/goose": "missing",
+ "webdock/codex": "missing",
+ "webdock/interpreter": "missing",
+ "webdock/gemini": "missing",
+ "webdock/amazonq": "missing",
+ "webdock/cline": "implemented",
+ "webdock/gptme": "missing",
+ "webdock/opencode": "missing",
+ "webdock/plandex": "missing",
+ "webdock/kilocode": "missing",
+ "webdock/continue": "missing"
  }
-}
+}

test/mock.sh

@@ -263,6 +263,7 @@ _strip_api_base() {
  https://cloudapi.atlantic.net/*) ENDPOINT=$(echo "$URL" | sed 's|https://cloudapi.atlantic.net/\?||') ;;
  https://invapi.hostkey.com*) ENDPOINT="${URL#https://invapi.hostkey.com}" ;;
  https://*.cloudsigma.com/api/2.0*) ENDPOINT=$(echo "$URL" | sed 's|https://[^/]*.cloudsigma.com/api/2.0||') ;;
+ https://api.webdock.io/v1*) ENDPOINT="${URL#https://api.webdock.io/v1}" ;;
  esac
  EP_CLEAN=$(echo "$ENDPOINT" | sed 's|?.*||')
 }
@@ -288,6 +289,7 @@ _validate_body() {
  vultr) case "$EP_CLEAN" in /instances) _check_fields "label region plan os_id" ;; esac ;;
  linode) case "$EP_CLEAN" in /linode/instances) _check_fields "label region type image" ;; esac ;;
  civo) case "$EP_CLEAN" in /instances) _check_fields "hostname size region" ;; esac ;;
+ webdock) case "$EP_CLEAN" in /servers) _check_fields "name slug locationId profileSlug imageSlug" ;; esac ;;
  esac
 }
 

test/record.sh

@@ -31,7 +31,7 @@ ERRORS=0
 PROMPT_FOR_CREDS=true
 
 # All clouds with REST APIs that we can record from
-ALL_RECORDABLE_CLOUDS="hetzner digitalocean vultr linode lambda civo upcloud binarylane ovh scaleway genesiscloud kamatera latitude hyperstack atlanticnet hostkey cloudsigma"
+ALL_RECORDABLE_CLOUDS="hetzner digitalocean vultr linode lambda civo upcloud binarylane ovh scaleway genesiscloud kamatera latitude hyperstack atlanticnet hostkey cloudsigma webdock"
 
 # --- Endpoint registry ---
 # Format: "fixture_name:endpoint"
@@ -141,6 +141,14 @@ get_endpoints() {
  "keypairs:/keypairs/" \
  "servers:/servers/"
  ;;
+ webdock)
+ printf '%s\n' \
+ "account:/account" \
+ "publicKeys:/account/publicKeys" \
+ "servers:/servers" \
+ "profiles:/profiles" \
+ "locations:/locations"
+ ;;
  esac
 }
 
@@ -165,6 +173,7 @@ get_auth_env_var() {
  atlanticnet) printf "ATLANTICNET_API_KEY" ;;
  hostkey) printf "HOSTKEY_API_KEY" ;;
  cloudsigma) printf "CLOUDSIGMA_EMAIL" ;;
+ webdock) printf "WEBDOCK_API_TOKEN" ;;
  esac
 }
 
@@ -399,6 +408,7 @@ call_api() {
  atlanticnet) atlanticnet_api "$endpoint" ;;
  hostkey) hostkey_api "$endpoint" ;;
  cloudsigma) cloudsigma_api GET "$endpoint" ;;
+ webdock) webdock_api GET "$endpoint" ;;
  esac
 }
 
@@ -444,6 +454,9 @@ elif cloud == 'hostkey':
 elif cloud == 'cloudsigma':
  # CloudSigma returns error objects with 'error_message', 'error_type', etc
  sys.exit(0 if 'error_message' in d or 'error_type' in d else 1)
+elif cloud == 'webdock':
+ # Webdock returns error objects with 'message' field
+ sys.exit(0 if 'message' in d and len(d) <= 3 and not any(k in d for k in ('slug','name','status','ipv4')) else 1)
 else:
  sys.exit(1)
 " "$cloud" 2>/dev/null
@@ -822,6 +835,12 @@ _live_cloudsigma() {
  return 0
 }
 
+_live_webdock() {
+ local fixture_dir="$1"
+ printf '%b\n' " ${YELLOW}skip${NC} Webdock live test (not implemented yet)" >&2
+ return 0
+}
+
 # --- Record one cloud ---
 # Check credentials and prompt if needed; returns 1 to skip this cloud
 _record_ensure_credentials() {

webdock/README.md

@@ -0,0 +1,134 @@
+# Webdock
+
+Webdock is a European VPS provider offering affordable cloud servers with API access.
+
+## Features
+
+- **REST API**: Full-featured API for server management
+- **Affordable pricing**: Starting from €2.15/month (Intel Xeon) or €4.30/month (AMD EPYC)
+- **Multiple locations**: Data centers in Europe (Finland, Netherlands, UK)
+- **Developer-friendly**: Free API, automated backups, free SSL, 1-click deployments
+- **SSH access**: Full root SSH access to all servers
+- **GDPR compliant**: European data protection standards
+
+## Authentication
+
+Set your Webdock API token as an environment variable:
+
+```bash
+export WEBDOCK_API_TOKEN="your-api-token-here"
+```
+
+To obtain an API token:
+1. Log in to [https://my.webdock.io](https://my.webdock.io)
+2. Go to Account Area > API & Integrations
+3. Generate a new API key
+
+The token will be automatically saved to `~/.config/spawn/webdock.json` for future use.
+
+## Usage
+
+Launch Claude Code on a Webdock server:
+
+```bash
+bash webdock/claude.sh
+```
+
+Or use the CLI:
+
+```bash
+spawn run webdock claude
+```
+
+## Available Scripts
+
+- `claude.sh` — Claude Code (Anthropic's CLI coding agent)
+- `cline.sh` — Cline (AI pair programming in your editor)
+- `aider.sh` — Aider (AI pair programming in the terminal)
+
+## Configuration
+
+### Server Profile
+
+Set the server profile (hardware tier) via environment variable:
+
+```bash
+export WEBDOCK_PROFILE="webdockmicro" # Default
+```
+
+Available profiles:
+- `webdockmicro` — 1 vCPU, 1GB RAM, 25GB SSD (€2.15-4.30/mo)
+- `webdocksmall` — 1 vCPU, 2GB RAM, 50GB SSD
+- `webdockmedium` — 2 vCPU, 4GB RAM, 80GB SSD
+- `webdocklarge` — 4 vCPU, 8GB RAM, 160GB SSD
+- `webdockxl` — 6 vCPU, 16GB RAM, 320GB SSD
+
+Check [Webdock pricing](https://webdock.io/en/pricing) for the full list and current prices.
+
+### Location
+
+Set the server location via environment variable:
+
+```bash
+export WEBDOCK_LOCATION="fi" # Default (Finland)
+```
+
+Available locations:
+- `fi` — Finland (Helsinki)
+- `nl` — Netherlands (Amsterdam)
+- `uk` — United Kingdom (London)
+
+### Image
+
+Set the OS image via environment variable:
+
+```bash
+export WEBDOCK_IMAGE="ubuntu2404" # Default
+```
+
+Available images include Ubuntu, Debian, and various pre-configured stacks (LEMP, WordPress, etc.).
+Check the Webdock control panel for the full list of available images.
+
+### Server Name
+
+Set a custom server name:
+
+```bash
+export WEBDOCK_SERVER_NAME="my-ai-server"
+```
+
+If not set, you'll be prompted to enter one.
+
+## How It Works
+
+1. **Authenticate**: Validates your API token with Webdock
+2. **SSH Key**: Ensures your SSH key is registered (generates ed25519 key if needed)
+3. **Provision**: Creates a new server with the specified profile, location, and image
+4. **Wait**: Polls until the server is online and SSH-ready
+5. **Setup**: Installs the agent and configures OpenRouter API credentials
+6. **Launch**: Drops you into an interactive session with the agent
+
+## Cleanup
+
+Servers persist after the script exits. To destroy a server:
+
+```bash
+# Using the Webdock API
+curl -X DELETE "https://api.webdock.io/v1/servers/SERVER_SLUG" \
+ -H "Authorization: Bearer $WEBDOCK_API_TOKEN"
+```
+
+Or delete from the Webdock control panel: https://my.webdock.io/servers
+
+## Limitations
+
+- Webdock is primarily European-focused (data centers in EU only)
+- Profile availability may vary by location
+- Server creation can take 1-3 minutes depending on load
+
+## Links
+
+- Website: https://webdock.io
+- API Documentation: https://api.webdock.io/v1
+- Control Panel: https://my.webdock.io
+- Pricing: https://webdock.io/en/pricing

webdock/aider.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+# shellcheck source=webdock/lib/common.sh
+if [[ -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+ source "${SCRIPT_DIR}/lib/common.sh"
+else
+ eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/webdock/lib/common.sh)"
+fi
+
+log_info "Aider on Webdock"
+echo ""
+
+ensure_webdock_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "${SERVER_NAME}"
+verify_server_connectivity "${WEBDOCK_SERVER_IP}"
+wait_for_cloud_init "${WEBDOCK_SERVER_IP}" 60
+
+log_step "Installing Aider..."
+run_server "${WEBDOCK_SERVER_IP}" "pip install aider-chat 2>/dev/null || pip3 install aider-chat"
+log_info "Aider installed"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+MODEL_ID=$(get_model_id_interactive "openrouter/auto" "Aider") || exit 1
+
+log_step "Setting up environment variables..."
+inject_env_vars_ssh "${WEBDOCK_SERVER_IP}" upload_file run_server \
+ "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}"
+
+echo ""
+log_info "Webdock server setup completed successfully!"
+log_info "Server: ${SERVER_NAME} (slug: ${WEBDOCK_SERVER_SLUG}, IP: ${WEBDOCK_SERVER_IP})"
+echo ""
+
+log_step "Starting Aider..."
+sleep 1
+clear
+interactive_session "${WEBDOCK_SERVER_IP}" "source ~/.zshrc && aider --model openrouter/${MODEL_ID}"

webdock/claude.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+# shellcheck source=webdock/lib/common.sh
+if [[ -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+ source "${SCRIPT_DIR}/lib/common.sh"
+else
+ eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/webdock/lib/common.sh)"
+fi
+
+log_info "Claude Code on Webdock"
+echo ""
+
+ensure_webdock_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "${SERVER_NAME}"
+verify_server_connectivity "${WEBDOCK_SERVER_IP}"
+wait_for_cloud_init "${WEBDOCK_SERVER_IP}" 60
+
+log_step "Verifying Claude Code installation..."
+if ! run_server "${WEBDOCK_SERVER_IP}" "export PATH=\$HOME/.local/bin:\$PATH && command -v claude" >/dev/null 2>&1; then
+ log_step "Claude Code not found, installing manually..."
+ run_server "${WEBDOCK_SERVER_IP}" "curl -fsSL https://claude.ai/install.sh | bash"
+fi
+log_info "Claude Code is installed"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+log_step "Setting up environment variables..."
+inject_env_vars_ssh "${WEBDOCK_SERVER_IP}" upload_file run_server \
+ "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}" \
+ "ANTHROPIC_BASE_URL=https://openrouter.ai/api" \
+ "ANTHROPIC_AUTH_TOKEN=${OPENROUTER_API_KEY}" \
+ "ANTHROPIC_API_KEY=" \
+ "CLAUDE_CODE_SKIP_ONBOARDING=1" \
+ "CLAUDE_CODE_ENABLE_TELEMETRY=0"
+
+setup_claude_code_config "${OPENROUTER_API_KEY}" \
+ "upload_file ${WEBDOCK_SERVER_IP}" \
+ "run_server ${WEBDOCK_SERVER_IP}"
+
+echo ""
+log_info "Webdock server setup completed successfully!"
+log_info "Server: ${SERVER_NAME} (slug: ${WEBDOCK_SERVER_SLUG}, IP: ${WEBDOCK_SERVER_IP})"
+echo ""
+
+log_step "Starting Claude Code..."
+sleep 1
+clear
+interactive_session "${WEBDOCK_SERVER_IP}" "export PATH=\$HOME/.local/bin:\$PATH && source ~/.zshrc && claude"

manifest.json

@@ -795,6 +795,21 @@
  "region": "zrh"
  },
  "notes": "API-centric cloud platform with regions in ZRH (Zurich), WDC (Washington DC), and LVS (Las Vegas). Granular resource control (CPU/RAM/Disk independently configurable). Uses 'cloudsigma' user for SSH."
+ },
+ "webdock": {
+ "name": "Webdock",
+ "description": "European VPS provider with affordable plans",
+ "url": "https://webdock.io/",
+ "type": "api",
+ "auth": "WEBDOCK_API_TOKEN",
+ "provision_method": "POST /v1/servers",
+ "exec_method": "ssh root@IP",
+ "interactive_method": "ssh -t root@IP",
+ "defaults": {
+ "profile": "webdockmicro",
+ "location": "fi",
+ "image": "ubuntu2404"
+ }
  }
  },
  "matrix": {
@@ -1337,6 +1352,21 @@
  "cloudsigma/opencode": "missing",
  "cloudsigma/plandex": "missing",
  "cloudsigma/kilocode": "missing",
- "cloudsigma/continue": "implemented"
+ "cloudsigma/continue": "implemented",
+ "webdock/claude": "implemented",
+ "webdock/openclaw": "missing",
+ "webdock/nanoclaw": "missing",
+ "webdock/aider": "implemented",
+ "webdock/goose": "missing",
+ "webdock/codex": "missing",
+ "webdock/interpreter": "missing",
+ "webdock/gemini": "missing",
+ "webdock/amazonq": "missing",
+ "webdock/cline": "implemented",
+ "webdock/gptme": "missing",
+ "webdock/opencode": "missing",
+ "webdock/plandex": "missing",
+ "webdock/kilocode": "missing",
+ "webdock/continue": "missing"
  }
-}
+}

test/mock.sh

@@ -263,6 +263,7 @@ _strip_api_base() {
  https://cloudapi.atlantic.net/*) ENDPOINT=$(echo "$URL" | sed 's|https://cloudapi.atlantic.net/\?||') ;;
  https://invapi.hostkey.com*) ENDPOINT="${URL#https://invapi.hostkey.com}" ;;
  https://*.cloudsigma.com/api/2.0*) ENDPOINT=$(echo "$URL" | sed 's|https://[^/]*.cloudsigma.com/api/2.0||') ;;
+ https://api.webdock.io/v1*) ENDPOINT="${URL#https://api.webdock.io/v1}" ;;
  esac
  EP_CLEAN=$(echo "$ENDPOINT" | sed 's|?.*||')
 }
@@ -288,6 +289,7 @@ _validate_body() {
  vultr) case "$EP_CLEAN" in /instances) _check_fields "label region plan os_id" ;; esac ;;
  linode) case "$EP_CLEAN" in /linode/instances) _check_fields "label region type image" ;; esac ;;
  civo) case "$EP_CLEAN" in /instances) _check_fields "hostname size region" ;; esac ;;
+ webdock) case "$EP_CLEAN" in /servers) _check_fields "name slug locationId profileSlug imageSlug" ;; esac ;;
  esac
 }
 

test/record.sh

@@ -31,7 +31,7 @@ ERRORS=0
 PROMPT_FOR_CREDS=true
 
 # All clouds with REST APIs that we can record from
-ALL_RECORDABLE_CLOUDS="hetzner digitalocean vultr linode lambda civo upcloud binarylane ovh scaleway genesiscloud kamatera latitude hyperstack atlanticnet hostkey cloudsigma"
+ALL_RECORDABLE_CLOUDS="hetzner digitalocean vultr linode lambda civo upcloud binarylane ovh scaleway genesiscloud kamatera latitude hyperstack atlanticnet hostkey cloudsigma webdock"
 
 # --- Endpoint registry ---
 # Format: "fixture_name:endpoint"
@@ -141,6 +141,14 @@ get_endpoints() {
  "keypairs:/keypairs/" \
  "servers:/servers/"
  ;;
+ webdock)
+ printf '%s\n' \
+ "account:/account" \
+ "publicKeys:/account/publicKeys" \
+ "servers:/servers" \
+ "profiles:/profiles" \
+ "locations:/locations"
+ ;;
  esac
 }
 
@@ -165,6 +173,7 @@ get_auth_env_var() {
  atlanticnet) printf "ATLANTICNET_API_KEY" ;;
  hostkey) printf "HOSTKEY_API_KEY" ;;
  cloudsigma) printf "CLOUDSIGMA_EMAIL" ;;
+ webdock) printf "WEBDOCK_API_TOKEN" ;;
  esac
 }
 
@@ -399,6 +408,7 @@ call_api() {
  atlanticnet) atlanticnet_api "$endpoint" ;;
  hostkey) hostkey_api "$endpoint" ;;
  cloudsigma) cloudsigma_api GET "$endpoint" ;;
+ webdock) webdock_api GET "$endpoint" ;;
  esac
 }
 
@@ -444,6 +454,9 @@ elif cloud == 'hostkey':
 elif cloud == 'cloudsigma':
  # CloudSigma returns error objects with 'error_message', 'error_type', etc
  sys.exit(0 if 'error_message' in d or 'error_type' in d else 1)
+elif cloud == 'webdock':
+ # Webdock returns error objects with 'message' field
+ sys.exit(0 if 'message' in d and len(d) <= 3 and not any(k in d for k in ('slug','name','status','ipv4')) else 1)
 else:
  sys.exit(1)
 " "$cloud" 2>/dev/null
@@ -822,6 +835,12 @@ _live_cloudsigma() {
  return 0
 }
 
+_live_webdock() {
+ local fixture_dir="$1"
+ printf '%b\n' " ${YELLOW}skip${NC} Webdock live test (not implemented yet)" >&2
+ return 0
+}
+
 # --- Record one cloud ---
 # Check credentials and prompt if needed; returns 1 to skip this cloud
 _record_ensure_credentials() {

webdock/README.md

@@ -0,0 +1,134 @@
+# Webdock
+
+Webdock is a European VPS provider offering affordable cloud servers with API access.
+
+## Features
+
+- **REST API**: Full-featured API for server management
+- **Affordable pricing**: Starting from €2.15/month (Intel Xeon) or €4.30/month (AMD EPYC)
+- **Multiple locations**: Data centers in Europe (Finland, Netherlands, UK)
+- **Developer-friendly**: Free API, automated backups, free SSL, 1-click deployments
+- **SSH access**: Full root SSH access to all servers
+- **GDPR compliant**: European data protection standards
+
+## Authentication
+
+Set your Webdock API token as an environment variable:
+
+```bash
+export WEBDOCK_API_TOKEN="your-api-token-here"
+```
+
+To obtain an API token:
+1. Log in to [https://my.webdock.io](https://my.webdock.io)
+2. Go to Account Area > API & Integrations
+3. Generate a new API key
+
+The token will be automatically saved to `~/.config/spawn/webdock.json` for future use.
+
+## Usage
+
+Launch Claude Code on a Webdock server:
+
+```bash
+bash webdock/claude.sh
+```
+
+Or use the CLI:
+
+```bash
+spawn run webdock claude
+```
+
+## Available Scripts
+
+- `claude.sh` — Claude Code (Anthropic's CLI coding agent)
+- `cline.sh` — Cline (AI pair programming in your editor)
+- `aider.sh` — Aider (AI pair programming in the terminal)
+
+## Configuration
+
+### Server Profile
+
+Set the server profile (hardware tier) via environment variable:
+
+```bash
+export WEBDOCK_PROFILE="webdockmicro" # Default
+```
+
+Available profiles:
+- `webdockmicro` — 1 vCPU, 1GB RAM, 25GB SSD (€2.15-4.30/mo)
+- `webdocksmall` — 1 vCPU, 2GB RAM, 50GB SSD
+- `webdockmedium` — 2 vCPU, 4GB RAM, 80GB SSD
+- `webdocklarge` — 4 vCPU, 8GB RAM, 160GB SSD
+- `webdockxl` — 6 vCPU, 16GB RAM, 320GB SSD
+
+Check [Webdock pricing](https://webdock.io/en/pricing) for the full list and current prices.
+
+### Location
+
+Set the server location via environment variable:
+
+```bash
+export WEBDOCK_LOCATION="fi" # Default (Finland)
+```
+
+Available locations:
+- `fi` — Finland (Helsinki)
+- `nl` — Netherlands (Amsterdam)
+- `uk` — United Kingdom (London)
+
+### Image
+
+Set the OS image via environment variable:
+
+```bash
+export WEBDOCK_IMAGE="ubuntu2404" # Default
+```
+
+Available images include Ubuntu, Debian, and various pre-configured stacks (LEMP, WordPress, etc.).
+Check the Webdock control panel for the full list of available images.
+
+### Server Name
+
+Set a custom server name:
+
+```bash
+export WEBDOCK_SERVER_NAME="my-ai-server"
+```
+
+If not set, you'll be prompted to enter one.
+
+## How It Works
+
+1. **Authenticate**: Validates your API token with Webdock
+2. **SSH Key**: Ensures your SSH key is registered (generates ed25519 key if needed)
+3. **Provision**: Creates a new server with the specified profile, location, and image
+4. **Wait**: Polls until the server is online and SSH-ready
+5. **Setup**: Installs the agent and configures OpenRouter API credentials
+6. **Launch**: Drops you into an interactive session with the agent
+
+## Cleanup
+
+Servers persist after the script exits. To destroy a server:
+
+```bash
+# Using the Webdock API
+curl -X DELETE "https://api.webdock.io/v1/servers/SERVER_SLUG" \
+ -H "Authorization: Bearer $WEBDOCK_API_TOKEN"
+```
+
+Or delete from the Webdock control panel: https://my.webdock.io/servers
+
+## Limitations
+
+- Webdock is primarily European-focused (data centers in EU only)
+- Profile availability may vary by location
+- Server creation can take 1-3 minutes depending on load
+
+## Links
+
+- Website: https://webdock.io
+- API Documentation: https://api.webdock.io/v1
+- Control Panel: https://my.webdock.io
+- Pricing: https://webdock.io/en/pricing

webdock/aider.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+# shellcheck source=webdock/lib/common.sh
+if [[ -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+ source "${SCRIPT_DIR}/lib/common.sh"
+else
+ eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/webdock/lib/common.sh)"
+fi
+
+log_info "Aider on Webdock"
+echo ""
+
+ensure_webdock_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "${SERVER_NAME}"
+verify_server_connectivity "${WEBDOCK_SERVER_IP}"
+wait_for_cloud_init "${WEBDOCK_SERVER_IP}" 60
+
+log_step "Installing Aider..."
+run_server "${WEBDOCK_SERVER_IP}" "pip install aider-chat 2>/dev/null || pip3 install aider-chat"
+log_info "Aider installed"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+MODEL_ID=$(get_model_id_interactive "openrouter/auto" "Aider") || exit 1
+
+log_step "Setting up environment variables..."
+inject_env_vars_ssh "${WEBDOCK_SERVER_IP}" upload_file run_server \
+ "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}"
+
+echo ""
+log_info "Webdock server setup completed successfully!"
+log_info "Server: ${SERVER_NAME} (slug: ${WEBDOCK_SERVER_SLUG}, IP: ${WEBDOCK_SERVER_IP})"
+echo ""
+
+log_step "Starting Aider..."
+sleep 1
+clear
+interactive_session "${WEBDOCK_SERVER_IP}" "source ~/.zshrc && aider --model openrouter/${MODEL_ID}"

webdock/claude.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+# shellcheck source=webdock/lib/common.sh
+if [[ -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+ source "${SCRIPT_DIR}/lib/common.sh"
+else
+ eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/webdock/lib/common.sh)"
+fi
+
+log_info "Claude Code on Webdock"
+echo ""
+
+ensure_webdock_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "${SERVER_NAME}"
+verify_server_connectivity "${WEBDOCK_SERVER_IP}"
+wait_for_cloud_init "${WEBDOCK_SERVER_IP}" 60
+
+log_step "Verifying Claude Code installation..."
+if ! run_server "${WEBDOCK_SERVER_IP}" "export PATH=\$HOME/.local/bin:\$PATH && command -v claude" >/dev/null 2>&1; then
+ log_step "Claude Code not found, installing manually..."
+ run_server "${WEBDOCK_SERVER_IP}" "curl -fsSL https://claude.ai/install.sh | bash"
+fi
+log_info "Claude Code is installed"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+log_step "Setting up environment variables..."
+inject_env_vars_ssh "${WEBDOCK_SERVER_IP}" upload_file run_server \
+ "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}" \
+ "ANTHROPIC_BASE_URL=https://openrouter.ai/api" \
+ "ANTHROPIC_AUTH_TOKEN=${OPENROUTER_API_KEY}" \
+ "ANTHROPIC_API_KEY=" \
+ "CLAUDE_CODE_SKIP_ONBOARDING=1" \
+ "CLAUDE_CODE_ENABLE_TELEMETRY=0"
+
+setup_claude_code_config "${OPENROUTER_API_KEY}" \
+ "upload_file ${WEBDOCK_SERVER_IP}" \
+ "run_server ${WEBDOCK_SERVER_IP}"
+
+echo ""
+log_info "Webdock server setup completed successfully!"
+log_info "Server: ${SERVER_NAME} (slug: ${WEBDOCK_SERVER_SLUG}, IP: ${WEBDOCK_SERVER_IP})"
+echo ""
+
+log_step "Starting Claude Code..."
+sleep 1
+clear
+interactive_session "${WEBDOCK_SERVER_IP}" "export PATH=\$HOME/.local/bin:\$PATH && source ~/.zshrc && claude"

manifest.json

@@ -795,6 +795,21 @@
  "region": "zrh"
  },
  "notes": "API-centric cloud platform with regions in ZRH (Zurich), WDC (Washington DC), and LVS (Las Vegas). Granular resource control (CPU/RAM/Disk independently configurable). Uses 'cloudsigma' user for SSH."
+ },
+ "webdock": {
+ "name": "Webdock",
+ "description": "European VPS provider with affordable plans",
+ "url": "https://webdock.io/",
+ "type": "api",
+ "auth": "WEBDOCK_API_TOKEN",
+ "provision_method": "POST /v1/servers",
+ "exec_method": "ssh root@IP",
+ "interactive_method": "ssh -t root@IP",
+ "defaults": {
+ "profile": "webdockmicro",
+ "location": "fi",
+ "image": "ubuntu2404"
+ }
  }
  },
  "matrix": {
@@ -1337,6 +1352,21 @@
  "cloudsigma/opencode": "missing",
  "cloudsigma/plandex": "missing",
  "cloudsigma/kilocode": "missing",
- "cloudsigma/continue": "implemented"
+ "cloudsigma/continue": "implemented",
+ "webdock/claude": "implemented",
+ "webdock/openclaw": "missing",
+ "webdock/nanoclaw": "missing",
+ "webdock/aider": "implemented",
+ "webdock/goose": "missing",
+ "webdock/codex": "missing",
+ "webdock/interpreter": "missing",
+ "webdock/gemini": "missing",
+ "webdock/amazonq": "missing",
+ "webdock/cline": "implemented",
+ "webdock/gptme": "missing",
+ "webdock/opencode": "missing",
+ "webdock/plandex": "missing",
+ "webdock/kilocode": "missing",
+ "webdock/continue": "missing"
  }
-}
+}

test/mock.sh

@@ -263,6 +263,7 @@ _strip_api_base() {
  https://cloudapi.atlantic.net/*) ENDPOINT=$(echo "$URL" | sed 's|https://cloudapi.atlantic.net/\?||') ;;
  https://invapi.hostkey.com*) ENDPOINT="${URL#https://invapi.hostkey.com}" ;;
  https://*.cloudsigma.com/api/2.0*) ENDPOINT=$(echo "$URL" | sed 's|https://[^/]*.cloudsigma.com/api/2.0||') ;;
+ https://api.webdock.io/v1*) ENDPOINT="${URL#https://api.webdock.io/v1}" ;;
  esac
  EP_CLEAN=$(echo "$ENDPOINT" | sed 's|?.*||')
 }
@@ -288,6 +289,7 @@ _validate_body() {
  vultr) case "$EP_CLEAN" in /instances) _check_fields "label region plan os_id" ;; esac ;;
  linode) case "$EP_CLEAN" in /linode/instances) _check_fields "label region type image" ;; esac ;;
  civo) case "$EP_CLEAN" in /instances) _check_fields "hostname size region" ;; esac ;;
+ webdock) case "$EP_CLEAN" in /servers) _check_fields "name slug locationId profileSlug imageSlug" ;; esac ;;
  esac
 }
 

test/record.sh

@@ -31,7 +31,7 @@ ERRORS=0
 PROMPT_FOR_CREDS=true
 
 # All clouds with REST APIs that we can record from
-ALL_RECORDABLE_CLOUDS="hetzner digitalocean vultr linode lambda civo upcloud binarylane ovh scaleway genesiscloud kamatera latitude hyperstack atlanticnet hostkey cloudsigma"
+ALL_RECORDABLE_CLOUDS="hetzner digitalocean vultr linode lambda civo upcloud binarylane ovh scaleway genesiscloud kamatera latitude hyperstack atlanticnet hostkey cloudsigma webdock"
 
 # --- Endpoint registry ---
 # Format: "fixture_name:endpoint"
@@ -141,6 +141,14 @@ get_endpoints() {
  "keypairs:/keypairs/" \
  "servers:/servers/"
  ;;
+ webdock)
+ printf '%s\n' \
+ "account:/account" \
+ "publicKeys:/account/publicKeys" \
+ "servers:/servers" \
+ "profiles:/profiles" \
+ "locations:/locations"
+ ;;
  esac
 }
 
@@ -165,6 +173,7 @@ get_auth_env_var() {
  atlanticnet) printf "ATLANTICNET_API_KEY" ;;
  hostkey) printf "HOSTKEY_API_KEY" ;;
  cloudsigma) printf "CLOUDSIGMA_EMAIL" ;;
+ webdock) printf "WEBDOCK_API_TOKEN" ;;
  esac
 }
 
@@ -399,6 +408,7 @@ call_api() {
  atlanticnet) atlanticnet_api "$endpoint" ;;
  hostkey) hostkey_api "$endpoint" ;;
  cloudsigma) cloudsigma_api GET "$endpoint" ;;
+ webdock) webdock_api GET "$endpoint" ;;
  esac
 }
 
@@ -444,6 +454,9 @@ elif cloud == 'hostkey':
 elif cloud == 'cloudsigma':
  # CloudSigma returns error objects with 'error_message', 'error_type', etc
  sys.exit(0 if 'error_message' in d or 'error_type' in d else 1)
+elif cloud == 'webdock':
+ # Webdock returns error objects with 'message' field
+ sys.exit(0 if 'message' in d and len(d) <= 3 and not any(k in d for k in ('slug','name','status','ipv4')) else 1)
 else:
  sys.exit(1)
 " "$cloud" 2>/dev/null
@@ -822,6 +835,12 @@ _live_cloudsigma() {
  return 0
 }
 
+_live_webdock() {
+ local fixture_dir="$1"
+ printf '%b\n' " ${YELLOW}skip${NC} Webdock live test (not implemented yet)" >&2
+ return 0
+}
+
 # --- Record one cloud ---
 # Check credentials and prompt if needed; returns 1 to skip this cloud
 _record_ensure_credentials() {

webdock/README.md

@@ -0,0 +1,134 @@
+# Webdock
+
+Webdock is a European VPS provider offering affordable cloud servers with API access.
+
+## Features
+
+- **REST API**: Full-featured API for server management
+- **Affordable pricing**: Starting from €2.15/month (Intel Xeon) or €4.30/month (AMD EPYC)
+- **Multiple locations**: Data centers in Europe (Finland, Netherlands, UK)
+- **Developer-friendly**: Free API, automated backups, free SSL, 1-click deployments
+- **SSH access**: Full root SSH access to all servers
+- **GDPR compliant**: European data protection standards
+
+## Authentication
+
+Set your Webdock API token as an environment variable:
+
+```bash
+export WEBDOCK_API_TOKEN="your-api-token-here"
+```
+
+To obtain an API token:
+1. Log in to [https://my.webdock.io](https://my.webdock.io)
+2. Go to Account Area > API & Integrations
+3. Generate a new API key
+
+The token will be automatically saved to `~/.config/spawn/webdock.json` for future use.
+
+## Usage
+
+Launch Claude Code on a Webdock server:
+
+```bash
+bash webdock/claude.sh
+```
+
+Or use the CLI:
+
+```bash
+spawn run webdock claude
+```
+
+## Available Scripts
+
+- `claude.sh` — Claude Code (Anthropic's CLI coding agent)
+- `cline.sh` — Cline (AI pair programming in your editor)
+- `aider.sh` — Aider (AI pair programming in the terminal)
+
+## Configuration
+
+### Server Profile
+
+Set the server profile (hardware tier) via environment variable:
+
+```bash
+export WEBDOCK_PROFILE="webdockmicro" # Default
+```
+
+Available profiles:
+- `webdockmicro` — 1 vCPU, 1GB RAM, 25GB SSD (€2.15-4.30/mo)
+- `webdocksmall` — 1 vCPU, 2GB RAM, 50GB SSD
+- `webdockmedium` — 2 vCPU, 4GB RAM, 80GB SSD
+- `webdocklarge` — 4 vCPU, 8GB RAM, 160GB SSD
+- `webdockxl` — 6 vCPU, 16GB RAM, 320GB SSD
+
+Check [Webdock pricing](https://webdock.io/en/pricing) for the full list and current prices.
+
+### Location
+
+Set the server location via environment variable:
+
+```bash
+export WEBDOCK_LOCATION="fi" # Default (Finland)
+```
+
+Available locations:
+- `fi` — Finland (Helsinki)
+- `nl` — Netherlands (Amsterdam)
+- `uk` — United Kingdom (London)
+
+### Image
+
+Set the OS image via environment variable:
+
+```bash
+export WEBDOCK_IMAGE="ubuntu2404" # Default
+```
+
+Available images include Ubuntu, Debian, and various pre-configured stacks (LEMP, WordPress, etc.).
+Check the Webdock control panel for the full list of available images.
+
+### Server Name
+
+Set a custom server name:
+
+```bash
+export WEBDOCK_SERVER_NAME="my-ai-server"
+```
+
+If not set, you'll be prompted to enter one.
+
+## How It Works
+
+1. **Authenticate**: Validates your API token with Webdock
+2. **SSH Key**: Ensures your SSH key is registered (generates ed25519 key if needed)
+3. **Provision**: Creates a new server with the specified profile, location, and image
+4. **Wait**: Polls until the server is online and SSH-ready
+5. **Setup**: Installs the agent and configures OpenRouter API credentials
+6. **Launch**: Drops you into an interactive session with the agent
+
+## Cleanup
+
+Servers persist after the script exits. To destroy a server:
+
+```bash
+# Using the Webdock API
+curl -X DELETE "https://api.webdock.io/v1/servers/SERVER_SLUG" \
+ -H "Authorization: Bearer $WEBDOCK_API_TOKEN"
+```
+
+Or delete from the Webdock control panel: https://my.webdock.io/servers
+
+## Limitations
+
+- Webdock is primarily European-focused (data centers in EU only)
+- Profile availability may vary by location
+- Server creation can take 1-3 minutes depending on load
+
+## Links
+
+- Website: https://webdock.io
+- API Documentation: https://api.webdock.io/v1
+- Control Panel: https://my.webdock.io
+- Pricing: https://webdock.io/en/pricing

webdock/aider.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+# shellcheck source=webdock/lib/common.sh
+if [[ -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+ source "${SCRIPT_DIR}/lib/common.sh"
+else
+ eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/webdock/lib/common.sh)"
+fi
+
+log_info "Aider on Webdock"
+echo ""
+
+ensure_webdock_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "${SERVER_NAME}"
+verify_server_connectivity "${WEBDOCK_SERVER_IP}"
+wait_for_cloud_init "${WEBDOCK_SERVER_IP}" 60
+
+log_step "Installing Aider..."
+run_server "${WEBDOCK_SERVER_IP}" "pip install aider-chat 2>/dev/null || pip3 install aider-chat"
+log_info "Aider installed"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+MODEL_ID=$(get_model_id_interactive "openrouter/auto" "Aider") || exit 1
+
+log_step "Setting up environment variables..."
+inject_env_vars_ssh "${WEBDOCK_SERVER_IP}" upload_file run_server \
+ "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}"
+
+echo ""
+log_info "Webdock server setup completed successfully!"
+log_info "Server: ${SERVER_NAME} (slug: ${WEBDOCK_SERVER_SLUG}, IP: ${WEBDOCK_SERVER_IP})"
+echo ""
+
+log_step "Starting Aider..."
+sleep 1
+clear
+interactive_session "${WEBDOCK_SERVER_IP}" "source ~/.zshrc && aider --model openrouter/${MODEL_ID}"

webdock/claude.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+# shellcheck source=webdock/lib/common.sh
+if [[ -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+ source "${SCRIPT_DIR}/lib/common.sh"
+else
+ eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/webdock/lib/common.sh)"
+fi
+
+log_info "Claude Code on Webdock"
+echo ""
+
+ensure_webdock_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "${SERVER_NAME}"
+verify_server_connectivity "${WEBDOCK_SERVER_IP}"
+wait_for_cloud_init "${WEBDOCK_SERVER_IP}" 60
+
+log_step "Verifying Claude Code installation..."
+if ! run_server "${WEBDOCK_SERVER_IP}" "export PATH=\$HOME/.local/bin:\$PATH && command -v claude" >/dev/null 2>&1; then
+ log_step "Claude Code not found, installing manually..."
+ run_server "${WEBDOCK_SERVER_IP}" "curl -fsSL https://claude.ai/install.sh | bash"
+fi
+log_info "Claude Code is installed"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+log_step "Setting up environment variables..."
+inject_env_vars_ssh "${WEBDOCK_SERVER_IP}" upload_file run_server \
+ "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}" \
+ "ANTHROPIC_BASE_URL=https://openrouter.ai/api" \
+ "ANTHROPIC_AUTH_TOKEN=${OPENROUTER_API_KEY}" \
+ "ANTHROPIC_API_KEY=" \
+ "CLAUDE_CODE_SKIP_ONBOARDING=1" \
+ "CLAUDE_CODE_ENABLE_TELEMETRY=0"
+
+setup_claude_code_config "${OPENROUTER_API_KEY}" \
+ "upload_file ${WEBDOCK_SERVER_IP}" \
+ "run_server ${WEBDOCK_SERVER_IP}"
+
+echo ""
+log_info "Webdock server setup completed successfully!"
+log_info "Server: ${SERVER_NAME} (slug: ${WEBDOCK_SERVER_SLUG}, IP: ${WEBDOCK_SERVER_IP})"
+echo ""
+
+log_step "Starting Claude Code..."
+sleep 1
+clear
+interactive_session "${WEBDOCK_SERVER_IP}" "export PATH=\$HOME/.local/bin:\$PATH && source ~/.zshrc && claude"

manifest.json

@@ -795,6 +795,21 @@
  "region": "zrh"
  },
  "notes": "API-centric cloud platform with regions in ZRH (Zurich), WDC (Washington DC), and LVS (Las Vegas). Granular resource control (CPU/RAM/Disk independently configurable). Uses 'cloudsigma' user for SSH."
+ },
+ "webdock": {
+ "name": "Webdock",
+ "description": "European VPS provider with affordable plans",
+ "url": "https://webdock.io/",
+ "type": "api",
+ "auth": "WEBDOCK_API_TOKEN",
+ "provision_method": "POST /v1/servers",
+ "exec_method": "ssh root@IP",
+ "interactive_method": "ssh -t root@IP",
+ "defaults": {
+ "profile": "webdockmicro",
+ "location": "fi",
+ "image": "ubuntu2404"
+ }
  }
  },
  "matrix": {
@@ -1337,6 +1352,21 @@
  "cloudsigma/opencode": "missing",
  "cloudsigma/plandex": "missing",
  "cloudsigma/kilocode": "missing",
- "cloudsigma/continue": "implemented"
+ "cloudsigma/continue": "implemented",
+ "webdock/claude": "implemented",
+ "webdock/openclaw": "missing",
+ "webdock/nanoclaw": "missing",
+ "webdock/aider": "implemented",
+ "webdock/goose": "missing",
+ "webdock/codex": "missing",
+ "webdock/interpreter": "missing",
+ "webdock/gemini": "missing",
+ "webdock/amazonq": "missing",
+ "webdock/cline": "implemented",
+ "webdock/gptme": "missing",
+ "webdock/opencode": "missing",
+ "webdock/plandex": "missing",
+ "webdock/kilocode": "missing",
+ "webdock/continue": "missing"
  }
-}
+}

test/mock.sh

@@ -263,6 +263,7 @@ _strip_api_base() {
  https://cloudapi.atlantic.net/*) ENDPOINT=$(echo "$URL" | sed 's|https://cloudapi.atlantic.net/\?||') ;;
  https://invapi.hostkey.com*) ENDPOINT="${URL#https://invapi.hostkey.com}" ;;
  https://*.cloudsigma.com/api/2.0*) ENDPOINT=$(echo "$URL" | sed 's|https://[^/]*.cloudsigma.com/api/2.0||') ;;
+ https://api.webdock.io/v1*) ENDPOINT="${URL#https://api.webdock.io/v1}" ;;
  esac
  EP_CLEAN=$(echo "$ENDPOINT" | sed 's|?.*||')
 }
@@ -288,6 +289,7 @@ _validate_body() {
  vultr) case "$EP_CLEAN" in /instances) _check_fields "label region plan os_id" ;; esac ;;
  linode) case "$EP_CLEAN" in /linode/instances) _check_fields "label region type image" ;; esac ;;
  civo) case "$EP_CLEAN" in /instances) _check_fields "hostname size region" ;; esac ;;
+ webdock) case "$EP_CLEAN" in /servers) _check_fields "name slug locationId profileSlug imageSlug" ;; esac ;;
  esac
 }
 

test/record.sh

@@ -31,7 +31,7 @@ ERRORS=0
 PROMPT_FOR_CREDS=true
 
 # All clouds with REST APIs that we can record from
-ALL_RECORDABLE_CLOUDS="hetzner digitalocean vultr linode lambda civo upcloud binarylane ovh scaleway genesiscloud kamatera latitude hyperstack atlanticnet hostkey cloudsigma"
+ALL_RECORDABLE_CLOUDS="hetzner digitalocean vultr linode lambda civo upcloud binarylane ovh scaleway genesiscloud kamatera latitude hyperstack atlanticnet hostkey cloudsigma webdock"
 
 # --- Endpoint registry ---
 # Format: "fixture_name:endpoint"
@@ -141,6 +141,14 @@ get_endpoints() {
  "keypairs:/keypairs/" \
  "servers:/servers/"
  ;;
+ webdock)
+ printf '%s\n' \
+ "account:/account" \
+ "publicKeys:/account/publicKeys" \
+ "servers:/servers" \
+ "profiles:/profiles" \
+ "locations:/locations"
+ ;;
  esac
 }
 
@@ -165,6 +173,7 @@ get_auth_env_var() {
  atlanticnet) printf "ATLANTICNET_API_KEY" ;;
  hostkey) printf "HOSTKEY_API_KEY" ;;
  cloudsigma) printf "CLOUDSIGMA_EMAIL" ;;
+ webdock) printf "WEBDOCK_API_TOKEN" ;;
  esac
 }
 
@@ -399,6 +408,7 @@ call_api() {
  atlanticnet) atlanticnet_api "$endpoint" ;;
  hostkey) hostkey_api "$endpoint" ;;
  cloudsigma) cloudsigma_api GET "$endpoint" ;;
+ webdock) webdock_api GET "$endpoint" ;;
  esac
 }
 
@@ -444,6 +454,9 @@ elif cloud == 'hostkey':
 elif cloud == 'cloudsigma':
  # CloudSigma returns error objects with 'error_message', 'error_type', etc
  sys.exit(0 if 'error_message' in d or 'error_type' in d else 1)
+elif cloud == 'webdock':
+ # Webdock returns error objects with 'message' field
+ sys.exit(0 if 'message' in d and len(d) <= 3 and not any(k in d for k in ('slug','name','status','ipv4')) else 1)
 else:
  sys.exit(1)
 " "$cloud" 2>/dev/null
@@ -822,6 +835,12 @@ _live_cloudsigma() {
  return 0
 }
 
+_live_webdock() {
+ local fixture_dir="$1"
+ printf '%b\n' " ${YELLOW}skip${NC} Webdock live test (not implemented yet)" >&2
+ return 0
+}
+
 # --- Record one cloud ---
 # Check credentials and prompt if needed; returns 1 to skip this cloud
 _record_ensure_credentials() {

webdock/README.md

@@ -0,0 +1,134 @@
+# Webdock
+
+Webdock is a European VPS provider offering affordable cloud servers with API access.
+
+## Features
+
+- **REST API**: Full-featured API for server management
+- **Affordable pricing**: Starting from €2.15/month (Intel Xeon) or €4.30/month (AMD EPYC)
+- **Multiple locations**: Data centers in Europe (Finland, Netherlands, UK)
+- **Developer-friendly**: Free API, automated backups, free SSL, 1-click deployments
+- **SSH access**: Full root SSH access to all servers
+- **GDPR compliant**: European data protection standards
+
+## Authentication
+
+Set your Webdock API token as an environment variable:
+
+```bash
+export WEBDOCK_API_TOKEN="your-api-token-here"
+```
+
+To obtain an API token:
+1. Log in to [https://my.webdock.io](https://my.webdock.io)
+2. Go to Account Area > API & Integrations
+3. Generate a new API key
+
+The token will be automatically saved to `~/.config/spawn/webdock.json` for future use.
+
+## Usage
+
+Launch Claude Code on a Webdock server:
+
+```bash
+bash webdock/claude.sh
+```
+
+Or use the CLI:
+
+```bash
+spawn run webdock claude
+```
+
+## Available Scripts
+
+- `claude.sh` — Claude Code (Anthropic's CLI coding agent)
+- `cline.sh` — Cline (AI pair programming in your editor)
+- `aider.sh` — Aider (AI pair programming in the terminal)
+
+## Configuration
+
+### Server Profile
+
+Set the server profile (hardware tier) via environment variable:
+
+```bash
+export WEBDOCK_PROFILE="webdockmicro" # Default
+```
+
+Available profiles:
+- `webdockmicro` — 1 vCPU, 1GB RAM, 25GB SSD (€2.15-4.30/mo)
+- `webdocksmall` — 1 vCPU, 2GB RAM, 50GB SSD
+- `webdockmedium` — 2 vCPU, 4GB RAM, 80GB SSD
+- `webdocklarge` — 4 vCPU, 8GB RAM, 160GB SSD
+- `webdockxl` — 6 vCPU, 16GB RAM, 320GB SSD
+
+Check [Webdock pricing](https://webdock.io/en/pricing) for the full list and current prices.
+
+### Location
+
+Set the server location via environment variable:
+
+```bash
+export WEBDOCK_LOCATION="fi" # Default (Finland)
+```
+
+Available locations:
+- `fi` — Finland (Helsinki)
+- `nl` — Netherlands (Amsterdam)
+- `uk` — United Kingdom (London)
+
+### Image
+
+Set the OS image via environment variable:
+
+```bash
+export WEBDOCK_IMAGE="ubuntu2404" # Default
+```
+
+Available images include Ubuntu, Debian, and various pre-configured stacks (LEMP, WordPress, etc.).
+Check the Webdock control panel for the full list of available images.
+
+### Server Name
+
+Set a custom server name:
+
+```bash
+export WEBDOCK_SERVER_NAME="my-ai-server"
+```
+
+If not set, you'll be prompted to enter one.
+
+## How It Works
+
+1. **Authenticate**: Validates your API token with Webdock
+2. **SSH Key**: Ensures your SSH key is registered (generates ed25519 key if needed)
+3. **Provision**: Creates a new server with the specified profile, location, and image
+4. **Wait**: Polls until the server is online and SSH-ready
+5. **Setup**: Installs the agent and configures OpenRouter API credentials
+6. **Launch**: Drops you into an interactive session with the agent
+
+## Cleanup
+
+Servers persist after the script exits. To destroy a server:
+
+```bash
+# Using the Webdock API
+curl -X DELETE "https://api.webdock.io/v1/servers/SERVER_SLUG" \
+ -H "Authorization: Bearer $WEBDOCK_API_TOKEN"
+```
+
+Or delete from the Webdock control panel: https://my.webdock.io/servers
+
+## Limitations
+
+- Webdock is primarily European-focused (data centers in EU only)
+- Profile availability may vary by location
+- Server creation can take 1-3 minutes depending on load
+
+## Links
+
+- Website: https://webdock.io
+- API Documentation: https://api.webdock.io/v1
+- Control Panel: https://my.webdock.io
+- Pricing: https://webdock.io/en/pricing

webdock/aider.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+# shellcheck source=webdock/lib/common.sh
+if [[ -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+ source "${SCRIPT_DIR}/lib/common.sh"
+else
+ eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/webdock/lib/common.sh)"
+fi
+
+log_info "Aider on Webdock"
+echo ""
+
+ensure_webdock_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "${SERVER_NAME}"
+verify_server_connectivity "${WEBDOCK_SERVER_IP}"
+wait_for_cloud_init "${WEBDOCK_SERVER_IP}" 60
+
+log_step "Installing Aider..."
+run_server "${WEBDOCK_SERVER_IP}" "pip install aider-chat 2>/dev/null || pip3 install aider-chat"
+log_info "Aider installed"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+MODEL_ID=$(get_model_id_interactive "openrouter/auto" "Aider") || exit 1
+
+log_step "Setting up environment variables..."
+inject_env_vars_ssh "${WEBDOCK_SERVER_IP}" upload_file run_server \
+ "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}"
+
+echo ""
+log_info "Webdock server setup completed successfully!"
+log_info "Server: ${SERVER_NAME} (slug: ${WEBDOCK_SERVER_SLUG}, IP: ${WEBDOCK_SERVER_IP})"
+echo ""
+
+log_step "Starting Aider..."
+sleep 1
+clear
+interactive_session "${WEBDOCK_SERVER_IP}" "source ~/.zshrc && aider --model openrouter/${MODEL_ID}"

webdock/claude.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+# shellcheck source=webdock/lib/common.sh
+if [[ -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+ source "${SCRIPT_DIR}/lib/common.sh"
+else
+ eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/webdock/lib/common.sh)"
+fi
+
+log_info "Claude Code on Webdock"
+echo ""
+
+ensure_webdock_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "${SERVER_NAME}"
+verify_server_connectivity "${WEBDOCK_SERVER_IP}"
+wait_for_cloud_init "${WEBDOCK_SERVER_IP}" 60
+
+log_step "Verifying Claude Code installation..."
+if ! run_server "${WEBDOCK_SERVER_IP}" "export PATH=\$HOME/.local/bin:\$PATH && command -v claude" >/dev/null 2>&1; then
+ log_step "Claude Code not found, installing manually..."
+ run_server "${WEBDOCK_SERVER_IP}" "curl -fsSL https://claude.ai/install.sh | bash"
+fi
+log_info "Claude Code is installed"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+log_step "Setting up environment variables..."
+inject_env_vars_ssh "${WEBDOCK_SERVER_IP}" upload_file run_server \
+ "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}" \
+ "ANTHROPIC_BASE_URL=https://openrouter.ai/api" \
+ "ANTHROPIC_AUTH_TOKEN=${OPENROUTER_API_KEY}" \
+ "ANTHROPIC_API_KEY=" \
+ "CLAUDE_CODE_SKIP_ONBOARDING=1" \
+ "CLAUDE_CODE_ENABLE_TELEMETRY=0"
+
+setup_claude_code_config "${OPENROUTER_API_KEY}" \
+ "upload_file ${WEBDOCK_SERVER_IP}" \
+ "run_server ${WEBDOCK_SERVER_IP}"
+
+echo ""
+log_info "Webdock server setup completed successfully!"
+log_info "Server: ${SERVER_NAME} (slug: ${WEBDOCK_SERVER_SLUG}, IP: ${WEBDOCK_SERVER_IP})"
+echo ""
+
+log_step "Starting Claude Code..."
+sleep 1
+clear
+interactive_session "${WEBDOCK_SERVER_IP}" "export PATH=\$HOME/.local/bin:\$PATH && source ~/.zshrc && claude"

manifest.json

@@ -795,6 +795,21 @@
  "region": "zrh"
  },
  "notes": "API-centric cloud platform with regions in ZRH (Zurich), WDC (Washington DC), and LVS (Las Vegas). Granular resource control (CPU/RAM/Disk independently configurable). Uses 'cloudsigma' user for SSH."
+ },
+ "webdock": {
+ "name": "Webdock",
+ "description": "European VPS provider with affordable plans",
+ "url": "https://webdock.io/",
+ "type": "api",
+ "auth": "WEBDOCK_API_TOKEN",
+ "provision_method": "POST /v1/servers",
+ "exec_method": "ssh root@IP",
+ "interactive_method": "ssh -t root@IP",
+ "defaults": {
+ "profile": "webdockmicro",
+ "location": "fi",
+ "image": "ubuntu2404"
+ }
  }
  },
  "matrix": {
@@ -1337,6 +1352,21 @@
  "cloudsigma/opencode": "missing",
  "cloudsigma/plandex": "missing",
  "cloudsigma/kilocode": "missing",
- "cloudsigma/continue": "implemented"
+ "cloudsigma/continue": "implemented",
+ "webdock/claude": "implemented",
+ "webdock/openclaw": "missing",
+ "webdock/nanoclaw": "missing",
+ "webdock/aider": "implemented",
+ "webdock/goose": "missing",
+ "webdock/codex": "missing",
+ "webdock/interpreter": "missing",
+ "webdock/gemini": "missing",
+ "webdock/amazonq": "missing",
+ "webdock/cline": "implemented",
+ "webdock/gptme": "missing",
+ "webdock/opencode": "missing",
+ "webdock/plandex": "missing",
+ "webdock/kilocode": "missing",
+ "webdock/continue": "missing"
  }
-}
+}

test/mock.sh

@@ -263,6 +263,7 @@ _strip_api_base() {
  https://cloudapi.atlantic.net/*) ENDPOINT=$(echo "$URL" | sed 's|https://cloudapi.atlantic.net/\?||') ;;
  https://invapi.hostkey.com*) ENDPOINT="${URL#https://invapi.hostkey.com}" ;;
  https://*.cloudsigma.com/api/2.0*) ENDPOINT=$(echo "$URL" | sed 's|https://[^/]*.cloudsigma.com/api/2.0||') ;;
+ https://api.webdock.io/v1*) ENDPOINT="${URL#https://api.webdock.io/v1}" ;;
  esac
  EP_CLEAN=$(echo "$ENDPOINT" | sed 's|?.*||')
 }
@@ -288,6 +289,7 @@ _validate_body() {
  vultr) case "$EP_CLEAN" in /instances) _check_fields "label region plan os_id" ;; esac ;;
  linode) case "$EP_CLEAN" in /linode/instances) _check_fields "label region type image" ;; esac ;;
  civo) case "$EP_CLEAN" in /instances) _check_fields "hostname size region" ;; esac ;;
+ webdock) case "$EP_CLEAN" in /servers) _check_fields "name slug locationId profileSlug imageSlug" ;; esac ;;
  esac
 }
 

test/record.sh

@@ -31,7 +31,7 @@ ERRORS=0
 PROMPT_FOR_CREDS=true
 
 # All clouds with REST APIs that we can record from
-ALL_RECORDABLE_CLOUDS="hetzner digitalocean vultr linode lambda civo upcloud binarylane ovh scaleway genesiscloud kamatera latitude hyperstack atlanticnet hostkey cloudsigma"
+ALL_RECORDABLE_CLOUDS="hetzner digitalocean vultr linode lambda civo upcloud binarylane ovh scaleway genesiscloud kamatera latitude hyperstack atlanticnet hostkey cloudsigma webdock"
 
 # --- Endpoint registry ---
 # Format: "fixture_name:endpoint"
@@ -141,6 +141,14 @@ get_endpoints() {
  "keypairs:/keypairs/" \
  "servers:/servers/"
  ;;
+ webdock)
+ printf '%s\n' \
+ "account:/account" \
+ "publicKeys:/account/publicKeys" \
+ "servers:/servers" \
+ "profiles:/profiles" \
+ "locations:/locations"
+ ;;
  esac
 }
 
@@ -165,6 +173,7 @@ get_auth_env_var() {
  atlanticnet) printf "ATLANTICNET_API_KEY" ;;
  hostkey) printf "HOSTKEY_API_KEY" ;;
  cloudsigma) printf "CLOUDSIGMA_EMAIL" ;;
+ webdock) printf "WEBDOCK_API_TOKEN" ;;
  esac
 }
 
@@ -399,6 +408,7 @@ call_api() {
  atlanticnet) atlanticnet_api "$endpoint" ;;
  hostkey) hostkey_api "$endpoint" ;;
  cloudsigma) cloudsigma_api GET "$endpoint" ;;
+ webdock) webdock_api GET "$endpoint" ;;
  esac
 }
 
@@ -444,6 +454,9 @@ elif cloud == 'hostkey':
 elif cloud == 'cloudsigma':
  # CloudSigma returns error objects with 'error_message', 'error_type', etc
  sys.exit(0 if 'error_message' in d or 'error_type' in d else 1)
+elif cloud == 'webdock':
+ # Webdock returns error objects with 'message' field
+ sys.exit(0 if 'message' in d and len(d) <= 3 and not any(k in d for k in ('slug','name','status','ipv4')) else 1)
 else:
  sys.exit(1)
 " "$cloud" 2>/dev/null
@@ -822,6 +835,12 @@ _live_cloudsigma() {
  return 0
 }
 
+_live_webdock() {
+ local fixture_dir="$1"
+ printf '%b\n' " ${YELLOW}skip${NC} Webdock live test (not implemented yet)" >&2
+ return 0
+}
+
 # --- Record one cloud ---
 # Check credentials and prompt if needed; returns 1 to skip this cloud
 _record_ensure_credentials() {

webdock/README.md

@@ -0,0 +1,134 @@
+# Webdock
+
+Webdock is a European VPS provider offering affordable cloud servers with API access.
+
+## Features
+
+- **REST API**: Full-featured API for server management
+- **Affordable pricing**: Starting from €2.15/month (Intel Xeon) or €4.30/month (AMD EPYC)
+- **Multiple locations**: Data centers in Europe (Finland, Netherlands, UK)
+- **Developer-friendly**: Free API, automated backups, free SSL, 1-click deployments
+- **SSH access**: Full root SSH access to all servers
+- **GDPR compliant**: European data protection standards
+
+## Authentication
+
+Set your Webdock API token as an environment variable:
+
+```bash
+export WEBDOCK_API_TOKEN="your-api-token-here"
+```
+
+To obtain an API token:
+1. Log in to [https://my.webdock.io](https://my.webdock.io)
+2. Go to Account Area > API & Integrations
+3. Generate a new API key
+
+The token will be automatically saved to `~/.config/spawn/webdock.json` for future use.
+
+## Usage
+
+Launch Claude Code on a Webdock server:
+
+```bash
+bash webdock/claude.sh
+```
+
+Or use the CLI:
+
+```bash
+spawn run webdock claude
+```
+
+## Available Scripts
+
+- `claude.sh` — Claude Code (Anthropic's CLI coding agent)
+- `cline.sh` — Cline (AI pair programming in your editor)
+- `aider.sh` — Aider (AI pair programming in the terminal)
+
+## Configuration
+
+### Server Profile
+
+Set the server profile (hardware tier) via environment variable:
+
+```bash
+export WEBDOCK_PROFILE="webdockmicro" # Default
+```
+
+Available profiles:
+- `webdockmicro` — 1 vCPU, 1GB RAM, 25GB SSD (€2.15-4.30/mo)
+- `webdocksmall` — 1 vCPU, 2GB RAM, 50GB SSD
+- `webdockmedium` — 2 vCPU, 4GB RAM, 80GB SSD
+- `webdocklarge` — 4 vCPU, 8GB RAM, 160GB SSD
+- `webdockxl` — 6 vCPU, 16GB RAM, 320GB SSD
+
+Check [Webdock pricing](https://webdock.io/en/pricing) for the full list and current prices.
+
+### Location
+
+Set the server location via environment variable:
+
+```bash
+export WEBDOCK_LOCATION="fi" # Default (Finland)
+```
+
+Available locations:
+- `fi` — Finland (Helsinki)
+- `nl` — Netherlands (Amsterdam)
+- `uk` — United Kingdom (London)
+
+### Image
+
+Set the OS image via environment variable:
+
+```bash
+export WEBDOCK_IMAGE="ubuntu2404" # Default
+```
+
+Available images include Ubuntu, Debian, and various pre-configured stacks (LEMP, WordPress, etc.).
+Check the Webdock control panel for the full list of available images.
+
+### Server Name
+
+Set a custom server name:
+
+```bash
+export WEBDOCK_SERVER_NAME="my-ai-server"
+```
+
+If not set, you'll be prompted to enter one.
+
+## How It Works
+
+1. **Authenticate**: Validates your API token with Webdock
+2. **SSH Key**: Ensures your SSH key is registered (generates ed25519 key if needed)
+3. **Provision**: Creates a new server with the specified profile, location, and image
+4. **Wait**: Polls until the server is online and SSH-ready
+5. **Setup**: Installs the agent and configures OpenRouter API credentials
+6. **Launch**: Drops you into an interactive session with the agent
+
+## Cleanup
+
+Servers persist after the script exits. To destroy a server:
+
+```bash
+# Using the Webdock API
+curl -X DELETE "https://api.webdock.io/v1/servers/SERVER_SLUG" \
+ -H "Authorization: Bearer $WEBDOCK_API_TOKEN"
+```
+
+Or delete from the Webdock control panel: https://my.webdock.io/servers
+
+## Limitations
+
+- Webdock is primarily European-focused (data centers in EU only)
+- Profile availability may vary by location
+- Server creation can take 1-3 minutes depending on load
+
+## Links
+
+- Website: https://webdock.io
+- API Documentation: https://api.webdock.io/v1
+- Control Panel: https://my.webdock.io
+- Pricing: https://webdock.io/en/pricing

webdock/aider.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+# shellcheck source=webdock/lib/common.sh
+if [[ -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+ source "${SCRIPT_DIR}/lib/common.sh"
+else
+ eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/webdock/lib/common.sh)"
+fi
+
+log_info "Aider on Webdock"
+echo ""
+
+ensure_webdock_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "${SERVER_NAME}"
+verify_server_connectivity "${WEBDOCK_SERVER_IP}"
+wait_for_cloud_init "${WEBDOCK_SERVER_IP}" 60
+
+log_step "Installing Aider..."
+run_server "${WEBDOCK_SERVER_IP}" "pip install aider-chat 2>/dev/null || pip3 install aider-chat"
+log_info "Aider installed"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+MODEL_ID=$(get_model_id_interactive "openrouter/auto" "Aider") || exit 1
+
+log_step "Setting up environment variables..."
+inject_env_vars_ssh "${WEBDOCK_SERVER_IP}" upload_file run_server \
+ "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}"
+
+echo ""
+log_info "Webdock server setup completed successfully!"
+log_info "Server: ${SERVER_NAME} (slug: ${WEBDOCK_SERVER_SLUG}, IP: ${WEBDOCK_SERVER_IP})"
+echo ""
+
+log_step "Starting Aider..."
+sleep 1
+clear
+interactive_session "${WEBDOCK_SERVER_IP}" "source ~/.zshrc && aider --model openrouter/${MODEL_ID}"

webdock/claude.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+# shellcheck source=webdock/lib/common.sh
+if [[ -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+ source "${SCRIPT_DIR}/lib/common.sh"
+else
+ eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/webdock/lib/common.sh)"
+fi
+
+log_info "Claude Code on Webdock"
+echo ""
+
+ensure_webdock_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "${SERVER_NAME}"
+verify_server_connectivity "${WEBDOCK_SERVER_IP}"
+wait_for_cloud_init "${WEBDOCK_SERVER_IP}" 60
+
+log_step "Verifying Claude Code installation..."
+if ! run_server "${WEBDOCK_SERVER_IP}" "export PATH=\$HOME/.local/bin:\$PATH && command -v claude" >/dev/null 2>&1; then
+ log_step "Claude Code not found, installing manually..."
+ run_server "${WEBDOCK_SERVER_IP}" "curl -fsSL https://claude.ai/install.sh | bash"
+fi
+log_info "Claude Code is installed"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+log_step "Setting up environment variables..."
+inject_env_vars_ssh "${WEBDOCK_SERVER_IP}" upload_file run_server \
+ "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}" \
+ "ANTHROPIC_BASE_URL=https://openrouter.ai/api" \
+ "ANTHROPIC_AUTH_TOKEN=${OPENROUTER_API_KEY}" \
+ "ANTHROPIC_API_KEY=" \
+ "CLAUDE_CODE_SKIP_ONBOARDING=1" \
+ "CLAUDE_CODE_ENABLE_TELEMETRY=0"
+
+setup_claude_code_config "${OPENROUTER_API_KEY}" \
+ "upload_file ${WEBDOCK_SERVER_IP}" \
+ "run_server ${WEBDOCK_SERVER_IP}"
+
+echo ""
+log_info "Webdock server setup completed successfully!"
+log_info "Server: ${SERVER_NAME} (slug: ${WEBDOCK_SERVER_SLUG}, IP: ${WEBDOCK_SERVER_IP})"
+echo ""
+
+log_step "Starting Claude Code..."
+sleep 1
+clear
+interactive_session "${WEBDOCK_SERVER_IP}" "export PATH=\$HOME/.local/bin:\$PATH && source ~/.zshrc && claude"

manifest.json

@@ -795,6 +795,21 @@
  "region": "zrh"
  },
  "notes": "API-centric cloud platform with regions in ZRH (Zurich), WDC (Washington DC), and LVS (Las Vegas). Granular resource control (CPU/RAM/Disk independently configurable). Uses 'cloudsigma' user for SSH."
+ },
+ "webdock": {
+ "name": "Webdock",
+ "description": "European VPS provider with affordable plans",
+ "url": "https://webdock.io/",
+ "type": "api",
+ "auth": "WEBDOCK_API_TOKEN",
+ "provision_method": "POST /v1/servers",
+ "exec_method": "ssh root@IP",
+ "interactive_method": "ssh -t root@IP",
+ "defaults": {
+ "profile": "webdockmicro",
+ "location": "fi",
+ "image": "ubuntu2404"
+ }
  }
  },
  "matrix": {
@@ -1337,6 +1352,21 @@
  "cloudsigma/opencode": "missing",
  "cloudsigma/plandex": "missing",
  "cloudsigma/kilocode": "missing",
- "cloudsigma/continue": "implemented"
+ "cloudsigma/continue": "implemented",
+ "webdock/claude": "implemented",
+ "webdock/openclaw": "missing",
+ "webdock/nanoclaw": "missing",
+ "webdock/aider": "implemented",
+ "webdock/goose": "missing",
+ "webdock/codex": "missing",
+ "webdock/interpreter": "missing",
+ "webdock/gemini": "missing",
+ "webdock/amazonq": "missing",
+ "webdock/cline": "implemented",
+ "webdock/gptme": "missing",
+ "webdock/opencode": "missing",
+ "webdock/plandex": "missing",
+ "webdock/kilocode": "missing",
+ "webdock/continue": "missing"
  }
-}
+}

test/mock.sh

@@ -263,6 +263,7 @@ _strip_api_base() {
  https://cloudapi.atlantic.net/*) ENDPOINT=$(echo "$URL" | sed 's|https://cloudapi.atlantic.net/\?||') ;;
  https://invapi.hostkey.com*) ENDPOINT="${URL#https://invapi.hostkey.com}" ;;
  https://*.cloudsigma.com/api/2.0*) ENDPOINT=$(echo "$URL" | sed 's|https://[^/]*.cloudsigma.com/api/2.0||') ;;
+ https://api.webdock.io/v1*) ENDPOINT="${URL#https://api.webdock.io/v1}" ;;
  esac
  EP_CLEAN=$(echo "$ENDPOINT" | sed 's|?.*||')
 }
@@ -288,6 +289,7 @@ _validate_body() {
  vultr) case "$EP_CLEAN" in /instances) _check_fields "label region plan os_id" ;; esac ;;
  linode) case "$EP_CLEAN" in /linode/instances) _check_fields "label region type image" ;; esac ;;
  civo) case "$EP_CLEAN" in /instances) _check_fields "hostname size region" ;; esac ;;
+ webdock) case "$EP_CLEAN" in /servers) _check_fields "name slug locationId profileSlug imageSlug" ;; esac ;;
  esac
 }
 

test/record.sh

@@ -31,7 +31,7 @@ ERRORS=0
 PROMPT_FOR_CREDS=true
 
 # All clouds with REST APIs that we can record from
-ALL_RECORDABLE_CLOUDS="hetzner digitalocean vultr linode lambda civo upcloud binarylane ovh scaleway genesiscloud kamatera latitude hyperstack atlanticnet hostkey cloudsigma"
+ALL_RECORDABLE_CLOUDS="hetzner digitalocean vultr linode lambda civo upcloud binarylane ovh scaleway genesiscloud kamatera latitude hyperstack atlanticnet hostkey cloudsigma webdock"
 
 # --- Endpoint registry ---
 # Format: "fixture_name:endpoint"
@@ -141,6 +141,14 @@ get_endpoints() {
  "keypairs:/keypairs/" \
  "servers:/servers/"
  ;;
+ webdock)
+ printf '%s\n' \
+ "account:/account" \
+ "publicKeys:/account/publicKeys" \
+ "servers:/servers" \
+ "profiles:/profiles" \
+ "locations:/locations"
+ ;;
  esac
 }
 
@@ -165,6 +173,7 @@ get_auth_env_var() {
  atlanticnet) printf "ATLANTICNET_API_KEY" ;;
  hostkey) printf "HOSTKEY_API_KEY" ;;
  cloudsigma) printf "CLOUDSIGMA_EMAIL" ;;
+ webdock) printf "WEBDOCK_API_TOKEN" ;;
  esac
 }
 
@@ -399,6 +408,7 @@ call_api() {
  atlanticnet) atlanticnet_api "$endpoint" ;;
  hostkey) hostkey_api "$endpoint" ;;
  cloudsigma) cloudsigma_api GET "$endpoint" ;;
+ webdock) webdock_api GET "$endpoint" ;;
  esac
 }
 
@@ -444,6 +454,9 @@ elif cloud == 'hostkey':
 elif cloud == 'cloudsigma':
  # CloudSigma returns error objects with 'error_message', 'error_type', etc
  sys.exit(0 if 'error_message' in d or 'error_type' in d else 1)
+elif cloud == 'webdock':
+ # Webdock returns error objects with 'message' field
+ sys.exit(0 if 'message' in d and len(d) <= 3 and not any(k in d for k in ('slug','name','status','ipv4')) else 1)
 else:
  sys.exit(1)
 " "$cloud" 2>/dev/null
@@ -822,6 +835,12 @@ _live_cloudsigma() {
  return 0
 }
 
+_live_webdock() {
+ local fixture_dir="$1"
+ printf '%b\n' " ${YELLOW}skip${NC} Webdock live test (not implemented yet)" >&2
+ return 0
+}
+
 # --- Record one cloud ---
 # Check credentials and prompt if needed; returns 1 to skip this cloud
 _record_ensure_credentials() {

webdock/README.md

@@ -0,0 +1,134 @@
+# Webdock
+
+Webdock is a European VPS provider offering affordable cloud servers with API access.
+
+## Features
+
+- **REST API**: Full-featured API for server management
+- **Affordable pricing**: Starting from €2.15/month (Intel Xeon) or €4.30/month (AMD EPYC)
+- **Multiple locations**: Data centers in Europe (Finland, Netherlands, UK)
+- **Developer-friendly**: Free API, automated backups, free SSL, 1-click deployments
+- **SSH access**: Full root SSH access to all servers
+- **GDPR compliant**: European data protection standards
+
+## Authentication
+
+Set your Webdock API token as an environment variable:
+
+```bash
+export WEBDOCK_API_TOKEN="your-api-token-here"
+```
+
+To obtain an API token:
+1. Log in to [https://my.webdock.io](https://my.webdock.io)
+2. Go to Account Area > API & Integrations
+3. Generate a new API key
+
+The token will be automatically saved to `~/.config/spawn/webdock.json` for future use.
+
+## Usage
+
+Launch Claude Code on a Webdock server:
+
+```bash
+bash webdock/claude.sh
+```
+
+Or use the CLI:
+
+```bash
+spawn run webdock claude
+```
+
+## Available Scripts
+
+- `claude.sh` — Claude Code (Anthropic's CLI coding agent)
+- `cline.sh` — Cline (AI pair programming in your editor)
+- `aider.sh` — Aider (AI pair programming in the terminal)
+
+## Configuration
+
+### Server Profile
+
+Set the server profile (hardware tier) via environment variable:
+
+```bash
+export WEBDOCK_PROFILE="webdockmicro" # Default
+```
+
+Available profiles:
+- `webdockmicro` — 1 vCPU, 1GB RAM, 25GB SSD (€2.15-4.30/mo)
+- `webdocksmall` — 1 vCPU, 2GB RAM, 50GB SSD
+- `webdockmedium` — 2 vCPU, 4GB RAM, 80GB SSD
+- `webdocklarge` — 4 vCPU, 8GB RAM, 160GB SSD
+- `webdockxl` — 6 vCPU, 16GB RAM, 320GB SSD
+
+Check [Webdock pricing](https://webdock.io/en/pricing) for the full list and current prices.
+
+### Location
+
+Set the server location via environment variable:
+
+```bash
+export WEBDOCK_LOCATION="fi" # Default (Finland)
+```
+
+Available locations:
+- `fi` — Finland (Helsinki)
+- `nl` — Netherlands (Amsterdam)
+- `uk` — United Kingdom (London)
+
+### Image
+
+Set the OS image via environment variable:
+
+```bash
+export WEBDOCK_IMAGE="ubuntu2404" # Default
+```
+
+Available images include Ubuntu, Debian, and various pre-configured stacks (LEMP, WordPress, etc.).
+Check the Webdock control panel for the full list of available images.
+
+### Server Name
+
+Set a custom server name:
+
+```bash
+export WEBDOCK_SERVER_NAME="my-ai-server"
+```
+
+If not set, you'll be prompted to enter one.
+
+## How It Works
+
+1. **Authenticate**: Validates your API token with Webdock
+2. **SSH Key**: Ensures your SSH key is registered (generates ed25519 key if needed)
+3. **Provision**: Creates a new server with the specified profile, location, and image
+4. **Wait**: Polls until the server is online and SSH-ready
+5. **Setup**: Installs the agent and configures OpenRouter API credentials
+6. **Launch**: Drops you into an interactive session with the agent
+
+## Cleanup
+
+Servers persist after the script exits. To destroy a server:
+
+```bash
+# Using the Webdock API
+curl -X DELETE "https://api.webdock.io/v1/servers/SERVER_SLUG" \
+ -H "Authorization: Bearer $WEBDOCK_API_TOKEN"
+```
+
+Or delete from the Webdock control panel: https://my.webdock.io/servers
+
+## Limitations
+
+- Webdock is primarily European-focused (data centers in EU only)
+- Profile availability may vary by location
+- Server creation can take 1-3 minutes depending on load
+
+## Links
+
+- Website: https://webdock.io
+- API Documentation: https://api.webdock.io/v1
+- Control Panel: https://my.webdock.io
+- Pricing: https://webdock.io/en/pricing

webdock/aider.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+# shellcheck source=webdock/lib/common.sh
+if [[ -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+ source "${SCRIPT_DIR}/lib/common.sh"
+else
+ eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/webdock/lib/common.sh)"
+fi
+
+log_info "Aider on Webdock"
+echo ""
+
+ensure_webdock_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "${SERVER_NAME}"
+verify_server_connectivity "${WEBDOCK_SERVER_IP}"
+wait_for_cloud_init "${WEBDOCK_SERVER_IP}" 60
+
+log_step "Installing Aider..."
+run_server "${WEBDOCK_SERVER_IP}" "pip install aider-chat 2>/dev/null || pip3 install aider-chat"
+log_info "Aider installed"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+MODEL_ID=$(get_model_id_interactive "openrouter/auto" "Aider") || exit 1
+
+log_step "Setting up environment variables..."
+inject_env_vars_ssh "${WEBDOCK_SERVER_IP}" upload_file run_server \
+ "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}"
+
+echo ""
+log_info "Webdock server setup completed successfully!"
+log_info "Server: ${SERVER_NAME} (slug: ${WEBDOCK_SERVER_SLUG}, IP: ${WEBDOCK_SERVER_IP})"
+echo ""
+
+log_step "Starting Aider..."
+sleep 1
+clear
+interactive_session "${WEBDOCK_SERVER_IP}" "source ~/.zshrc && aider --model openrouter/${MODEL_ID}"

webdock/claude.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+# shellcheck source=webdock/lib/common.sh
+if [[ -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+ source "${SCRIPT_DIR}/lib/common.sh"
+else
+ eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/webdock/lib/common.sh)"
+fi
+
+log_info "Claude Code on Webdock"
+echo ""
+
+ensure_webdock_token
+ensure_ssh_key
+
+SERVER_NAME=$(get_server_name)
+create_server "${SERVER_NAME}"
+verify_server_connectivity "${WEBDOCK_SERVER_IP}"
+wait_for_cloud_init "${WEBDOCK_SERVER_IP}" 60
+
+log_step "Verifying Claude Code installation..."
+if ! run_server "${WEBDOCK_SERVER_IP}" "export PATH=\$HOME/.local/bin:\$PATH && command -v claude" >/dev/null 2>&1; then
+ log_step "Claude Code not found, installing manually..."
+ run_server "${WEBDOCK_SERVER_IP}" "curl -fsSL https://claude.ai/install.sh | bash"
+fi
+log_info "Claude Code is installed"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+ log_info "Using OpenRouter API key from environment"
+else
+ OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+log_step "Setting up environment variables..."
+inject_env_vars_ssh "${WEBDOCK_SERVER_IP}" upload_file run_server \
+ "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}" \
+ "ANTHROPIC_BASE_URL=https://openrouter.ai/api" \
+ "ANTHROPIC_AUTH_TOKEN=${OPENROUTER_API_KEY}" \
+ "ANTHROPIC_API_KEY=" \
+ "CLAUDE_CODE_SKIP_ONBOARDING=1" \
+ "CLAUDE_CODE_ENABLE_TELEMETRY=0"
+
+setup_claude_code_config "${OPENROUTER_API_KEY}" \
+ "upload_file ${WEBDOCK_SERVER_IP}" \
+ "run_server ${WEBDOCK_SERVER_IP}"
+
+echo ""
+log_info "Webdock server setup completed successfully!"
+log_info "Server: ${SERVER_NAME} (slug: ${WEBDOCK_SERVER_SLUG}, IP: ${WEBDOCK_SERVER_IP})"
+echo ""
+
+log_step "Starting Claude Code..."
+sleep 1
+clear
+interactive_session "${WEBDOCK_SERVER_IP}" "export PATH=\$HOME/.local/bin:\$PATH && source ~/.zshrc && claude"