Environment Variables

Complete reference of all environment variables used by the package.

Required Variables

Variable	Description	Example
RHDH_VERSION	RHDH version to deploy	"1.5"
INSTALLATION_METHOD	Deployment method	"helm" or "operator"

Auto-Generated Variables

These are set automatically during deployment:

Variable	Description	Set By
K8S_CLUSTER_ROUTER_BASE	OpenShift ingress domain	Global setup
RHDH_BASE_URL	Full RHDH URL	RHDHDeployment

Optional Variables

Variable	Description	Default
CI	Enables auto-cleanup	-
CHART_URL	Custom Helm chart URL	oci://quay.io/rhdh/chart
SKIP_KEYCLOAK_DEPLOYMENT	Skip Keycloak auto-deploy	false

Keycloak Variables

Required when using auth: "keycloak":

Variable	Description
KEYCLOAK_BASE_URL	Keycloak instance URL
KEYCLOAK_REALM	Realm name
KEYCLOAK_CLIENT_ID	OIDC client ID
KEYCLOAK_CLIENT_SECRET	OIDC client secret
KEYCLOAK_METADATA_URL	OIDC discovery URL
KEYCLOAK_LOGIN_REALM	Login realm name
KEYCLOAK_USER_NAME	Default test username
KEYCLOAK_USER_PASSWORD	Default test password

These are automatically set by KeycloakHelper.configureForRHDH().

GitHub Variables

For GitHub integration:

Variable	Description	Required
GITHUB_TOKEN	GitHub personal access token	For API/auth
GH_USER_NAME	GitHub username	For login
GH_USER_PASSWORD	GitHub password	For login
GH_2FA_SECRET	2FA secret for OTP	For login

Custom Variables

Use in configuration files:

# tests/config/app-config-rhdh.yaml
myPlugin:
  apiUrl: ${MY_PLUGIN_API_URL}
  apiKey: ${MY_PLUGIN_API_KEY:-default-key}

# tests/config/rhdh-secrets.yaml
stringData:
  MY_PLUGIN_API_KEY: ${MY_PLUGIN_API_KEY}

Setting Variables

.env File

Create .env in your project root:

RHDH_VERSION="1.5"
INSTALLATION_METHOD="helm"
SKIP_KEYCLOAK_DEPLOYMENT=false

# Secrets
GITHUB_TOKEN=ghp_xxxxx
MY_API_KEY=secret-value

Load with dotenv:

// playwright.config.ts
import dotenv from "dotenv";
dotenv.config({ path: `${import.meta.dirname}/.env` });

CI/CD

Set in your CI pipeline:

# GitHub Actions
env:
  RHDH_VERSION: "1.5"
  INSTALLATION_METHOD: "helm"
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Runtime

Set programmatically:

test.beforeAll(async ({ rhdh }) => {
  process.env.MY_CUSTOM_URL = await rhdh.k8sClient.getRouteLocation(
    rhdh.deploymentConfig.namespace,
    "my-service"
  );

  await rhdh.deploy();
});

Variable Precedence

1. Runtime (process.env)
2. CI/CD environment
3. .env file
4. Default values (${VAR:-default})