Software Template Configuration

Default Environment

The scaffolder's defaultEnvironment configuration allows shared parameters and secrets that are automatically available to all Backstage templates - without requiring each template to declare them individually.

Parameters are defined centrally in backstage *values*.yaml and can be referenced in templates via ${{ environment.parameters.<name> }}. This keeps common values (e.g. organization repositories, default domainName) consistent across all templates.

tip

Currently not available in parameters steps, this only works in steps.

Optional: Secrets are resolved from environment variables and exposed via ${{ environment.secrets.<name> }}

tip

but only during backend action execution. They are never passed to the frontend, and are automatically masked in logs.

Example

scaffolder:
  defaultEnvironment:
    parameters:
      defaultDomainName: 127-0-0-1.nip.io
      defaultRepoName: kubrix
      defaultOrgName: suxess-it
    # secrets:
    #  GITHUB_TOKEN: ${GITHUB_TOKEN}

---