Updating mesh instructions

This commit is contained in:
Bob Mottram 2018-06-15 22:46:04 +01:00
parent c51e4d268e
commit 1210f0926c
1 changed files with 48 additions and 2 deletions

View File

@ -35,12 +35,36 @@ The MultiWriter tool is also available within mesh client images, so that you ca
"Client" isn't exactly the right term, but it's a mesh peer with a user interface. These images can be copied to a USB drive, then you can plug it into a laptop/netbook/desktop machine and boot from it. You will probably also need an Atheros USB wifi dongle (the black protruding object on the left side of the netbook in the picture above), because most built-in wifi usually requires proprietary firmware. In the commands below substitute /dev/sdX with the USB drive device, excluding any trailing numbers (eg. /dev/sdb). The USB drive you're copying to will need to be at least 16GB in size. "Client" isn't exactly the right term, but it's a mesh peer with a user interface. These images can be copied to a USB drive, then you can plug it into a laptop/netbook/desktop machine and boot from it. You will probably also need an Atheros USB wifi dongle (the black protruding object on the left side of the netbook in the picture above), because most built-in wifi usually requires proprietary firmware. In the commands below substitute /dev/sdX with the USB drive device, excluding any trailing numbers (eg. /dev/sdb). The USB drive you're copying to will need to be at least 16GB in size.
Install some prerequisites:
#+begin_src bash #+begin_src bash
sudo apt-get install xz-utils wget sudo apt-get install xz-utils wget
#+end_src
To download images with dat:
#+begin_src bash
dat clone dat://e2ed9767d6ab64f4c43a2adbce65af225133fec7ba95737f0a2f6ae292ba358e/
cd e2ed9767d6ab64f4c43a2adbce65af225133fec7ba95737f0a2f6ae292ba358e
#+end_src
Or to download images directly with wget (may be slower):
#+begin_src bash
wget https://freedombone.net/downloads/v31/freedombone-meshclient-i386.img.xz wget https://freedombone.net/downloads/v31/freedombone-meshclient-i386.img.xz
wget https://freedombone.net/downloads/v31/freedombone-meshclient-i386.img.xz.sig wget https://freedombone.net/downloads/v31/freedombone-meshclient-i386.img.xz.sig
#+end_src
Check the signature:
#+begin_src bash
gpg --verify freedombone-meshclient-i386.img.xz.sig gpg --verify freedombone-meshclient-i386.img.xz.sig
unxz freedombone-meshclient-i386.img.xz unxz freedombone-meshclient-i386.img.xz
#+end_src
Then clone to the USB drive, where sdX is your USB device:
#+begin_src bash
sudo dd if=/dev/zero of=/dev/sdX bs=32M count=8 sudo dd if=/dev/zero of=/dev/sdX bs=32M count=8
sudo dd bs=32M if=freedombone-meshclient-i386.img of=/dev/sdX conv=fdatasync,sync,noerror sudo dd bs=32M if=freedombone-meshclient-i386.img of=/dev/sdX conv=fdatasync,sync,noerror
#+end_src #+end_src
@ -49,12 +73,36 @@ To get a number of systems onto the mesh repeat the /dd/ command to create howev
If you're in an emergency and don't have Atheros wifi dongles then there is also an "insecure" image which contains some proprietary wifi drivers which may work with a wider range of laptops. Proprietary drivers *are not recommended* because they're unsupportable and may be exploitable or contain malicious antifeatures which fundamentally compromise the security of the network. However, the trade-off between security/maintainability and simply having the ability to communicate at all may be a valid one in some situations. If you're in an emergency and don't have Atheros wifi dongles then there is also an "insecure" image which contains some proprietary wifi drivers which may work with a wider range of laptops. Proprietary drivers *are not recommended* because they're unsupportable and may be exploitable or contain malicious antifeatures which fundamentally compromise the security of the network. However, the trade-off between security/maintainability and simply having the ability to communicate at all may be a valid one in some situations.
Install some prerequisites:
#+begin_src bash #+begin_src bash
sudo apt-get install xz-utils wget sudo apt-get install xz-utils wget
#+end_src
To download images with dat:
#+begin_src bash
dat clone dat://6d1b73d13b6f9b5c481c6dfd64be6aa58e1cd2d153a6bb04bbc177999ee9925e/
cd 6d1b73d13b6f9b5c481c6dfd64be6aa58e1cd2d153a6bb04bbc177999ee9925e
#+end_src
Or to download images directly with wget (may be slower):
#+begin_src bash
wget https://freedombone.net/downloads/v31/freedombone-meshclient-insecure-i386.img.xz wget https://freedombone.net/downloads/v31/freedombone-meshclient-insecure-i386.img.xz
wget https://freedombone.net/downloads/v31/freedombone-meshclient-insecure-i386.img.xz.sig wget https://freedombone.net/downloads/v31/freedombone-meshclient-insecure-i386.img.xz.sig
#+end_src
Check the signature:
#+begin_src bash
gpg --verify freedombone-meshclient-insecure-i386.img.xz.sig gpg --verify freedombone-meshclient-insecure-i386.img.xz.sig
unxz freedombone-meshclient-insecure-i386.img.xz unxz freedombone-meshclient-insecure-i386.img.xz
#+end_src
Then clone to the USB drive, where sdX is your USB device:
#+begin_src bash
sudo dd if=/dev/zero of=/dev/sdX bs=32M count=8 sudo dd if=/dev/zero of=/dev/sdX bs=32M count=8
sudo dd bs=32M if=freedombone-meshclient-insecure-i386.img of=/dev/sdX conv=fdatasync,sync,noerror sudo dd bs=32M if=freedombone-meshclient-insecure-i386.img of=/dev/sdX conv=fdatasync,sync,noerror
#+end_src #+end_src
@ -72,8 +120,6 @@ sudo apt-get install xz-utils wget
wget https://freedombone.net/downloads/v31/freedombone-mesh_beaglebone-armhf.img.xz wget https://freedombone.net/downloads/v31/freedombone-mesh_beaglebone-armhf.img.xz
wget https://freedombone.net/downloads/v31/freedombone-mesh_beaglebone-armhf.img.xz.sig wget https://freedombone.net/downloads/v31/freedombone-mesh_beaglebone-armhf.img.xz.sig
gpg --verify freedombone-mesh_beaglebone-armhf.img.xz.sig gpg --verify freedombone-mesh_beaglebone-armhf.img.xz.sig
sha256sum freedombone-mesh_beaglebone-armhf.img.xz
ad8f22c0d46c98a80aa47b5809402971cf5cf26ebf587c59a667307b2386c3d2
unxz freedombone-mesh_beaglebone-armhf.img.xz unxz freedombone-mesh_beaglebone-armhf.img.xz
sudo dd bs=32M if=freedombone-mesh_beaglebone-armhf.img of=/dev/sdX conv=fdatasync,sync,noerror sudo dd bs=32M if=freedombone-mesh_beaglebone-armhf.img of=/dev/sdX conv=fdatasync,sync,noerror
#+end_src #+end_src