Configure Authentication

Legacy

Legacy SPGCLI (`spgctl`) authentication: CP_URL, SPG99_TOKEN, and separation of API/database secrets.

Updated: February 4, 2026

Authentication setup for the legacy CLI SPGCLI (spgctl). For new workflows, use Console or direct API access.

Environment variables

  • CP_URL — the base URL of the Control Plane (CP), for example:
export CP_URL="https://<cp-host>"
  • SPG99_TOKEN — the API key (Bearer token):
export SPG99_TOKEN="<api-key>"

CLI uses these values by default; if necessary, you can override them with command flags.

Important

  • The API key must not appear in the application DSN.
  • For PostgreSQL connections, use pg_user / pg_password and <gateway-host>:5432 (see Get Started → Connection Strings).