os.conf

File Location And Role

The following paths are searched:

• /etc/os.conf
• /etc/os-platform.conf
• /data/etc/os.conf
• /boot/os.conf

Files that are found are then sourced, in this order, for all init scripts, through /etc/init.d/os_conf.

These files contain settings that affect the functioning of the entire operating system. os-platform.conf, if present, should contain platform-specific OS settings (as opposed to common OS settings).

File Format

This is a simple shell script that should contain only NAME="value" lines.

Available Variables

OS_DEBUG

If set to true, enables verbose logging and various debugging options. Defaults to false.

OS_PRERELEASES

If set to true, the system will consider prereleases/beta versions when checking for updates. Defaults to false.

OS_ETH

Determines the name of the ethernet (wired) network interface. Defaults to eth0.

OS_WLAN

Determines the name of the Wi-Fi (station) network interface. Defaults to wlan0.

OS_WLAN1

Determines the name of a secondary Wi-Fi (station) network interface. Defaults to wlan1.

OS_AP

Determines the name of the Wi-Fi AP network interface. Defaults to ap0.

OS_PPP

Determines the name of the mobile network (modem) interface. Defaults to ppp0.

OS_NETWORKLESS

When true, the system won't start any services that depend on (require) a network connection. Defaults to false.

OS_COUNTRY

Represents the country and is currently used for selecting the wireless regulatory domain. The value must be given as an ISO3166 alpha2 (two letters) country code. Defaults to US.

OS_FACTORY_RESET_GPIO

Indicates the GPIO number of a reset button. Unset by default. See Factory Defaults for more details.

OS_FACTORY_RESET_INPUT

Indicates the input device of a reset button (e.g. event0 for /dev/input/event0). Unset by default. See Factory Defaults for more details.

OS_FACTORY_RESET_LEVEL

Indicates the active logic level of the reset button. Defaults to 1. See Factory Defaults for more details.

OS_FACTORY_RESET_HOLD_SECONDS

Indicates hold time, in seconds, for a reset trigger. Defaults to 10. See Factory Defaults for more details.

OS_FIRMWARE_LATEST_STABLE

Represents the full URL to a JSON file containing details about the latest stable version. See Firmware-Updates#latest-version for details.

OS_FIRMWARE_LATEST_BETA

Represents the full URL to a JSON file containing details about the latest beta version. See Firmware-Updates#latest-version for details.

OS_FIRMWARE_URL

Represents a parametrized full URL where OS images can be downloaded from. See Firmware-Updates for details.

OS_FIRMWARE_AUTO_UPDATE

If set to true, the system will automatically check for firmware updates. Defaults to false.