The network settings are set by creating a configuration file on a USB memory stick. An example of this file is shown on the right. See below for links to download sample files.

Creating the USB memory stick

In order for the gateway to correctly mount the memory stick on boot it must be formatted as FAT32 (MS DOS) and must be named MOBIUSCONF. The settings file must then be placed in the root of this memory stick and must be named networks.json.

The format of the file is JSON (see: What is JSON?) and must contain a JSON array with one or more settings objects, one for each interface. If an interface is not included in this file then its settings will not be changed.

Creating the networks.json file

1. Select and download the example file that fits your device's architecture from the links below
2. Rename the file to networks.json
3. Open the file in your favourite text editor
4. Enable or disable the required network interfaces by setting the value of the enabled key to true to enable or false to disable
5. Choose either DHCP or static IP for the wired and WiFi connections
   1. For DHCP set value of the ipv4 method key to auto
   2. For static IP set the value of the ipv4 method key to manual and set the required IP address into the value of the ipv4 address key. Set the prefix, gateway and dns keys as required (for most applications these can be left blank)

IPV6 settings are not currently supported

When setting IPV4 settings it is possible to leave out a setting such as gateway or dns. Setting these to an empty string will have the same effect as leaving them out.

Applying the settings

After creating the USB stick and settings file, insert it into one of the gateway's USB ports and reboot the gateway. Wait for the gateway to fully boot before removing the USB stick. The settings will be saved and remembered between subsequent boots so it is not necessary to leave the USB stick in the gateway.

See https://developer.gnome.org/NetworkManager/stable/nm-settings.html for more details about each of the possible settings.

Network Settings

Intel Based Devices

Intel based devices include the iaconnects 3G/4G gateway, and the Intel NUC. (Intel Network File Example)

[
  {
    "connection": {
      "enabled": true,
      "type": "ethernet",
      "id": "Wired connection 1",
      "interface-name": "enp2s0"
    },
    "ipv4": {
      "method": "auto",
      "address": "",
      "prefix": 24,
      "gateway": "",
      "dns": ""
    }
  },
  {
    "connection": {
      "enabled": true,
      "type": "ethernet",
      "id": "Wired connection 2",
      "interface-name": "enp3s0"
    },
    "ipv4": {
      "method": "manual",
      "address": "192.168.1.100",
      "prefix": 24,
      "gateway": "",
      "dns": ""
    }
  },
  {
    "connection": {
      "enabled": true,
      "type": "wifi",
      "id": "WiFi connection 1",
      "interface-name": "wlp4s0"
    },
    "ipv4": {
      "method": "auto",
      "address": "",
      "prefix": 24,
      "gateway": "",
      "dns": ""
    },
    "wifi": {
      "ssid": "The name of your WiFi network"
    },
    "wifi-security": {
      "psk": "Your WiFi password",
      "auth-alg": "open",
      "key-mgmt": "wpa-psk"
    }
  },
  {
    "connection": {
      "enabled": false,
      "type": "hotspot",
      "id": "WiFi hotspot 1",
      "interface-name": "wlp4s0"
    },
    "wifi": {
      "ssid": "The name of your WiFi network",
      "channel": 9
    },
    "wifi-security": {
      "psk": "Your WiFi password",
      "key-mgmt": "wpa-psk"
    }
  },
  {
    "connection": {
      "enabled": false,
      "type": "gsm",
      "id": "GSM connection 1",
      "interface-name": "cdc-wdm0"
    },
    "gsm": {
      "apn": "arkessa.com",
      "username": "arkessa",
      "password": "arkessa"
    }
  }
]

ARM7 Based Devices

ARM7 based devices include the iaconnects mini gateway, and the RaspberryPi (ARM7 Network File Example)

[
  {
    "connection": {
      "enabled": true,
      "type": "ethernet",
      "id": "Wired connection 1",
      "interface-name": "eth0"
    },
    "ipv4": {
      "method": "auto",
      "address": "",
      "prefix": 24,
      "gateway": "",
      "dns": ""
    }
  },
  {
    "connection": {
      "enabled": true,
      "type": "wifi",
      "id": "WiFi connection 1",
      "interface-name": "wlan0"
    },
    "ipv4": {
      "method": "auto",
      "address": "",
      "prefix": 24,
      "gateway": "",
      "dns": ""
    },
    "wifi": {
      "ssid": "The name of your WiFi network"
    },
    "wifi-security": {
      "psk": "Your WiFi password",
      "auth-alg": "open",
      "key-mgmt": "wpa-psk"
    }
  },
  {
    "connection": {
      "enabled": false,
      "type": "hotspot",
      "id": "WiFi hotspot 1",
      "interface-name": "wlan0"
    },
    "wifi": {
      "ssid": "The name of your WiFi network"
      "channel": 9
    },
    "wifi-security": {
      "psk": "Your WiFi password",
      "key-mgmt": "wpa-psk"
    }
  }
]