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 |
| ---- | -------------------- | ---- | --------- | ------- | ----------- |
2026-07-24 15:52:26 +02:00
| config_file_path | | `pathlib.Path | None` | `ro` | `N/A` | Path to EOS configuration file. |
| config_folder_path | | `pathlib.Path | None` | `ro` | `N/A` | Path to EOS configuration directory. |
2026-04-15 08:48:56 +02:00
| config_save_interval_sec | `EOS_GENERAL__CONFIG_SAVE_INTERVAL_SEC` | `int` | `rw` | `60` | Automatic configuration file saving interval [seconds]. |
| config_save_mode | `EOS_GENERAL__CONFIG_SAVE_MODE` | `<enum 'ConfigSaveMode'>` | `rw` | `AUTOMATIC` | Configuration file save mode for configuration changes ['MANUAL', 'AUTOMATIC']. Defaults to 'AUTOMATIC'. |
2026-02-22 14:12:42 +01:00
| data_folder_path | `EOS_GENERAL__DATA_FOLDER_PATH` | `Path` | `rw` | `required` | Path to EOS data folder. |
2026-07-24 15:52:26 +02:00
| data_output_path | | `pathlib.Path | None` | `ro` | `N/A` | Computed data_output_path based on data_folder_path. |
| data_output_subpath | `EOS_GENERAL__DATA_OUTPUT_SUBPATH` | `pathlib.Path | None` | `rw` | `output` | Sub-path for the EOS output data folder. |
2026-02-22 14:12:42 +01:00
| home_assistant_addon | `EOS_GENERAL__HOME_ASSISTANT_ADDON` | `bool` | `rw` | `required` | EOS is running as home assistant add-on. |
2026-07-24 15:52:26 +02:00
| latitude | `EOS_GENERAL__LATITUDE` | `float | None` | `rw` | `52.52` | Latitude in decimal degrees between -90 and 90. North is positive (ISO 19115) (°) |
| longitude | `EOS_GENERAL__LONGITUDE` | `float | None` | `rw` | `13.405` | Longitude in decimal degrees within -180 to 180 (°) |
| timezone | | `str | None` | `ro` | `N/A` | Computed timezone based on latitude and longitude. |
| version | `EOS_GENERAL__VERSION` | `str | None` | `rw` | `None` | Configuration file version. |
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-04-15 08:48:56 +02:00
"config_save_mode" : "AUTOMATIC" ,
"config_save_interval_sec" : 60 ,
2026-03-07 14:46:30 +01:00
"version" : "0.0.0" ,
2026-02-22 14:12:42 +01:00
"data_folder_path" : "/home/user/.local/share/net.akkudoktoreos.net" ,
2025-11-13 22:53:46 +01:00
"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-04-15 08:48:56 +02:00
"config_save_mode" : "AUTOMATIC" ,
"config_save_interval_sec" : 60 ,
2026-03-07 14:46:30 +01:00
"version" : "0.0.0" ,
2026-02-22 14:12:42 +01:00
"data_folder_path" : "/home/user/.local/share/net.akkudoktoreos.net" ,
2025-11-13 22:53:46 +01:00
"data_output_subpath" : "output" ,
"latitude" : 52.52 ,
"longitude" : 13.405 ,
"timezone" : "Europe/Berlin" ,
2026-02-22 14:12:42 +01:00
"data_output_path" : "/home/user/.local/share/net.akkudoktoreos.net/output" ,
2025-11-13 22:53:46 +01:00
"config_folder_path" : "/home/user/.config/net.akkudoktoreos.net" ,
2026-02-22 14:12:42 +01:00
"config_file_path" : "/home/user/.config/net.akkudoktoreos.net/EOS.config.json"
2025-11-13 22:53:46 +01:00
}
}
```
<!-- pyml enable line-length -->