⚙️ Configuration Reference

Environment Variables

Configure your .git projects using environment variables. These can be set via the dashboard, CLI, or directly in your .env file. All variables support runtime injection and hot-reloading.

🔍
Variable Type Default Required Description
GIT_API_KEY string — Yes Authentication token for API access. Generate from Project Settings > Tokens.
GIT_PROJECT_ID string — Yes Unique identifier for your project. Found in your dashboard URL.
GIT_ENVIRONMENT string development No Target deployment environment. Options: development, staging, production.
GIT_AUTO_DEPLOY boolean true No Automatically deploy on push to main branch. Set to false for manual releases.
GIT_MAX_CONCURRENT_DEPLOYS integer 3 No Maximum number of simultaneous deployments allowed for this project.
GIT_LOG_LEVEL string info No Verbosity of runtime logs. Options: debug, info, warn, error.
GIT_WEBHOOK_URL string — No Endpoint to receive deployment status updates. Must be a valid HTTPS URL.
GIT_RATE_LIMIT_PER_MINUTE integer 60 No API request limit per minute for webhook and CLI operations.
GIT_CUSTOM_DOMAIN string — No Override default .git.dev subdomain with your own domain. DNS must be configured.
GIT_ENABLE_ANALYTICS boolean false No Enable built-in performance monitoring and usage analytics dashboard.

Configuration Examples

.env 
# Required credentials
GIT_API_KEY=sk_live_a1b2c3d4e5f6g7h8
GIT_PROJECT_ID=proj_9x8y7z6w5v4u3t2s

# Environment & deployment
GIT_ENVIRONMENT=production
GIT_AUTO_DEPLOY=false
GIT_MAX_CONCURRENT_DEPLOYS=5

# Monitoring & webhooks
GIT_LOG_LEVEL=warn
GIT_WEBHOOK_URL=https://hooks.slack.com/services/T00/B00/XXXX
GIT_ENABLE_ANALYTICS=true
CLI Usage 
# Set variables via CLI
git config set GIT_ENVIRONMENT production
git secrets set GIT_API_KEY "your-api-key"

# Validate current configuration
git env list --env production

# Export for local development
git env export > .env.local
Docker / Container 
# docker-compose.yml
services:
  app:
    image: .git/runtime:latest
    environment:
      - GIT_PROJECT_ID=proj_prod_123
      - GIT_API_KEY=${GIT_API_KEY}
      - GIT_ENVIRONMENT=production
      - GIT_LOG_LEVEL=info

Important Notes

  • Variables starting with GIT_ are reserved by the platform and cannot be overridden by application-level configs.
  • Changes to environment variables trigger an automatic redeployment within 30 seconds.
  • Secret values are encrypted at rest and never appear in logs or build outputs.
  • Use git env validate to check for missing or malformed variables before committing.
  • Wildcard patterns are not supported in variable names. Use uppercase letters, numbers, and underscores only.