Mistake on this page? Email us

Setting up a Wi-Fi connection

To connect your device to the cloud, you must use either Ethernet or Wi-Fi. Izuma Edge officially supports connection over Ethernet. However, if you don't have access to Ethernet or an Ethernet cable, you can connect your device to your home Wi-Fi router, access the terminal and manually configure the Wi-Fi settings.

Note: This is not an officially supported feature. It has been tested with consumer or standard Wi-Fi networks and not with corporate networks or mobile hotspots. We recommend you connect your Raspberry Pi with an Ethernet cable to a network with Internet access.


Before you can start this process, you need:

  • Izuma Edge 2.4+ installed on a Wi-Fi supported target (having followed the quick start guide).
  • Internet access.
  • Router supporting DHCP.
  • Ethernet cable or access point, or Wi-Fi enabled router.

Setting up the Wi-Fi connection

Follow these steps to set up a Wi-Fi connection:

  1. Shell or serial into the gateway. There is only one login user by default, fio. The default password is set to fio.

  2. Connect to the Wi-Fi network using the NetworkManager command-line tool:

    sudo nmcli device wifi connect <your_ssid> password <your_wifi_password>
  3. We have observed packet loss and abrupt network disconnection when both wired (ethernet) and wireless are enabled at the same time on the gateway. To provide wireless connectivity to your gateway, disconnect the ethernet cable and reboot your gateway. It should come back up and connect with your Wi-Fi AP.

  4. Run this command to determine whether your Pi has acquired an IP on wlan0 interface:

    ifconfig wlan0
  5. Ping an external IP address to test your connectivity:

    ping -I wlan0

    If successful, you should see something like:

    PING ( 56(84) bytes of data.
    64 bytes from icmp_seq=1 ttl=56 time=3.10 ms
    64 bytes from icmp_seq=2 ttl=56 time=4.27 ms
    --- ping statistics ---
    2 packets transmitted, 2 received, 0% packet loss, time 2ms
    rtt min/avg/max/mdev = 3.097/3.682/4.268/0.588 ms


For troubleshooting information, please see:

  • NetworkManager, which is configured by default in the Izuma Edge Linux microPlatform (LmP) image to manage the network configurations.
  • ip Linux man page.