#Configure the local LRS

Operating model: Local / self-managed

Runtime configuration stays outside the application image and controls how an acquired release runs.

#Inspect effective configuration

Shell

simplestlrs config show
simplestlrs config show --config ./simplestlrs.yaml

The default configuration file is ~/.config/simplestdata/lrs.yaml. If XDG_CONFIG_HOME is set, the LRS uses ${XDG_CONFIG_HOME}/simplestdata/lrs.yaml.

The default file is optional. A file explicitly provided with --config must exist.

#Supported YAML fields

yaml

version: 1.0.1
server:
  bind: 127.0.0.1
  port: 8000
runtime:
  profile: canonical
database:
  persistence: true

Only the fields shown above are currently supported. server.bind must be an IP address, server.port must be between 1 and 65535, The current runtime uses the canonical profile with database persistence enabled.

Warning

simplestlrs start <version> determines which LRS release runs. Keep the YAML version aligned with the release you start.

#Precedence

Effective settings resolve in this order:

Text

built-in safe defaults
  → YAML configuration
  → explicit CLI flags

Only bind and port have CLI overrides:

Shell

simplestlrs start 1.0.1 --port 8080
simplestlrs start 1.0.1 --bind 0.0.0.0 --port 8080
simplestlrs start 1.0.1 --config ./simplestlrs.yaml

See networking before exposing the LRS beyond the default loopback address.