> Guveno API reference v1.10.0, last updated October 17, 2026. The whole reference is at https://www.guveno.com/llms-full.txt.

## Advanced configuration

Sensible defaults mean most integrations need no configuration. These knobs are here for self-hosting and local development.

### Base URL

By default everything talks to the production API at `https://api.guveno.com/v1`, so you never need to set it. If you run a self-hosted Guveno server (or point at a staging environment), override the base URL. Keep the `/v1` path.

- **SDK**: pass `baseUrl` to the client: `new GuvenoApiClient({ apiKey, baseUrl })`.
- **CLI**: pass `--base-url` on any command, or save it once with `guveno init --base-url ...`.
- **Either**: set the `GUVENO_API_BASE_URL` environment variable.

### Environment variables

- `GUVENO_API_KEY`: the `gv_live_...` key used by the SDK and CLI when no key is passed explicitly.
- `GUVENO_API_BASE_URL`: override the API base URL (defaults to production).
- `GUVENO_ENCRYPTION_PASSWORD`: unlocks your encryption key for create/derive/reveal/sign without an interactive prompt.
- `GUVENO_WALLET_HOME`: directory for the CLI's local config cache (defaults to `~/.guveno`).

Source: https://www.guveno.com/docs/advanced/