1. Connect

« Previous step: Required Hardware

Next step: Install »

This guide assumes you are using an emonPi / emonBase pre-built SD card.

This SD card can be purchased from the shop or downloaded:

The emonPi runs the Emoncms data logging web-app locally from emonPi’s internal web sever. Using Emoncms data can be logged locally to the emonPi’s SD card and (optionally) posted remotely to the Emoncms.org cloud server.

Emoncms local: Emoncms instance running locally on the emonPi
Emoncms remote: Emoncms.org cloud server.

emonPi First Boot Ethernet

  • 1.2A USB power adapter recommended

  • Take care to connect the Ethernet to the socket on the same side as the USB sockets, not the RJ45 connector on the opposite side.

  • The emonPi LCD display will display firmware version then scan for connected sensors. Once the Raspberry Pi has booted up, the LCD will display the IP address of the emonPi on the local network.
  • Ethernet Connected
  • Browsing the hostname will work on some networks: http://emonpi
  • If using an emonBase and hostname does not work, look up its IP address from your router or use the Fing Network Discovery tool on Android and iOS.

  • By default only a single (admin) account can be created on the local emonPi Emoncms. To enable multiple accounts edit Emoncms settings in /var/www/emoncms/settings.php

WiFi is optional and requires either a RaspberryPi 3 (integrated WiFi) or a USB WiFi dongle (Edimax EW7811UN).

Note: All emonPis shipped June 2016 onwards will have a Raspberry Pi 3 as standard, emonPis with a Pi3 can be identified by a plastic end-plate(s). See blog post.

Connect to Wifi

  1. Wifi config in local Emoncms : Setup > Wi-Fi
    • Network scan should happen automatically.
  2. Check the box to select the network(s) you want to connect to

  3. Enter PSK password

  4. Hit Save and Connect

After a few seconds information should refresh automatically to report Status: Connected and after a few more seconds the IP address should appear.

Huawei HiLink 3G USB GSM/3G dongle modems are supported. Connection should be automatic and LCD will display connection status. (Tested with Huawei E3231 and E3131).

GSM Documentation | WiFi Access -point setup (dev)

UPDATE HIGHLY RECOMMENDED: Now your emonPi is connected to a network this would be a good time to pull in any new updates: Setup > Admin > Update

Shut down the emonPi by holding down the shutdown button for 5 seconds, then wait 30 seconds for unit to fully shut down.

Unplugging power from the emonPi without following the correct shutdown procedure can result in a corrupted SD card.

The emonPi is now ready to be physically installed and the sensors connected.

Video Guide

Next step: Install »