Skip to main content

Agents environment variables

Reference documentation for Retool Agents environment variables for self-hosted deployments.

Agent environment variables available for use with Self-hosted Retool deployments.

Only configure environment variables when needed. You can configure many environment variables from your organization's Settings rather than directly editing your deployment's configuration file.

Environment variables take effect only once the change is applied to your deployment, and where you set them depends on how Retool was deployed.

  • Terraform blueprints. Set the variable in retool_helm_extra_values in main.tf, then run terraform apply. Editing Helm values directly on a blueprint-managed instance is overwritten by the next apply.
  • Helm. Set the variable in your values.yaml, then run helm upgrade. That command restarts the affected pods as part of applying the new values, so restarting pods without re-running it doesn't pick up the change.
  • Docker Compose. Set the variable in docker.env, then run sudo docker compose up -d.

AGENT_EVALS_S3_ACCESS_KEY_ID​

The Amazon S3 access key ID for running agent evals.

Type string
ConfigurabilityUpdate the deployment's configuration file.
Required Optional
Defaultnull
Examples
AGENT_EVALS_S3_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE

AGENT_EVALS_S3_BUCKET​

The Amazon S3 bucket for running agent evals.

Type string
ConfigurabilityUpdate the deployment's configuration file.
Required Optional
Defaultnull
Examples
AGENT_EVALS_S3_BUCKET=retool-agent-evals

AGENT_EVALS_S3_REGION​

The Amazon S3 region for running agent evals.

Type string
ConfigurabilityUpdate the deployment's configuration file.
Required Optional
Defaultnull
Examples
AGENT_EVALS_S3_REGION=us-west-2

AGENT_EVALS_S3_SECRET_ACCESS_KEY​

The Amazon S3 secret access key for running agent evals.

Type string
ConfigurabilityUpdate the deployment's configuration file.
Required Optional
Defaultnull
Examples
AGENT_EVALS_S3_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY