Configuration
Environment variables are used to control various aspects of the application. The following are currently defined:
- General
SIOT_HTTP_PORT
: http network port the SIOT server attaches to (default is 8118)SIOT_DATA
: directory where any data is storedSIOT_AUTH_TOKEN
: auth token used for NATS and HTTP device API, default is blank (no auth)OS_VERSION_FIELD
: the field in/etc/os-release
used to extract the OS version information. Default isVERSION
, which is common in most distros. The Yoe Distribution populatesVERSION_ID
with the update version, which is probably more appropriate for embedded systems built with Yoe. See ref/version.
- NATS configuration
SIOT_NATS_PORT
: Port to run NATS on (default is 4222 if not set)SIOT_NATS_HTTP_PORT
: Port to run NATS monitoring interface (default is 8222)SIOT_NATS_SERVER
: defaults to nats://localhost:4222SIOT_NATS_TLS_CERT
: points to TLS certificate file. If not set, TLS is not used.SIOT_NATS_TLS_KEY
: points to TLS certificate keySIOT_NATS_TLS_TIMEOUT
: Configure the TLS upgrade timeout. NATS defaults to a 0.5s timeout for TLS upgrade, but that is too short for some embedded systems that run on low end CPUs connected over cellular modems (we've see this process take as long as 4s). See NATS documentation for more information.SIOT_NATS_WS_PORT
: Port to run NATS websocket (default is 9222, set to 0 to disable)
- Particle.io
SIOT_PARTICLE_API_KEY
: key used to fetch data from Particle.io devices running Simple IoT firmware