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
- Click the folder icon next to the Image File box, and navigate to the folder where you extracted the Pi image
- 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