Skip to content

Tutorial

David Steele edited this page Oct 3, 2017 · 14 revisions

Get any required Host software

The host device will need a web browser and a Secure Shell (SSH) application. For some operating systems, a Zeroconf Browser is needed. Refer to the table.

OS SSH ZeroConf Browser
Windows Putty Bonjour Browser
Mac (included) (not required)
Linux (included) avahi-discover (not required)
IOS Termius (not required)
Android JuiceSSH ZeroConf Browser (optional)

Download the Comitup Image

Find the link on the Comitup Home Page for the download links. You may need a Bittorrent Client for the download.

Once the image is downloaded, use an unzip utility to restore the original image.

Copy the image to a microSD card

The microSD card must be larger than 4GB (except for the 'lite' image).

For Windows, this is covered in the Raspberry Pi Quick Start Guide, steps 3 & 4.

The Raspberry Pi Website has copying instructions for Linux, Mac OS, and Windows.

Boot the Raspberry Pi 3

Insert the microSD card into the Raspberry Pi 3, and apply power. The first boot will take a couple of minutes, while the system makes some initial configuration changes.

Connect to the Comitup Hotspot

Using a Wifi-enabled computer, smart phone, or tablet, view a list of available Wifi Access Points. You should see one named 'comitup-' followed by 4 digits (remember this number). Connect to this Hotspot.

If all you want to do is connect with the Pi, you are done at this point. Connect via ssh to pi@raspberrypi.local or pi@comitup-<nnnn>.local, or to pi@10.42.0.1. If you want your Pi and workstation to also have connectivity to the Internet, continue to the next step.

Connect the Raspberry Pi to your Wifi Access Point

While connected to the Comitup Access Point, browse to http://comitup-nnnn.local (using the 4 digits from earlier) or to 'http://raspberrypi.local'. If you are using an operating system that does not understand these ',local' addresses, you can cheat and use http://10.42.0.1.

You should see a list of available Access Points. Select one, enter a password if necessary, and click on 'Connect'.

Start Computing!

Connect your computer/phone/tablet to the same Access Point. Use SSH to open a terminal session to pi@raspberrypi.local, or to pi@comitup-<nnnn>.local, where <nnnn> is the 4 digits from the access point earlier. If the name is not recognized, use a Zeroconf Browser to identify the Raspberry Pi IP address.

A good first step at this point is to update your operating system to the latest packages:

sudo apt-get update
sudo apt-get upgrade
sudo apt-get dist-upgrade

The default password for the "pi" user is "raspberry". Be sure to change it once you have logged in:

passwd

Enjoy!

Clone this wiki locally
You can’t perform that action at this time.