Raspberry Pi Image

Using the pre-built Raspberry Pi Image

We have created an customised version of the Raspberry Pi Lite image with Cumulus MX pre-installed and ready to go.

This is designed to be what is called a "headless" installation, that is you can run it on a Raspberry Pi without a monitor or keyboard attached to it. As such the image does not contain a GUI, it is a command line only installation.

Pre-Installation Steps

You are going to need:

• A suitable SD card for your Raspberry Pi

A minimum size of 16GB is recommended. Be sure to buy a good quality card.

• An image installer to copy the image file to the SD card

The Raspberry Pi site has a list of suitable software for your operating system. Scroll down to "Writing the image".

• The image file to install

Download the latest image file [from here].

• An SSH terminal program to configure your Raspberry Pi

For Windows we recommend using PuTTY

Installing the Image

This installation was performed on a Windows computer using the Win32DiskImager software

• Extract the xxx.img file from the image zip file you downloaded earlier.
• Insert your blank SD card into your computer - if not blank whatever is on the card will be erased.
• Start Win32DiskImager

• Click the folder icon next to the Image File box, and navigate to the folder where you extracted the Pi image

  [Win32DiskImager-01.png]

• Select the SD card from the Device dropdown - check you have the correct drive selected!

  [Win32DiskImager-02.png]

• Click the Write button. Writing the image will take a few minutes
• Once the image has finished been written, you can close Win32DiskImager
  
  

• OPTIONAL - If you wish to connect your Pi to the network using WiFi from the first boot, then you will need to follow these additional steps.

  Note. If you connect via an cabled network, you can always configure the WiFi later using the command line

• Locate the SD drive in File Explorer.
• On the SD drive create a file called wpa_supplicant.conf
• Edit this file with a text editor and paste the following text into it..

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=<Insert 2 letter ISO 3166-1 country code here>
network={
 ssid="<Name of your wireless LAN>"
 psk="<Password for your wireless LAN>"
}

• Change the country code to match your location - eg. US, GB, FR etc
• Set the ssid to match your WiFi id
• Set the psk to your WiFi password
• Save the file
  
  

• Eject the SD card from your computer and insert it into your Raspberry Pi

First Boot

• Connect the Pi to your wired network if you did not configure the WiFi as per the steps above.
• Power on the Pi.
• Now wait 5 minutes. The first boot will be resizing your disk and optionally configuring your WiFi.
• Start your browser and see if you can connect to this URL: http://cumulusmx:8998

• If you can great - you should now see the Cumulus MX console
• If not, then you will have to find out the Raspberry Pi's IP address from your router. Then try connecting to this URL: http://<ip_address>:8998