Skip to main content
This walks the whole path: account → API key → CLI → project → GitHub → live app → logs. Every step past the first two also works through the API and MCP.

1. Create your account

Sign up at korve.dev/register. Korve is paid-only: after verifying your email you’ll add a card on file — the platform minimum is $5/month, credited against usage. Nothing provisions until billing is active.

2. Mint an API key

In the dashboard, open your organization’s settings and create an API key under API keys. Pick a role:
  • admin — can create projects, set environment variables, manage domains.
  • member — read-mostly: deploys, logs, usage.
The secret (korve_...) is shown exactly once — store it securely. Key management is deliberately session-only: a leaked key can never mint, list, or revoke keys, touch billing, or manage members.

3. Install the CLI and log in

See Install the CLI for platforms and details.

4. Connect GitHub

Install the Korve GitHub App on the repository you want to deploy: https://github.com/apps/korve-dev/installations/new Once your project exists (next step), you can verify access at any time with korve projects check-repo acme/storefront — if the platform can’t reach the repo, the answer includes this install URL.

5. Create the project (and first deploy)

The slug becomes the public URL — https://storefront.korve.app — and is permanent. Passing --repo queues the first deploy immediately and enables push-to-deploy. Link the directory so later commands don’t need --project:

6. Push → live

Every push to the production branch (default main) deploys automatically, and every pull request gets its own preview environment. To deploy by hand and follow the build to completion:
The command streams status transitions (queued → building → deploying → ready) and prints your live URL.

7. Watch it run

If a deploy fails, ask the platform agent what went wrong:

Next