spawn/hostinger/README.md

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 <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/hostinger/claude.sh)

Aider

bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/hostinger/aider.sh)

OpenClaw

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:

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:

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:

export SPAWN_SSH_KEY_PATH="$HOME/.ssh/id_ed25519"

Management

List VPSs

source <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/hostinger/lib/common.sh)
ensure_hostinger_token
list_servers

Destroy VPS

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