Browse Source

Updating mesh instructions

Bob Mottram 6 years ago
parent
commit
1210f0926c
1 changed files with 48 additions and 2 deletions
  1. 48
    2
      doc/EN/mesh_images.org

+ 48
- 2
doc/EN/mesh_images.org View File

35
 
35
 
36
 "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.
36
 "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.
37
 
37
 
38
+Install some prerequisites:
39
+
38
 #+begin_src bash
40
 #+begin_src bash
39
 sudo apt-get install xz-utils wget
41
 sudo apt-get install xz-utils wget
42
+#+end_src
43
+
44
+To download images with dat:
45
+
46
+#+begin_src bash
47
+dat clone dat://e2ed9767d6ab64f4c43a2adbce65af225133fec7ba95737f0a2f6ae292ba358e/
48
+cd e2ed9767d6ab64f4c43a2adbce65af225133fec7ba95737f0a2f6ae292ba358e
49
+#+end_src
50
+
51
+Or to download images directly with wget (may be slower):
52
+
53
+#+begin_src bash
40
 wget https://freedombone.net/downloads/v31/freedombone-meshclient-i386.img.xz
54
 wget https://freedombone.net/downloads/v31/freedombone-meshclient-i386.img.xz
41
 wget https://freedombone.net/downloads/v31/freedombone-meshclient-i386.img.xz.sig
55
 wget https://freedombone.net/downloads/v31/freedombone-meshclient-i386.img.xz.sig
56
+#+end_src
57
+
58
+Check the signature:
59
+
60
+#+begin_src bash
42
 gpg --verify freedombone-meshclient-i386.img.xz.sig
61
 gpg --verify freedombone-meshclient-i386.img.xz.sig
43
 unxz freedombone-meshclient-i386.img.xz
62
 unxz freedombone-meshclient-i386.img.xz
63
+#+end_src
64
+
65
+Then clone to the USB drive, where sdX is your USB device:
66
+
67
+#+begin_src bash
44
 sudo dd if=/dev/zero of=/dev/sdX bs=32M count=8
68
 sudo dd if=/dev/zero of=/dev/sdX bs=32M count=8
45
 sudo dd bs=32M if=freedombone-meshclient-i386.img of=/dev/sdX conv=fdatasync,sync,noerror
69
 sudo dd bs=32M if=freedombone-meshclient-i386.img of=/dev/sdX conv=fdatasync,sync,noerror
46
 #+end_src
70
 #+end_src
49
 
73
 
50
 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.
74
 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.
51
 
75
 
76
+Install some prerequisites:
77
+
52
 #+begin_src bash
78
 #+begin_src bash
53
 sudo apt-get install xz-utils wget
79
 sudo apt-get install xz-utils wget
80
+#+end_src
81
+
82
+To download images with dat:
83
+
84
+#+begin_src bash
85
+dat clone dat://6d1b73d13b6f9b5c481c6dfd64be6aa58e1cd2d153a6bb04bbc177999ee9925e/
86
+cd 6d1b73d13b6f9b5c481c6dfd64be6aa58e1cd2d153a6bb04bbc177999ee9925e
87
+#+end_src
88
+
89
+Or to download images directly with wget (may be slower):
90
+
91
+#+begin_src bash
54
 wget https://freedombone.net/downloads/v31/freedombone-meshclient-insecure-i386.img.xz
92
 wget https://freedombone.net/downloads/v31/freedombone-meshclient-insecure-i386.img.xz
55
 wget https://freedombone.net/downloads/v31/freedombone-meshclient-insecure-i386.img.xz.sig
93
 wget https://freedombone.net/downloads/v31/freedombone-meshclient-insecure-i386.img.xz.sig
94
+#+end_src
95
+
96
+Check the signature:
97
+
98
+#+begin_src bash
56
 gpg --verify freedombone-meshclient-insecure-i386.img.xz.sig
99
 gpg --verify freedombone-meshclient-insecure-i386.img.xz.sig
57
 unxz freedombone-meshclient-insecure-i386.img.xz
100
 unxz freedombone-meshclient-insecure-i386.img.xz
101
+#+end_src
102
+
103
+Then clone to the USB drive, where sdX is your USB device:
104
+
105
+#+begin_src bash
58
 sudo dd if=/dev/zero of=/dev/sdX bs=32M count=8
106
 sudo dd if=/dev/zero of=/dev/sdX bs=32M count=8
59
 sudo dd bs=32M if=freedombone-meshclient-insecure-i386.img of=/dev/sdX conv=fdatasync,sync,noerror
107
 sudo dd bs=32M if=freedombone-meshclient-insecure-i386.img of=/dev/sdX conv=fdatasync,sync,noerror
60
 #+end_src
108
 #+end_src
72
 wget https://freedombone.net/downloads/v31/freedombone-mesh_beaglebone-armhf.img.xz
120
 wget https://freedombone.net/downloads/v31/freedombone-mesh_beaglebone-armhf.img.xz
73
 wget https://freedombone.net/downloads/v31/freedombone-mesh_beaglebone-armhf.img.xz.sig
121
 wget https://freedombone.net/downloads/v31/freedombone-mesh_beaglebone-armhf.img.xz.sig
74
 gpg --verify freedombone-mesh_beaglebone-armhf.img.xz.sig
122
 gpg --verify freedombone-mesh_beaglebone-armhf.img.xz.sig
75
-sha256sum freedombone-mesh_beaglebone-armhf.img.xz
76
-ad8f22c0d46c98a80aa47b5809402971cf5cf26ebf587c59a667307b2386c3d2
77
 unxz freedombone-mesh_beaglebone-armhf.img.xz
123
 unxz freedombone-mesh_beaglebone-armhf.img.xz
78
 sudo dd bs=32M if=freedombone-mesh_beaglebone-armhf.img of=/dev/sdX conv=fdatasync,sync,noerror
124
 sudo dd bs=32M if=freedombone-mesh_beaglebone-armhf.img of=/dev/sdX conv=fdatasync,sync,noerror
79
 #+end_src
125
 #+end_src