Configuration

Global Configuration

The global configuration file is located at ~/.proai/config.yml:

# ~/.proai/config.yml
default_org: my-organization
default_project: my-project
api_endpoint: https://api.proai.io
auth:
  method: sso
  provider: okta
editor:
  theme: dark
  format_on_save: true
`

## Project Configuration

Each project has a proai.yml file at the root:

```yaml
# proai.yml
project: my-project
version: "2.0"
description: "My ProAI project"

runtime:
  engine: spark
  version: "3.5"
  resources:
    driver_memory: "4g"
    executor_memory: "8g"

connectors:
  default_profile: production

scheduling:
  timezone: UTC
  max_concurrent_runs: 5
`

## Environment Variables

| Variable | Description | Default |
|----------|-------------|---------|
| PROAI_API_KEY | API authentication key | — |
| PROAI_API_ENDPOINT | API base URL | https://api.proai.io |
| PROAI_ORG | Default organization | — |
| PROAI_PROJECT | Default project | — |
| PROAI_LOG_LEVEL | Logging verbosity | info |

:::tip
Environment variables override values in proai.yml. Use them for secrets and per-environment settings.
:::

## See Also

- [Environment Setup](/docs/getting-started/environment-setup) — Configure environments
- [First Project](/docs/getting-started/first-project) — Create a new project