Skip to content

Configuration Reference

Each ToloMEO µServices microservice reads its deployment configuration from a single TOML file, pointed to by the TOLOMEO_CONFIG environment variable. The shared [nats] and [service] tables are part of the framework and are documented in the Py ToloMEO Configuration Reference.

This page covers the per-service [plugins.*] tables that ToloMEO µServices itself defines.

[plugins.glances_stats]

Key Type Default Meaning
hostname string localhost Host serving the Glances HTTP API
port positive integer 61208 TCP port the Glances API listens on
api_version integer 4 Glances HTTP API version used in the request path
interval_s positive float 5.0 Seconds between polls of the Glances server

Note

The service polls http://<hostname>:<port>/api/<api_version>/cpu. With the defaults this is http://localhost:61208, so a Glances server co-located on the same host works with no extra configuration; set hostname/port to reach a server elsewhere. See the Glances documentation for setting up the server itself.

[plugins.swupdate]

Key Type Default Meaning
download_dir path (framework) Directory the update package is written to
download_filename string ota.pkg Name the package is saved under
checkpoint_file path (framework) Where the OTA state snapshot is persisted across a restart

Tip

These keys map onto the framework OTAOptions model. See the py-tolomeo Configuration Reference for their defaults and for the shared [nats]/[service] tables.