Skip to main content

Prerequisites

Install a current Node.js release. The Verglas CLI is published to npm as verglas; npx can run it without a global installation.

1. Log in

The CLI opens the Verglas sign-in flow in your browser and completes the short-lived handoff on localhost:3080. The resulting credential is stored in ~/.verglas/credentials.json with owner-only permissions. For CI, set VERGLAS_API_TOKEN and VERGLAS_ACCOUNT_ID instead of using the browser flow.

2. Create a project

The generated wrangler.jsonc points to the Worker entry module:
Replace src/index.ts with:

3. Run locally

Open the local URL printed by the CLI. Source changes reload the Worker.

4. Deploy

The CLI builds the Worker, uploads its component, and prints the deployed URL. Verglas handles placement and scaling from that point forward.

Next step

Add durable state with a Durable Object, or send events into a Stream and Pipeline.
Use npx verglas whoami to inspect the active account and npx verglas logout to remove the local credential.