mirror of
https://github.com/OpenRouterTeam/spawn.git
synced 2026-05-09 19:49:58 +00:00
004aafaca0
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>
105 lines
3.1 KiB
Markdown
105 lines
3.1 KiB
Markdown
# 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](https://portal.cherryservers.com/)
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
export CHERRY_AUTH_TOKEN="your-token"
|
|
bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/cherry/openclaw.sh)
|
|
```
|
|
|
|
### Goose on Cherry Servers
|
|
|
|
```bash
|
|
export CHERRY_AUTH_TOKEN="your-token"
|
|
bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/cherry/goose.sh)
|
|
```
|
|
|
|
### Custom configuration
|
|
|
|
```bash
|
|
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
|