Skip to content
Crow CI

Maintenance

Maintenance and cleanup configuration variables.

Agent Cleanup

Section titled “Agent Cleanup”

MAINTENANCE_STALE_AGENT_CLEANUP_ENABLED

Section titled “MAINTENANCE_STALE_AGENT_CLEANUP_ENABLED”
  • Name: CROW_MAINTENANCE_STALE_AGENT_CLEANUP_ENABLED
  • Description: Enable automatic stale agent cleanup.
  • Default: true

MAINTENANCE_STALE_AGENT_DURATION

Section titled “MAINTENANCE_STALE_AGENT_DURATION”
  • Name: CROW_MAINTENANCE_STALE_AGENT_DURATION
  • Description: Duration after which agents are considered stale (e.g., 24h for 1 day).
  • Default: 24h

Kubernetes Cleanup

Section titled “Kubernetes Cleanup”

MAINTENANCE_KUBERNETES_CLEANUP_ENABLED

Section titled “MAINTENANCE_KUBERNETES_CLEANUP_ENABLED”
  • Name: CROW_MAINTENANCE_KUBERNETES_CLEANUP_ENABLED
  • Description: Whether to enable Kubernetes resource cleanup.
  • Default: false (true when CROW_BACKEND=kubernetes is set on the server)

Set this on the server to enable scheduled cleanup even when only the agents have CROW_BACKEND=kubernetes. When enabled without an explicit age, the threshold is 168h.

MAINTENANCE_KUBERNETES_CLEANUP_AGE

Section titled “MAINTENANCE_KUBERNETES_CLEANUP_AGE”
  • Name: CROW_MAINTENANCE_KUBERNETES_CLEANUP_AGE
  • Description: The age threshold for Kubernetes resources to be cleaned up.
  • Default: 168h

MAINTENANCE_KUBERNETES_CLEANUP_NAMESPACES

Section titled “MAINTENANCE_KUBERNETES_CLEANUP_NAMESPACES”
  • Name: CROW_MAINTENANCE_KUBERNETES_CLEANUP_NAMESPACES
  • Description: Comma-separated list of namespaces to clean up.
  • Default: none (applies to current server namespace)

Set this on the server to include every agent execution namespace, including namespaces created by namespace-per-organization mode. Crow does not automatically discover agent namespaces or remote agent clusters. Empty entries are rejected. If the server namespace cannot be determined, configure this variable explicitly.

Log Table Vacuum

Section titled “Log Table Vacuum”

MAINTENANCE_VACUUM_LOG_TABLE_ENABLED

Section titled “MAINTENANCE_VACUUM_LOG_TABLE_ENABLED”
  • Name: CROW_MAINTENANCE_VACUUM_LOG_TABLE_ENABLED
  • Description: Whether to enable vacuuming of the log table.
  • Default: true

MAINTENANCE_VACUUM_LOG_TABLE_SCHEDULE

Section titled “MAINTENANCE_VACUUM_LOG_TABLE_SCHEDULE”
  • Name: CROW_MAINTENANCE_VACUUM_LOG_TABLE_SCHEDULE
  • Description: Cron schedule for vacuuming the log table.
  • Default: 0 5 * * *

Orphaned Data Cleanup

Section titled “Orphaned Data Cleanup”

Cleans up database rows referencing deleted forge users or repositories. Hard-deletes crons pointing at deleted repos, disables crons whose repo’s owner was deleted, and reports orphaned repos for admin review without auto-deleting them.

MAINTENANCE_ORPHANED_DATA_CLEANUP_ENABLED

Section titled “MAINTENANCE_ORPHANED_DATA_CLEANUP_ENABLED”
  • Name: CROW_MAINTENANCE_ORPHANED_DATA_CLEANUP_ENABLED
  • Description: Enable automatic cleanup of orphaned database rows.
  • Default: true

MAINTENANCE_ORPHANED_DATA_CLEANUP_SCHEDULE

Section titled “MAINTENANCE_ORPHANED_DATA_CLEANUP_SCHEDULE”
  • Name: CROW_MAINTENANCE_ORPHANED_DATA_CLEANUP_SCHEDULE
  • Description: Cron schedule for orphaned data cleanup.
  • Default: 0 5 * * *