> For the complete documentation index, see [llms.txt](https://pedal.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pedal.gitbook.io/docs/cli/config.md).

# Configuration

A detailed reference for PEDAL configuration options.

## Environment Variables

* `PEDAL_API_KEY`: API key for authentication
* `GITHUB_TOKEN`: For GitHub integration
* `DATABASE_URL`: Database connection string
* `LOG_LEVEL`: Logging verbosity

## pedal.yaml

* `workflows`: List of workflow definitions
* `integrations`: External service configs (GitHub, Slack, etc.)
* `auth`: Authentication settings
* `database`: Database configuration

## Example pedal.yaml

```yaml
workflows:
  - name: build-and-test
    triggers:
      - github_push
    steps:
      - run: pytest
integrations:
  github:
    token: ${GITHUB_TOKEN}
auth:
  method: api_key
database:
  url: ${DATABASE_URL}
```

***

> For error codes, see [Error Codes](/docs/cli/error-codes.md)