Skip to content

Guv documentation

View as Markdown

Deploy apps, databases and AI-built projects on UK infrastructure, safely, with caps on what you spend.

Guv is a hosting platform for web apps, APIs, workers, cron jobs and databases. It runs in London, bills in pounds, and is designed so that people who have never configured a server, and the AI agents they work with, can ship safely.

  • Quickstart: your first deploy in about three minutes.
  • How Guv fits together: workspaces, projects, environments and services.
  • Deploy with your AI: connect Claude Code, Cursor or Codex through MCP, with tokens that cannot touch production without you.
  • Safety Centre: what the A to E grade means and how to raise it.
  • Spend and caps: how billing works and how hard caps protect you.
  • Custom domains: point your own domain at Guv, with certificates handled for you.
  • Moving to Guv: import from Heroku, Railway, Render, Fly or Docker Compose.
  • guv.yaml: every field of the manifest that describes your project as code.
  • CLI: every guv command and its exit codes.
  • API: the same API the dashboard, CLI and MCP server use. There are no hidden endpoints.
  • Error codes: each error, what it means and how to fix it.

Every page here is also available as Markdown: add .md to the address, or use the View as Markdown link under each title. A summary for language models is at /llms.txt, and the whole documentation as one file is at /llms-full.txt.