Skip to content

Config file

Default locations, chosen by who runs the agent:

  • Running as root: /etc/thinr-agent/config.json
  • Running as a user: ~/.config/thinr-agent/config.json

Override with -c, --config <path>.

Format

json
{
  "host": "acme.thinr.io",
  "device": {
    "id": "edge-gw-17",
    "name": "Store 14 · Madrid",
    "user": "acme",
    "token": "<encrypted>"
  },
  "version": "1.0.0",
  "verify_ssl": true
}
KeyMeaningDefault
hostServer the agent connects to.required
device.idDevice identifier on the platform.required
device.nameHuman-friendly device name.empty
device.userAccount the device belongs to.required
device.tokenDevice credential, stored encrypted.required
versionConfig schema version.1.0.0
verify_sslValidate the server's TLS certificate.true

Handling

  • The file is written by the installer (or thinr-agent reconfigure) with 0600 permissions; you rarely need to edit it by hand.
  • The device token is never stored in plaintext. To rotate credentials, re-provision with thinr-agent reconfigure or thinr-agent install --overwrite.
  • The agent reads the file at startup; after changing it, restart the service (systemctl restart thinr-agent).

Released under the MIT License.