spawn/koyeb
A 4d67d08487
ux: improve service deployment error messages for Koyeb and Northflank (#1093)
Enhanced error messages when service deployment fails or times out on Koyeb
and Northflank providers to give users more actionable debugging information.

Changes:
- Koyeb: Added specific debugging steps including CLI command and region/instance type suggestions
- Koyeb: Clarified "status" in error message to show exact failure status
- Koyeb: Added "Application error in startup command" as a common cause
- Northflank: Added last known status to timeout error message
- Northflank: Restructured error to show "Possible causes" and "Debugging steps" sections
- Northflank: Clarified that service might still be starting to prevent premature retries

These improvements help users quickly identify and resolve deployment issues
without needing to escalate to support.

Agent: ux-engineer

Co-authored-by: Spawn Refactor Service <refactor@spawn.service>
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-14 05:10:07 -05:00
..
lib ux: improve service deployment error messages for Koyeb and Northflank (#1093) 2026-02-14 05:10:07 -05:00
aider.sh fix: use log_step (cyan) for progress messages instead of log_warn (yellow) (#534) 2026-02-11 14:37:43 -08:00
amazonq.sh fix: use log_step (cyan) for progress messages instead of log_warn (yellow) (#534) 2026-02-11 14:37:43 -08:00
claude.sh fix: add actionable guidance to agent installation failures across 126 scripts (#966) 2026-02-13 10:14:03 -08:00
cline.sh fix: use log_step (cyan) for progress messages instead of log_warn (yellow) (#534) 2026-02-11 14:37:43 -08:00
codex.sh fix: use log_step (cyan) for progress messages instead of log_warn (yellow) (#534) 2026-02-11 14:37:43 -08:00
continue.sh fix: use log_step (cyan) for progress messages instead of log_warn (yellow) (#534) 2026-02-11 14:37:43 -08:00
gemini.sh fix: use log_step (cyan) for progress messages instead of log_warn (yellow) (#534) 2026-02-11 14:37:43 -08:00
goose.sh fix: use log_step (cyan) for progress messages instead of log_warn (yellow) (#534) 2026-02-11 14:37:43 -08:00
gptme.sh fix: use log_step (cyan) for progress messages instead of log_warn (yellow) (#534) 2026-02-11 14:37:43 -08:00
interpreter.sh fix: use log_step (cyan) for progress messages instead of log_warn (yellow) (#534) 2026-02-11 14:37:43 -08:00
kilocode.sh fix: use log_step (cyan) for progress messages instead of log_warn (yellow) (#534) 2026-02-11 14:37:43 -08:00
nanoclaw.sh fix(security): prevent API key injection in koyeb/nanoclaw.sh and harden remote temp file permissions (#1049) 2026-02-13 23:37:25 -05:00
openclaw.sh fix: remove double-quoting in openclaw.json config generation (#547) 2026-02-11 15:38:01 -08:00
opencode.sh fix: use log_step (cyan) for progress messages instead of log_warn (yellow) (#534) 2026-02-11 14:37:43 -08:00
plandex.sh fix: use log_step (cyan) for progress messages instead of log_warn (yellow) (#534) 2026-02-11 14:37:43 -08:00
README.md refactor: replace Python with jq in Hetzner lib, fix /lab → /labs URLs (#827) 2026-02-12 23:14:11 -08:00

Koyeb

Koyeb serverless container platform via CLI. Koyeb

Agents

Claude Code

bash <(curl -fsSL https://openrouter.ai/labs/spawn/koyeb/claude.sh)

OpenClaw

bash <(curl -fsSL https://openrouter.ai/labs/spawn/koyeb/openclaw.sh)

Aider

bash <(curl -fsSL https://openrouter.ai/labs/spawn/koyeb/aider.sh)

Non-Interactive Mode

KOYEB_TOKEN=your-token \
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
  bash <(curl -fsSL https://openrouter.ai/labs/spawn/koyeb/claude.sh)

Environment Variables

Variable Description Default
KOYEB_TOKEN Koyeb API token (prompted)
KOYEB_REGION Deployment region was (Washington D.C.)
KOYEB_INSTANCE_TYPE Instance type nano
OPENROUTER_API_KEY OpenRouter API key (OAuth or prompted)

Authentication

Get your Koyeb API token at: https://app.koyeb.com/account/api

Features

  • Serverless container platform with per-second billing
  • Free tier available (no credit card required)
  • Fast deployment times
  • Automatic scaling
  • Global deployment regions