Skip to main content

Environment Variables

Bitloops uses environment variables for secrets, overrides, and build-time configuration.

Runtime Variables

These are resolved at runtime when Bitloops reads your configuration.

Knowledge Provider Credentials

VariableUsed ByDescription
GITHUB_TOKENGitHub knowledge providerPersonal access token for GitHub API
ATLASSIAN_EMAILJira / Confluence providersEmail for Atlassian API authentication
ATLASSIAN_TOKENJira / Confluence providersAPI token for Atlassian services

Semantic Provider

VariableUsed ByDescription
OPENAI_API_KEYSemantic embeddingsAPI key for embedding generation

Storage Credentials

AWS and GCS credentials are resolved from your standard cloud provider environment:

  • AWS S3: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION, or AWS CLI profiles
  • Google Cloud Storage: Application default credentials or GOOGLE_APPLICATION_CREDENTIALS

Bitloops Override Variables

VariableDescription
BITLOOPS_DASHBOARD_MANIFEST_URLOverride the dashboard bundle manifest URL
BITLOOPS_DASHBOARD_CDN_BASE_URLOverride the dashboard CDN base URL

These are advanced overrides typically used for development or custom deployments.

Using Variables in Configuration

Reference environment variables in .bitloops/config.json using the ${VAR_NAME} syntax:

{
"knowledge": {
"providers": {
"github": {
"token": "${GITHUB_TOKEN}"
}
}
}
}

This lets you commit your configuration to git without exposing secrets.