# Configuration

#### Database Configuration

| Variable      | Description                                                                        | Default Value |
| ------------- | ---------------------------------------------------------------------------------- | ------------- |
| `DB_PASSWORD` | PostgreSQL database password                                                       | -             |
| `DB_SERVER`   | Database server hostname (*should be the same as the docker compose service name*) | `database`    |

#### Application Settings

| Variable         | Description                                                                       | Default Value |
| ---------------- | --------------------------------------------------------------------------------- | ------------- |
| `INSTANCE_NAME`  | Name of the DataSpace instance. Will appear in on the top banner of the frontend. | -             |
| `INSTANCE_COLOR` | UI color for the instance banner                                                  | -             |
| `CORS_ORIGINS`   | Base URL of the Frontend                                                          | -             |
| `API_URL`        | Base URL for the API service                                                      | -             |
| `DOCS_URL`       | URL for documentation                                                             | -             |
| `ENCRYPTION_KEY` | Key for user secrets encryption                                                   | -             |
| `LICENSE_KEY`    | Application license key                                                           | -             |

#### Email Configuration

| Variable                  | Description                         | Default Value |
| ------------------------- | ----------------------------------- | ------------- |
| `SMTP_SERVER`             | SMTP server for email notifications | -             |
| `SMTP_SERVER_PASSWORD`    | SMTP server password                | -             |
| `PLATFORM_ADMIN_EMAIL`    | Admin email address                 | -             |
| `PLATFORM_ADMIN_PASSWORD` | Admin password                      | -             |

#### AI Services

| Variable          | Description                | Default Value |
| ----------------- | -------------------------- | ------------- |
| `OLLAMA_ENDPOINT` | Ollama service endpoint    | -             |
| `GEMINI_ENDPOINT` | Google Gemini API endpoint | -             |
| `GEMINI_API_KEY`  | Google Gemini API key      | -             |

#### Data Storage

<table><thead><tr><th width="249">Variable</th><th>Description</th><th>Default Value</th></tr></thead><tbody><tr><td><code>DATA_STORAGE_PATH</code></td><td>Path to app data storage within container</td><td><code>/app/data</code></td></tr><tr><td><code>HOST_DATA_STORAGE_PATH</code></td><td>Host path for app data storage</td><td><code>/opt/dataspace/Platform/volume/DataSpace_data</code></td></tr></tbody></table>

#### Authentication

| Variable                  | Description                   | Default Value |
| ------------------------- | ----------------------------- | ------------- |
| `MICROSOFT_CLIENT_ID`     | Microsoft OAuth client ID     | -             |
| `MICROSOFT_CLIENT_SECRET` | Microsoft OAuth client secret | -             |
| `GOOGLE_CLIENT_ID`        | Google OAuth client ID        | -             |
| `GOOGLE_CLIENT_SECRET`    | Google OAuth client secret    | -             |

#### Build Management

| Variable                    | Description                                         | Default Value |
| --------------------------- | --------------------------------------------------- | ------------- |
| `MAX_BUILD_RETENTION_COUNT` | Maximum number of builds to retain                  | `10`          |
| `MAX_SCHEDULE_FAIL_COUNT`   | Maximum number of schedule failures before stopping | `3`           |
| `MAX_BUILD_RUNNER_COUNT`    | Maximum number of concurrent build runners          | `4`           |

#### System Configuration

| Variable   | Description                      | Default Value |
| ---------- | -------------------------------- | ------------- |
| `USER_ID`  | User ID for container execution  | `1007`        |
| `GROUP_ID` | Group ID for container execution | `1007`        |

#### Version Control

| Variable           | Description                | Default Value |
| ------------------ | -------------------------- | ------------- |
| `API_VERSION`      | API container version      | `latest`      |
| `OLLAMA_VERSION`   | Ollama container version   | `latest`      |
| `FRONTEND_VERSION` | Frontend container version | `latest`      |