spawn/cherry

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

• API Docs: https://api.cherryservers.com/doc/
• CLI (cherryctl): https://github.com/cherryservers/cherryctl
• Portal: https://portal.cherryservers.com/

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