> ## Documentation Index
> Fetch the complete documentation index at: https://docs.celeryroot.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Config reference

> Configuration models and fields for Celery Root.

## CeleryRootConfig

* `logging`: `LoggingConfigFile`
* `database`: `DatabaseConfigSqlite`
* `beat`: `BeatConfig | None`
* `prometheus`: `PrometheusConfig | None`
* `open_telemetry`: `OpenTelemetryConfig | None`
* `frontend`: `FrontendConfig | None`
* `mcp`: `McpConfig | None`
* `worker_import_paths`: list of app import paths.
* `event_queue_maxsize`: max event queue size.
* `integration`: whether running as a Celery subcommand.

## LoggingConfigFile

* `log_dir`: directory path.
* `log_rotation_hours`: rotation interval.
* `log_level`: log level string.
* `delete_on_boot`: delete logs on startup.

## DatabaseConfigSqlite

* `db_path`: SQLite file path.
* `retention_days`: record retention window.
* `batch_size`: max events per flush.
* `flush_interval`: seconds between flushes.
* `purge_db`: delete the database file on startup.

## BeatConfig

Enables the DB-backed beat scheduler when provided.

* `db_refresh_seconds`: optional override for how often beat polls the Root DB for schedule changes.

## PrometheusConfig

* `port`: exporter port.
* `prometheus_path`: metrics path.
* `flower_comatibility`: use Flower metric naming.

## OpenTelemetryConfig

* `endpoint`: OTLP collector endpoint.
* `service_name`: service name label.

## FrontendConfig

* `host`, `port`, `debug`, `poll_interval`, `secret_key`.
* `basic_auth`, `auth_provider`, `auth`.
* OAuth fields: `oauth2_key`, `oauth2_secret`, `oauth2_redirect_uri`.
* Okta/GitLab fields: `oauth2_okta_base_url`, `gitlab_allowed_groups`, `gitlab_min_access_level`, `gitlab_oauth_domain`.

## McpConfig

* `host`, `port`, `path`.
* `auth_key`: required token.
* `readonly_db_url`: optional read-only DB URL.