---
title: Configuring Sourcebot from a file (declarative config)
sidebarTitle: Declarative config
---

import ConfigSchema from '/snippets/schemas/v3/index.schema.mdx'

<Warning>
Declaratively defining `connections` is not available when [multi-tenancy](/self-hosting/more/tenancy) is enabled.
</Warning>

Some teams require Sourcebot to be configured via a file (where it can be stored in version control, run through CI/CD pipelines, etc.) instead of a web UI. For more information on configuring connections, see this [overview](/docs/connections/overview).


| Variable | Description |
| :------- | :---------- |
| `CONFIG_PATH` | Path to declarative config. |


```json
{
    "$schema": "https://raw.githubusercontent.com/sourcebot-dev/sourcebot/refs/heads/main/schemas/v3/index.json",
    "connections": {
        "connection-1": {
            "type": "github",
            "repos": [
                "sourcebot-dev/sourcebot"
            ]
        }
    }
}
```

## Schema reference

<Accordion title="Reference">
[schemas/v3/index.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/index.json)

<ConfigSchema />

</Accordion>