2025-12-30 22:08:21 +01:00
## General settings
2025-11-13 22:53:46 +01:00
<!-- pyml disable line - length -->
:::{table} general
:widths: 10 20 10 5 5 30
:align: left
| Name | Environment Variable | Type | Read-Only | Default | Description |
| ---- | -------------------- | ---- | --------- | ------- | ----------- |
2025-12-30 22:08:21 +01:00
| config_file_path | | `Optional[pathlib.Path]` | `ro` | `N/A` | Path to EOS configuration file. |
| config_folder_path | | `Optional[pathlib.Path]` | `ro` | `N/A` | Path to EOS configuration directory. |
2025-11-13 22:53:46 +01:00
| data_folder_path | `EOS_GENERAL__DATA_FOLDER_PATH` | `Optional[pathlib.Path]` | `rw` | `None` | Path to EOS data directory. |
2025-12-30 22:08:21 +01:00
| data_output_path | | `Optional[pathlib.Path]` | `ro` | `N/A` | Computed data_output_path based on data_folder_path. |
2025-11-13 22:53:46 +01:00
| data_output_subpath | `EOS_GENERAL__DATA_OUTPUT_SUBPATH` | `Optional[pathlib.Path]` | `rw` | `output` | Sub-path for the EOS output data directory. |
2025-12-30 22:08:21 +01:00
| home_assistant_addon | | `bool` | `ro` | `N/A` | EOS is running as home assistant add-on. |
| latitude | `EOS_GENERAL__LATITUDE` | `Optional[float]` | `rw` | `52.52` | Latitude in decimal degrees between -90 and 90. North is positive (ISO 19115) (°) |
| longitude | `EOS_GENERAL__LONGITUDE` | `Optional[float]` | `rw` | `13.405` | Longitude in decimal degrees within -180 to 180 (°) |
| timezone | | `Optional[str]` | `ro` | `N/A` | Computed timezone based on latitude and longitude. |
2026-01-01 12:26:29 +01:00
| version | `EOS_GENERAL__VERSION` | `str` | `rw` | `0.2.0.dev81043823` | Configuration file version. Used to check compatibility. |
2025-11-13 22:53:46 +01:00
:::
<!-- pyml enable line - length -->
<!-- pyml disable no - emphasis - as - heading -->
**Example Input**
<!-- pyml enable no - emphasis - as - heading -->
<!-- pyml disable line - length -->
```json
{
"general": {
2026-01-01 12:26:29 +01:00
"version": "0.2.0.dev81043823",
2025-11-13 22:53:46 +01:00
"data_folder_path": null,
"data_output_subpath": "output",
"latitude": 52.52,
"longitude": 13.405
}
}
```
<!-- pyml enable line - length -->
<!-- pyml disable no - emphasis - as - heading -->
**Example Output**
<!-- pyml enable no - emphasis - as - heading -->
<!-- pyml disable line - length -->
```json
{
"general": {
2026-01-01 12:26:29 +01:00
"version": "0.2.0.dev81043823",
2025-11-13 22:53:46 +01:00
"data_folder_path": null,
"data_output_subpath": "output",
"latitude": 52.52,
"longitude": 13.405,
"timezone": "Europe/Berlin",
"data_output_path": null,
"config_folder_path": "/home/user/.config/net.akkudoktoreos.net",
2025-12-30 22:08:21 +01:00
"config_file_path": "/home/user/.config/net.akkudoktoreos.net/EOS.config.json",
"home_assistant_addon": false
2025-11-13 22:53:46 +01:00
}
}
```
<!-- pyml enable line - length -->