vrr/spawn
2
0
Fork 0
mirror of https://github.com/OpenRouterTeam/spawn.git synced 2026-05-05 23:50:48 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8
spawn/cherry/README.md
A 004aafaca0
feat: Add Cherry Servers cloud provider with openclaw and goose (#286) 
Add Cherry Servers as a new cloud provider with:
- REST API-based server provisioning
- SSH key management via API
- Full root access to cloud VPS instances
- Hourly billing with no commitments

Implementation includes:
- cherry/lib/common.sh with Cherry Servers API primitives
- cherry/openclaw.sh for OpenClaw deployment
- cherry/goose.sh for Goose deployment
- cherry/README.md with authentication and usage docs
- manifest.json updates (cloud entry + 14 matrix entries)

Agent: cloud-scout

Co-authored-by: B <6723574+louisgv@users.noreply.github.com>
2026-02-10 15:27:23 -08:00

3.1 KiB
Raw Blame History

Cherry Servers

Cherry Servers is a European cloud provider offering bare metal and cloud VPS with full root access, hourly billing, and a REST API.

Authentication

All Cherry Servers scripts require a CHERRY_AUTH_TOKEN environment variable.

Getting your API token

  1. Visit Cherry Servers Portal
  2. Click on your profile in the top right
  3. Navigate to API Tokens
  4. Create a new token or copy an existing one

Setting the token

export CHERRY_AUTH_TOKEN="your-token-here"

Configuration

Optional environment variables:

  • CHERRY_AUTH_TOKEN - API authentication token (required)
  • CHERRY_DEFAULT_PLAN - Server plan (default: cloud_vps_1)
  • CHERRY_DEFAULT_REGION - Deployment region (default: eu_nord_1)
  • CHERRY_DEFAULT_IMAGE - OS image (default: Ubuntu 24.04 64bit)
  • CHERRY_SERVER_NAME - Custom server hostname

Available Plans

Cherry Servers offers various cloud VPS and bare metal plans:

  • cloud_vps_1 - 1 vCPU, 2GB RAM, 40GB SSD (default)
  • cloud_vps_2 - 2 vCPU, 4GB RAM, 80GB SSD
  • cloud_vps_3 - 4 vCPU, 8GB RAM, 160GB SSD
  • Bare metal plans available through the API

View all plans: https://portal.cherryservers.com/

Regions

Available regions:

  • eu_nord_1 - Lithuania (default)
  • eu_west_1 - Netherlands
  • us_east_1 - USA East Coast
  • us_west_1 - USA West Coast
  • ap_southeast_1 - Singapore

Usage Examples

OpenClaw on Cherry Servers

export CHERRY_AUTH_TOKEN="your-token"
bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/cherry/openclaw.sh)

Goose on Cherry Servers

export CHERRY_AUTH_TOKEN="your-token"
bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/cherry/goose.sh)

Custom configuration

export CHERRY_AUTH_TOKEN="your-token"
export CHERRY_DEFAULT_PLAN="cloud_vps_2"
export CHERRY_DEFAULT_REGION="us_east_1"
bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/cherry/openclaw.sh)

How it works

  1. Authentication - Validates CHERRY_AUTH_TOKEN with Cherry Servers API
  2. SSH Key - Generates SSH key pair if needed and registers public key
  3. Project - Fetches your default project ID from Cherry Servers account
  4. Provisioning - Creates cloud VPS with specified plan, region, and image
  5. Connectivity - Waits for SSH access and cloud-init completion
  6. Agent Setup - Installs agent, injects OpenRouter credentials, launches interactive session

API Documentation

Pricing

Cherry Servers uses hourly billing with no long-term commitments. Prices vary by plan and region.

View current pricing: https://www.cherryservers.com/pricing

Notes

  • All Cherry Servers instances use root user for SSH access
  • Servers are created with your registered SSH key automatically attached
  • Full root access and IP-KVM available
  • Cloud-init is supported for automated setup
  • Servers can be managed via API, CLI (cherryctl), or web portal