mirror of
https://github.com/OpenRouterTeam/spawn.git
synced 2026-05-05 15:40:47 +00:00
7b3ad8fa75
Add Hostinger VPS hosting as a new cloud provider with REST API provisioning and cloud-init support. Budget VPS starting at $4.95/mo with hourly billing. Implementation: - hostinger/lib/common.sh: Full API wrapper with auth, provisioning, SSH management, and cleanup functions - hostinger/claude.sh: Claude Code on Hostinger VPS - hostinger/aider.sh: Aider on Hostinger VPS - hostinger/openclaw.sh: OpenClaw on Hostinger VPS - hostinger/README.md: Complete usage documentation Added to manifest.json: - New cloud entry with API details and defaults - 15 matrix entries (hostinger/claude through hostinger/continue) - 3 implemented, 12 marked as "missing" Agent: cloud-scout-2 Co-authored-by: B <6723574+louisgv@users.noreply.github.com>
151 lines
4.3 KiB
Markdown
151 lines
4.3 KiB
Markdown
# Hostinger VPS
|
|
|
|
Hostinger is a budget VPS provider with cloud-init support and REST API provisioning. Starting at $4.95/month for 1 vCPU + 4GB RAM instances with hourly billing.
|
|
|
|
## Quick Start
|
|
|
|
Each script provisions a Hostinger VPS, installs the agent, injects OpenRouter credentials, and drops you into an interactive session.
|
|
|
|
### Claude Code
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/hostinger/claude.sh)
|
|
```
|
|
|
|
### Aider
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/hostinger/aider.sh)
|
|
```
|
|
|
|
### OpenClaw
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/hostinger/openclaw.sh)
|
|
```
|
|
|
|
## Non-Interactive Mode
|
|
|
|
All scripts support non-interactive execution via environment variables:
|
|
|
|
```bash
|
|
export HOSTINGER_API_KEY="your-api-key"
|
|
export HOSTINGER_SERVER_NAME="my-vps"
|
|
export HOSTINGER_PLAN="kvm1" # Optional (default: kvm1)
|
|
export HOSTINGER_LOCATION="eu-central" # Optional (default: eu-central)
|
|
export OPENROUTER_API_KEY="your-key" # Optional (triggers OAuth if unset)
|
|
|
|
bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/hostinger/claude.sh)
|
|
```
|
|
|
|
## Configuration
|
|
|
|
### Authentication
|
|
|
|
Get your Hostinger API key:
|
|
1. Log into hPanel: https://hpanel.hostinger.com/
|
|
2. Click your Profile icon → Account Information
|
|
3. Navigate to API in the sidebar
|
|
4. Click 'Generate token' or 'New token'
|
|
5. Set token name and expiration, then click Generate
|
|
6. Copy the token: `export HOSTINGER_API_KEY=...`
|
|
|
|
The token will be saved to `~/.config/spawn/hostinger.json` for reuse.
|
|
|
|
### VPS Plans
|
|
|
|
Common plans (hourly pricing estimated from monthly):
|
|
- `kvm1`: 1 vCPU, 4GB RAM, 50GB SSD (~$0.0068/hr)
|
|
- `kvm2`: 2 vCPU, 8GB RAM, 100GB SSD (~$0.0137/hr)
|
|
- `kvm4`: 4 vCPU, 16GB RAM, 200GB SSD (~$0.0274/hr)
|
|
|
|
The script will show available plans if `HOSTINGER_PLAN` is not set.
|
|
|
|
### Locations
|
|
|
|
Available regions:
|
|
- `eu-central` (default) - Europe, Central
|
|
- `us-east` - United States, East Coast
|
|
- `asia-pacific` - Asia Pacific
|
|
|
|
The script will show available locations if `HOSTINGER_LOCATION` is not set.
|
|
|
|
### OS Templates
|
|
|
|
Default: `ubuntu-24.04`
|
|
|
|
Override with:
|
|
```bash
|
|
export HOSTINGER_OS_TEMPLATE="ubuntu-22.04"
|
|
```
|
|
|
|
## Environment Variables
|
|
|
|
| Variable | Description | Default |
|
|
|----------|-------------|---------|
|
|
| `HOSTINGER_API_KEY` | API authentication token | Required (prompted if unset) |
|
|
| `HOSTINGER_SERVER_NAME` | VPS hostname | Required (prompted if unset) |
|
|
| `HOSTINGER_PLAN` | VPS plan ID | `kvm1` (interactive picker if unset) |
|
|
| `HOSTINGER_LOCATION` | Region/datacenter | `eu-central` (interactive picker if unset) |
|
|
| `HOSTINGER_OS_TEMPLATE` | Operating system | `ubuntu-24.04` |
|
|
| `OPENROUTER_API_KEY` | OpenRouter API key | OAuth flow if unset |
|
|
|
|
## SSH Key Management
|
|
|
|
The scripts automatically:
|
|
1. Generate `~/.ssh/spawn_ed25519` keypair if missing
|
|
2. Register the public key with Hostinger API
|
|
3. Wait for SSH connectivity after VPS creation
|
|
|
|
To use an existing key:
|
|
```bash
|
|
export SPAWN_SSH_KEY_PATH="$HOME/.ssh/id_ed25519"
|
|
```
|
|
|
|
## Management
|
|
|
|
### List VPSs
|
|
|
|
```bash
|
|
source <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/hostinger/lib/common.sh)
|
|
ensure_hostinger_token
|
|
list_servers
|
|
```
|
|
|
|
### Destroy VPS
|
|
|
|
```bash
|
|
source <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/hostinger/lib/common.sh)
|
|
ensure_hostinger_token
|
|
destroy_server "12345" # Replace with VPS ID from list_servers
|
|
```
|
|
|
|
## Cloud-Init Support
|
|
|
|
All Hostinger VPS instances come with cloud-init pre-installed. The scripts inject userdata to:
|
|
- Install bun (JavaScript runtime)
|
|
- Install common tools (git, curl, zsh, etc.)
|
|
- Configure shell environment
|
|
- Set up OpenRouter API key injection
|
|
|
|
## Pricing
|
|
|
|
- Pay-per-hour billing (billed monthly based on usage)
|
|
- Starting at $4.95/month for kvm1 plan
|
|
- No bandwidth charges
|
|
- No setup fees
|
|
|
|
## API Documentation
|
|
|
|
Hostinger VPS API base: `https://api.hostinger.com/vps/v1`
|
|
|
|
Common endpoints:
|
|
- `GET /virtual-machines` - List VPSs
|
|
- `POST /virtual-machines` - Create VPS
|
|
- `DELETE /virtual-machines/{id}` - Destroy VPS
|
|
- `GET /ssh-keys` - List SSH keys
|
|
- `POST /ssh-keys` - Register SSH key
|
|
- `GET /plans` - List available plans
|
|
- `GET /locations` - List available regions
|
|
|
|
Authentication: Bearer token via `Authorization` header
|