Overview

All Crow CI components are configured through environment variables. This section provides a complete reference for all available configuration options.

Server Variables

Configuration for the Crow CI server:

Core Settings - Host, admin users, registration, organizations
Database - Database driver and connection settings
Forge Integration - OAuth, forge drivers (GitHub, GitLab, Forgejo, etc.)
Single Sign-On (OIDC) - OpenID Connect sign-in, group restrictions and admin mapping
CI Quota Accounting - report Crow workflow runtime to a Forgejo quota ledger
Security - Encryption, secrets, TLS configuration
Defaults - Default values for repositories and pipelines
Plugins - Plugin configuration and privileges
Logging - Log levels, output, and rotation
Maintenance - Cleanup tasks and scheduled jobs

Agent Variables

Configuration for Crow CI agents:

Agent Settings - Agent identity, labels, and connection settings
Backend: Docker - Docker-specific backend configuration
Backend: Kubernetes - Kubernetes-specific backend configuration
Backend: Local - Local backend configuration
Backend: Podman - Podman-specific backend configuration
Backend: Tart - macOS VM-per-workflow backend configuration
Backend: Hyper-V - Windows VM-per-workflow backend configuration

Autoscaler Variables

Autoscaler - Autoscaler pool and timing configuration