Skip to content
Crow CI
Search limited to dev. Switch to the latest version for up-to-date results.
Codeberg

Server Core

Core server configuration variables.

ADMIN

Section titled “ADMIN”
  • Name: CROW_ADMIN
  • Description: List of admin users.
  • Default: none

HOST

Section titled “HOST”
  • Name: CROW_HOST
  • Description: Server fully qualified URL. Format: <scheme>://<host>[/<prefix path>]
  • Default: none

OPEN

Section titled “OPEN”
  • Name: CROW_OPEN
  • Description: Enable open user registration.
  • Default: false

ORGS

Section titled “ORGS”
  • Name: CROW_ORGS
  • Description: List of approved organizations.
  • Default: none

REPO_OWNERS

Section titled “REPO_OWNERS”
  • Name: CROW_REPO_OWNERS
  • Description: Repositories by those owners will be allowed to be used in Crow.
  • Default: none

SERVER_ADDR

Section titled “SERVER_ADDR”
  • Name: CROW_SERVER_ADDR
  • Description: Server address.
  • Default: :8000

SERVER_ADDR_TLS

Section titled “SERVER_ADDR_TLS”
  • Name: CROW_SERVER_ADDR_TLS
  • Description: Port HTTPS with TLS.
  • Default: :443

SERVER_CERT

Section titled “SERVER_CERT”
  • Name: CROW_SERVER_CERT
  • Description: Server SSL cert path.
  • Default: none

SERVER_KEY

Section titled “SERVER_KEY”
  • Name: CROW_SERVER_KEY
  • Description: Server SSL key path.
  • Default: none

SERVER_WEBHOOK_HOST

Section titled “SERVER_WEBHOOK_HOST”
  • Name: CROW_EXPERT_WEBHOOK_HOST
  • Description: Fully qualified Crow server URL called by forge’s webhooks. Format: <scheme>://<host>[/<prefix path>]. For experts only!
  • Default: none

GRPC_ADDR

Section titled “GRPC_ADDR”
  • Name: CROW_GRPC_ADDR
  • Description: gRPC address.
  • Default: :9000

METRICS_SERVER_ADDR

Section titled “METRICS_SERVER_ADDR”
  • Name: CROW_METRICS_SERVER_ADDR
  • Description: Metrics server address.
  • Default: none

ENABLE_SWAGGER

Section titled “ENABLE_SWAGGER”
  • Name: CROW_ENABLE_SWAGGER
  • Description: Enable Swagger API documentation.
  • Default: true

ENABLE_HA

Section titled “ENABLE_HA”
  • Name: CROW_ENABLE_HA
  • Description: Enable high availability mode with database-backed queue.
  • Default: false

QUEUE_LOCK_TTL

Section titled “QUEUE_LOCK_TTL”
  • Name: CROW_QUEUE_LOCK_TTL
  • Description: Time-to-live for the queue processing leader election lock in High Availability mode. If the leader node fails, other nodes must wait this duration before acquiring the lock.
  • Default: 30s

CRON_LOCK_TTL

Section titled “CRON_LOCK_TTL”
  • Name: CROW_CRON_LOCK_TTL
  • Description: Time-to-live for the cron scheduler leader election lock in High Availability mode. If the leader node fails, other nodes must wait this duration before acquiring the lock.
  • Default: 90s

KEEPALIVE_MIN_TIME

Section titled “KEEPALIVE_MIN_TIME”
  • Name: CROW_KEEPALIVE_MIN_TIME
  • Description: Server-side enforcement policy on the minimum amount of time a client should wait before sending a keepalive ping.
  • Default: none

SESSION_EXPIRES

Section titled “SESSION_EXPIRES”
  • Name: CROW_SESSION_EXPIRES
  • Description: Session expiration time.
  • Default: 72h

STATUS_CONTEXT

Section titled “STATUS_CONTEXT”
  • Name: CROW_STATUS_CONTEXT
  • Description: Status context prefix.
  • Default: ci/crow

STATUS_CONTEXT_FORMAT

Section titled “STATUS_CONTEXT_FORMAT”
  • Name: CROW_STATUS_CONTEXT_FORMAT
  • Description: Status context format.
  • Default: {{ .context }}/{{ .event }}/{{ .workflow }}{{if not (eq .axis_id 0)}}/{{.axis_id}}{{end}}

DISABLE_VERSION_CHECK

Section titled “DISABLE_VERSION_CHECK”
  • Name: CROW_DISABLE_VERSION_CHECK
  • Description: Disable version check in admin web UI.
  • Default: false

DISABLE_USER_AGENT_REGISTRATION

Section titled “DISABLE_USER_AGENT_REGISTRATION”
  • Name: CROW_DISABLE_USER_AGENT_REGISTRATION
  • Description: Disable user registered agents.
  • Default: false

MIGRATIONS_ALLOW_LONG

Section titled “MIGRATIONS_ALLOW_LONG”
  • Name: CROW_MIGRATIONS_ALLOW_LONG
  • Description: Allow long-running migrations.
  • Default: false

CUSTOM_CSS_FILE

Section titled “CUSTOM_CSS_FILE”
  • Name: CROW_CUSTOM_CSS_FILE
  • Description: File path for the server to serve a custom .CSS file, used for customizing the UI.
  • Default: none

CUSTOM_JS_FILE

Section titled “CUSTOM_JS_FILE”
  • Name: CROW_CUSTOM_JS_FILE
  • Description: File path for the server to serve a custom .JS file, used for customizing the UI.
  • Default: none

WWW_PROXY

Section titled “WWW_PROXY”
  • Name: CROW_DEV_WWW_PROXY
  • Description: Serve the website by using a proxy (used for development).
  • Default: none

ENVIRONMENT

Section titled “ENVIRONMENT”
  • Name: CROW_ENVIRONMENT
  • Description: Environment variables.
  • Default: none

NETWORK

Section titled “NETWORK”
  • Name: CROW_NETWORK
  • Description: Networks.
  • Default: none

VOLUME

Section titled “VOLUME”
  • Name: CROW_VOLUME
  • Description: Volumes.
  • Default: none

CONTAINER_NAME_SCHEME

Section titled “CONTAINER_NAME_SCHEME”
  • Name: CROW_CONTAINER_NAME_SCHEME
  • Description: Determines the naming scheme type for containers. Possible values are descriptive and hash. The descriptive scheme uses format <owner>-<repo>-<pipeline>-<workflow>-<stepname>-<stepnumber> for readability and uniqueness.
  • Default: descriptive

CONFIG_SERVICE_ENDPOINT

Section titled “CONFIG_SERVICE_ENDPOINT”
  • Name: CROW_CONFIG_SERVICE_ENDPOINT
  • Description: URL used for calling configuration service endpoint.
  • Default: none

PROMETHEUS_AUTH_TOKEN

Section titled “PROMETHEUS_AUTH_TOKEN”
  • Name: CROW_PROMETHEUS_AUTH_TOKEN
  • Description: Token to secure Prometheus metrics endpoint.
  • Default: none