Registry
Environment variables of the Terrakube Registry. See Configuration Reference for how to set them. An empty default means the variable has no default: either it is optional or it must be provided.
/.well-known/terraform.json Data
AzBuilderRegistry
Sets io.terrakube.registry.hostname.
AppClientId
Sets io.terrakube.registry.clientId.
AppIssuerUri
Sets io.terrakube.registry.issuerUri.
TerraformLoginEnabled
false
Sets io.terrakube.registry.login-broker-enabled.
TerraformLoginApiUrl
Sets io.terrakube.registry.login-api-url.
Authentication Type
AuthenticationValidationTypeRegistry
Sets io.terrakube.registry.authentication.type.
Terrakube Client
TerrakubeEnableSecurity
Sets io.terrakube.client.enableSecurity.
AzBuilderApiUrl
Sets io.terrakube.client.url.
InternalSecret
Sets io.terrakube.client.secretKey.
Storage Service
RegistryStorageType
Sets io.terrakube.registry.plugin.storage.type.
AZURE Storage
AzureAccountName
Sets io.terrakube.registry.plugin.storage.azure.accountName.
AzureAccountKey
Sets io.terrakube.registry.plugin.storage.azure.accountKey.
AzureBlobPresignedUrlExpirySeconds
300
Azure Blob module.zip presigned SAS redirect - off by default for staged rollout; also the rollback switch back to the registry proxying ZIP bytes.
AzureBlobPresignedRedirectEnabled
false
Sets io.terrakube.registry.plugin.storage.azure.presignedRedirectEnabled.
AWS Storage
AwsStorageAccessKey
Sets io.terrakube.registry.plugin.storage.aws.accessKey.
AwsStorageSecretKey
Sets io.terrakube.registry.plugin.storage.aws.secretKey.
AwsStorageBucketName
Sets io.terrakube.registry.plugin.storage.aws.bucketName.
AwsStorageRegion
Sets io.terrakube.registry.plugin.storage.aws.region.
AwsEndpoint
Sets io.terrakube.registry.plugin.storage.aws.endpoint.
AwsEnableRoleAuth
false
Sets io.terrakube.registry.plugin.storage.aws.enableRoleAuthentication.
AwsEndpointRegion
auto
S3-compatible backends (Qumulo, MinIO, ...) that need a real signing region or no chunked/checksum support
AwsPathStyleAccess
true
Sets io.terrakube.registry.plugin.storage.aws.pathStyleAccessEnabled.
AwsChunkedEncodingEnabled
true
Sets io.terrakube.registry.plugin.storage.aws.chunkedEncodingEnabled.
AwsChecksumValidationEnabled
true
Sets io.terrakube.registry.plugin.storage.aws.checksumValidationEnabled.
AwsS3ConnectionAcquisitionTimeoutSeconds
1
S3Client/S3Presigner HTTP client bounds - fail fast rather than queue request threads against a slow or unreachable S3 endpoint. Defaults match the module-download resilience design.
AwsS3ConnectTimeoutSeconds
2
Sets io.terrakube.registry.plugin.storage.aws.connectTimeoutSeconds.
AwsS3SocketTimeoutSeconds
10
Sets io.terrakube.registry.plugin.storage.aws.socketTimeoutSeconds.
AwsS3ApiCallAttemptTimeoutSeconds
15
Sets io.terrakube.registry.plugin.storage.aws.apiCallAttemptTimeoutSeconds.
AwsS3ApiCallTimeoutSeconds
25
Sets io.terrakube.registry.plugin.storage.aws.apiCallTimeoutSeconds.
AwsS3MaxConnections
50
Sets io.terrakube.registry.plugin.storage.aws.maxConnections.
AwsS3PresignedUrlExpirySeconds
300
module.zip presigned redirect - off by default for staged rollout; also the rollback switch back to the registry proxying ZIP bytes.
AwsS3PresignedRedirectEnabled
false
Sets io.terrakube.registry.plugin.storage.aws.presignedRedirectEnabled.
GCP Storage
GcpStorageCredentialsBase64
Sets io.terrakube.registry.plugin.storage.gcp.credentials.
GcpStorageBucketName
Sets io.terrakube.registry.plugin.storage.gcp.bucketName.
GcpStorageProjectId
Sets io.terrakube.registry.plugin.storage.gcp.projectId.
GcpPresignedUrlExpirySeconds
300
GCP Cloud Storage module.zip V4-signed URL redirect - off by default for staged rollout; also the rollback switch back to the registry proxying ZIP bytes. Requires iam.serviceAccounts.signBlob IAM permission on the service account.
GcpPresignedRedirectEnabled
false
Sets io.terrakube.registry.plugin.storage.gcp.presignedRedirectEnabled.
Cors
TerrakubeUiURL
Sets io.terrakube.ui.fqdn.
DEX AUTHENTICATION
PatSecret
Sets io.terrakube.token.pat.
DexIssuerUri
Sets io.terrakube.token.issuer-uri.
DexAudienceValidation
false
Opt-in: accept Dex tokens only when aud contains AppClientId or one of DexExtraAudiences (comma-separated)
DexExtraAudiences
Sets io.terrakube.token.extra-audiences.
CACHE FEDERATED AUTHENTICATION
FederatedCacheExpireAfterWrite
10
Sets io.terrakube.registry.federatedCacheExpireAfterWrite.
FederatedCacheMaximumSize
1000
Sets io.terrakube.registry.federatedCacheMaximumSize.
ProviderManagerCacheExpireAfterWrite
60
Sets io.terrakube.registry.providerManagerCacheExpireAfterWrite.
ProviderManagerCacheMaximumSize
100
Sets io.terrakube.registry.providerManagerCacheMaximumSize.
MODULE REGISTRY CACHE
ModuleVersionsCacheTtlSeconds
600
Time to live of the module version list. This is the delay between the API storing a new module version and the registry serving it, so lower it when modules are released often.
DOWNLOAD COUNT UPDATE
DownloadCountExecutorCorePoolSize
2
Bounded pool for the best-effort download-count bookkeeping call, kept off the Terraform-facing metadata response's critical path - see DownloadCountExecutorConfig.
DownloadCountExecutorMaxPoolSize
5
Sets io.terrakube.registry.download-count.executor.maxPoolSize.
DownloadCountExecutorQueueCapacity
200
Sets io.terrakube.registry.download-count.executor.queueCapacity.
Last updated
Was this helpful?