Skip to content

Latest commit

 

History

History
55 lines (28 loc) · 3.21 KB

tg-rp3-installation.md

File metadata and controls

55 lines (28 loc) · 3.21 KB
Raw

How-To Install Bell-Apps on a Raspberry Pi 3

Introduction

If you have completed the on-boarding steps as part of the Virtual Intern program, then you have all of the skills and knowledge needed to complete an installation of Bell-Apps on a Raspberry Pi.

Note: Although Bell-Apps will run on any hardware, we designed it for the RPi as it represents the most affordable option for delivering content and services.

This installation guide is tailored for the RPi 3. It will configure the RPi to run a local Wi-Fi network that can serve content without a router.

Prerequisites

In order to complete this installation, we will need a few hardware and software components as follows:

  • Raspberry Pi 3 and 5V 2.4A power supply with microUSB connector

  • An internet connection and a RJ45 Ethernet cable

  • A microSD card reader

  • A Class 10 microSD card (minimal 16GB, but we recommend 32GB or greater)

  • Software for burning OS image to microSD card. We recommend Etcher, but there are many from which to choose

  • Unzipped OLE's latest stable image for RPi

Installation Steps

  1. Burn the image to the microSD card. This is a simple process with Etcher - select the image, select the microSD card and burn the image;

  2. Once it's done burning, remount the microSD card if its unmounted by Etcher, so that you can view the contents in the boot partition. You will see a long list of files as follows:

file list

  1. In order for the installation to complete, we must create a small text file called autorunonce and place it in the boot partition of the microSD card.

Note: There are two versions of the autorunonce file. One for the RPi 3 alone and one for the RPi 3 + Real Time Clock (RTC).

  • Open any text editor (not a word processing program)

  • Save the file with name autorunonce and place it in the boot partition of the microSD card.

  1. Unmount and remove the microSD card from the card reader and place it into the RPi.

  2. Connect a RJ45 network cable to the Ethernet port on the RPi.

  3. Connect the RPi to power.

Note: The RPi will download Bell-Apps, install community, create database, and reboot a few times to complete the installation. It may take 10 - 15 minutes or longer depending on your internet connection. This is a one-time process. Future boots will be much faster.

  1. Before we can access the new Bell-Apps, you need to connect your device to the treehouse Wi-Fi hotspot created by the RPi. Once connected, you should be able to access Bell-Apps by going to http://192.168.2.1:5984/apps/_design/bell/MyApp/index.html.