prototyping-lab/balena-supervisor-sdk

Node.js SDK for the Balena Supervisor API. (for changing hostnames and device names)

Balena Supervisor SDK

Simple Node.js wrapper for the balena supervisor API.

Currently only implementing as much as we need :)
Feel free to contribute.

Currently Implemented

• GET /v1/device/host-config
• PATCH /v1/device/host-config

Tutorial: Renaming devices and hostnames

By default balena ...

• ... creates fantasy names for the devices
• ... uses the first 7 digits of the Balena-UUID as hostname

In our setup we want to have:

• Our OWN Unique Device-IDs
• Use our Device-IDs as hostnames, and as balena device names.

Usage

1. Create your own hostnames.json
   Example:

    {
      '00112233445566778899aabbccddeeff': 'adas-device',
      'ffeeddccbbaa99887766554433221100': 'bobs-device',
      '32-digit-uuid-pasted-from-balena': 'your-hostname',
      ...
    }
   

2. Login to balena

    balena login
   

3. Run the script

    node balena-update-names.js hostnames.json
   

License

Apache License 2.0