<!-- Canonical page: https://docs.radforge.dev/reference/environment-variables/ -->

# Environment variables

Hosted CLI commands use two environment variables:

| Variable              | Required                                            | Purpose                                                              |
| --------------------- | --------------------------------------------------- | -------------------------------------------------------------------- |
| `RADFORGE_API_TOKEN`  | For hosted commands and customer mutation execution | Repository-scoped bearer credential. Read only from the environment. |
| `RADFORGE_REMOTE_URL` | When no `--endpoint` is supplied                    | HTTPS origin for the Radforge API.                                   |

An explicit `--endpoint` overrides `RADFORGE_REMOTE_URL`. Never place `RADFORGE_API_TOKEN` in a command argument, URL, repository file, plan artifact, or log.

Development builds may use other internal environment variables. Released CLI binaries do not support them as customer configuration, so they are not listed here.
