Vaani for the Raspberry Pi
Перейти к файлу
Kelly Davis 53d061a0c5
Merge pull request #13 from Mozilla-GitHub-Standards/master
Add Mozilla Code of Conduct
2019-04-01 10:16:57 +02:00
client Only restart vaani if an update happens 2016-08-30 19:32:55 +01:00
setup Fixed typo in client setup script 2016-08-16 18:05:02 +02:00
updater Only restart vaani if an update happens 2016-08-30 19:32:55 +01:00
.gitignore First draft of the scripts; converted from Andre Natal's Edison version 2016-08-12 15:45:02 +02:00
CODE_OF_CONDUCT.md Add Mozilla Code of Conduct file 2019-03-29 15:02:19 -07:00
LICENSE Initial commit 2016-08-11 16:12:42 +02:00
README.md Some final sentence in the README 2016-08-19 16:01:03 +02:00
bootstrap.sh Cross compilation support (not working yet) 2016-08-19 14:11:55 +02:00
clean.sh Added file system zeroing to the clean script. 2016-08-19 16:01:41 +02:00
cross-build.sh Cross compilation support (not working yet) 2016-08-19 14:11:55 +02:00
cross-chroot-script.sh Cross compilation support (not working yet) 2016-08-19 14:11:55 +02:00
cross-chroot.sh Cross compilation support (not working yet) 2016-08-19 14:11:55 +02:00
cross-compile-prepare.sh Cross compilation support (not working yet) 2016-08-19 14:11:55 +02:00
cross-compile.sh Cross compilation support (not working yet) 2016-08-19 14:11:55 +02:00
cross-finalize-image.sh Cross compilation support (not working yet) 2016-08-19 14:11:55 +02:00
cross-prepare-image.sh Cross compilation support (not working yet) 2016-08-19 14:11:55 +02:00
install-prereqs.sh Fixed Issue #8 2016-08-29 10:29:56 +02:00
setup.sh Added top level setup script 2016-08-15 15:01:46 +00:00

README.md

Vaani for the Raspberry Pi

Installs and maintains a Vaani Appliance for the Raspberry Pi

Prerequisites

  • Raspberry Pi 3(!) board (plus power support)
  • Recent Raspbian image
  • Micro SD card of at least 4GB size
  • Ethernet patch cable (plus USB or Thunderbolt adapter if needed)

Creating the image

Preparing the SD card

Insert the SD card into your card reader. For the sake of simplicity you should choose a rather small one, if you want to redistribute the final image. Shrinking the SD card image after this installation process is complicated and tedious.

You can download the Raspbian image from [here][]. Uncompress the archive with your preferred unarchiver (on Mac this should work automatically). Then flash the raw image to the SD card using your preferred SD card flashing tool or dd. E.g. on Mac you can use [Apple Pi Baker][http://www.tweaking4all.com/hardware/raspberry-pi/macosx-apple-pi-baker/] for this ([download link][http://www.tweaking4all.com/?wpfb_dl=94 ]). If the SD card is ready, you should now put it into your Pi.

Connect to the Pi

Connect the Pi to your local network or directly to your computer using a patch cable (and an adapter if needed). Boot it up by connecting it to the power supply.

Time to SSH into the Pi: The Raspberry Pi's SSH is already running - its mDNS name is raspberry.local. Prepare your computer or network accordingly.

E.g. if you want to connect it directly to you Mac, you can execute the following:

sudo /usr/libexec/bootpd -D -d -i en0

If everything is set up, you can finally call

ssh -l pi raspberrypi.local

to connect (password: raspberry).

If the Pi is not connected to your home network yet, you somehow have to give it internet access. This is how you could for example connect it to some wifi access point:

sudo iwconfig wlan0 essid "access point name" key "your secret access point key"
sudo dhclient wlan0

For open wifi networks you can leave out the key part. In some cases you first have to do sudo iwdown wlan0 and/or sudo iwup wlan0.

Finally you can start the setup process by:

wget https://raw.githubusercontent.com/mozilla/vaani.raspberrypi/master/bootstrap.sh
sudo bash bootstrap.sh

This will take quite a while. Once finished, you can reboot the Pi and/or save and distribute an image of the SD card.