vrr/spawn

mirror of https://github.com/OpenRouterTeam/spawn.git synced 2026-05-05 23:50:48 +00:00

feat: Add Webdock provider support (#1001 )

Implements Webdock cloud provider with full API integration:
- webdock/lib/common.sh with REST API primitives
- claude.sh, cline.sh, aider.sh agent scripts
- Test coverage in test/record.sh and test/mock.sh
- manifest.json updated with cloud entry and matrix
- README.md with usage documentation

Webdock offers affordable European VPS (€2.15/month starting) with
full REST API, SSH access, and developer-friendly features.

Agent: cloud-scout-1

Co-authored-by: A <6723574+louisgv@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>

2026-02-13 13:24:06 -08:00

3.5 KiB

Raw Blame History

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:

export WEBDOCK_API_TOKEN="your-api-token-here"

To obtain an API token:

Log in to https://my.webdock.io
Go to Account Area > API & Integrations
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 webdock/claude.sh

Or use the CLI:

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:

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 for the full list and current prices.

Location

Set the server location via environment variable:

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:

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:

export WEBDOCK_SERVER_NAME="my-ai-server"

If not set, you'll be prompted to enter one.

How It Works

Authenticate: Validates your API token with Webdock
SSH Key: Ensures your SSH key is registered (generates ed25519 key if needed)
Provision: Creates a new server with the specified profile, location, and image
Wait: Polls until the server is online and SSH-ready
Setup: Installs the agent and configures OpenRouter API credentials
Launch: Drops you into an interactive session with the agent

Cleanup

Servers persist after the script exits. To destroy a server:

# 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

3.5 KiB Raw Blame History