Browse Source

Merge branch 'stretch' of https://github.com/bashrc/freedombone

Bob Mottram 7 years ago
parent
commit
7bb41c166c
4 changed files with 135 additions and 81 deletions
  1. 19
    0
      doc/EN/mesh.org
  2. 8
    7
      src/freedombone-app-searx
  3. 7
    0
      src/freedombone-image-customise
  4. 101
    74
      website/EN/mesh.html

+ 19
- 0
doc/EN/mesh.org View File

22
 | [[What the system can do]] | - | [[Disk Images]] | - | [[Building Disk Images]] | - | [[How to use it]] |
22
 | [[What the system can do]] | - | [[Disk Images]] | - | [[Building Disk Images]] | - | [[How to use it]] |
23
 |------------------------+---+-------------+---+----------------------+---+---------------|
23
 |------------------------+---+-------------+---+----------------------+---+---------------|
24
 
24
 
25
+#+begin_quote
26
+ "/I see mesh networks naturally evolving to become the dominant form of network over the next few decades, because it’s the most practical solution to a number of problems that will have to be solved in order to build the VR web as well as to connect the entire world to the internet. Centralized networks are only possible in highly developed countries with existing infrastructures like power and telephone grids, as well as roads. You can’t build a tower where you don’t have either power or access. For vast areas of the world, mesh networks will be the only feasible solution./" -- Valkyrie Ice
27
+#+end_quote
28
+
25
 The Freedombone Mesh is a wireless solution for autonomous communication that can be rapidly deployed in temporary, emergency or post-disaster situations where internet access is unavailable or compromised.
29
 The Freedombone Mesh is a wireless solution for autonomous communication that can be rapidly deployed in temporary, emergency or post-disaster situations where internet access is unavailable or compromised.
26
 
30
 
27
 Mesh networks are useful as a quick way to make a fully decentralised communications system which is not connected to or reliant upon the internet. Think festivals, hacker conferences, onboard ships at sea, disaster/war zones, small business internal office communications, protests, remote areas of the world, temporary "digital blackouts", scientific expeditions and off-world space colonies. The down side is that you can't access any internet content. The upside is that you can securely communicate with anyone on the local mesh. No ISPs. No payments or subscriptions beyond the cost of obtaining the hardware. Systems need to be within wifi range of each other for the mesh to be created. It can be an ultra-convenient way to do purely local communications.
31
 Mesh networks are useful as a quick way to make a fully decentralised communications system which is not connected to or reliant upon the internet. Think festivals, hacker conferences, onboard ships at sea, disaster/war zones, small business internal office communications, protests, remote areas of the world, temporary "digital blackouts", scientific expeditions and off-world space colonies. The down side is that you can't access any internet content. The upside is that you can securely communicate with anyone on the local mesh. No ISPs. No payments or subscriptions beyond the cost of obtaining the hardware. Systems need to be within wifi range of each other for the mesh to be created. It can be an ultra-convenient way to do purely local communications.
28
 
32
 
33
+The Freedombone mesh roughly follows MondoNet's ten social specifications:
34
+
35
+ - *Decentralized*: The network should not be operated, maintained, or in any way reliant upon a single or minimally differentiated set of entities or technologies. No individual, entity or group should be central to the network to the extent that their absence would measurably impact its functionality or scope. Network participation should not require access to fixed, physical infrastructure of any sort.
36
+ - *Universally Accessible*: The requisite technology and expertise required to participate in the network should be available at minimal cost and effort to every human being on the planet. Furthermore, all users should be able to extend the network’s content and functionality to suit their own needs, or those of others. No aspect of the network’s functioning should be reliant upon proprietary technologies, information or capital.
37
+ - *Censor-proof*: The network should be resistant to both regulatory and technical attempts to limit the nature of the information shared, restrict usage by given individuals or communities, or render the network, or any portion of it, inoperable or inaccessible.
38
+ - *Surveillance-proof*: The network should enable users to choose exactly what information they share with whom, and to participate anonymously if they so desire. Users should only have access to information if they are the designated recipients, or if it has been published openly.
39
+ - *Secure*: The network should be organized in a way that minimizes the risk of malicious attacks or engineering failure. Information exchanged on the network should meet or exceed the delivery rate and reliability of information exchanged via the Internet.
40
+ - *Scalable*: The network should be organized with the expectation that its scale could reach or even exceed that of today’s Internet. Special care should be taken to address to the challenge of maintaining efficiency without the presence of a centralized backbone.
41
+ - *Permanent*: The network’s density and redundancy should be great enough that, despite its ad hoc nature, it will persistently operate on a broad scale, and be available in full to any user within range of another peer.
42
+ - *Fast (enough)*: The network should always achieve whatever speed is required for a “bottom line” level of social and cultural participation. At present, we assert that the network’s data transfer rate should, at a minimum, be enough for voice-over-IP (VoIP) communications, and low-bitrate streaming video.
43
+ - *Independent*: While the network will have the capacity to exchange information with Internet users and nodes, it should be able to operate independently, as well. A large-scale failure or closure of Internet infrastructure and content should have minimal effect on the network’s operations.
44
+ - *Evolvable*: The network should be built with future development in mind. The platform should be flexible enough to support technologies, protocols and modes of usage that have not yet been developed.
45
+
29
 * What the system can do
46
 * What the system can do
30
 
47
 
31
  - Discovery of other users on the network
48
  - Discovery of other users on the network
58
 #+begin_src bash
75
 #+begin_src bash
59
 sudo apt-get install gnome-multi-writer
76
 sudo apt-get install gnome-multi-writer
60
 #+end_src
77
 #+end_src
78
+
79
+The MultiWriter tool is also available within mesh client images, so that you can use mesh systems to create more copies of the same system.
61
 ** Client images
80
 ** Client images
62
 
81
 
63
 #+BEGIN_CENTER
82
 #+BEGIN_CENTER

+ 8
- 7
src/freedombone-app-searx View File

442
     echo '    disabled: True' >> $settings_file
442
     echo '    disabled: True' >> $settings_file
443
     echo '' >> $settings_file
443
     echo '' >> $settings_file
444
     echo '  - name : gitlab' >> $settings_file
444
     echo '  - name : gitlab' >> $settings_file
445
-    echo '    engine : xpath' >> $settings_file
445
+    echo '    engine : json_engine' >> $settings_file
446
     echo '    paging : True' >> $settings_file
446
     echo '    paging : True' >> $settings_file
447
-    echo '    search_url : https://gitlab.com/search?page={pageno}&search={query}' >> $settings_file
448
-    echo '    url_xpath : //li[@class="project-row"]//a[@class="project"]/@href' >> $settings_file
449
-    echo '    title_xpath : //li[@class="project-row"]//span[contains(@class, "project-full-name")]' >> $settings_file
450
-    echo '    content_xpath : //li[@class="project-row"]//div[@class="description"]/p' >> $settings_file
447
+    echo '    search_url : https://gitlab.com/api/v4/projects?search={query}&page={pageno}' >> $settings_file
448
+    echo '    url_query : web_url' >> $settings_file
449
+    echo '    title_query : name_with_namespace' >> $settings_file
450
+    echo '    content_query : description' >> $settings_file
451
+    echo '    page_size : 20' >> $settings_file
451
     echo '    categories : code' >> $settings_file
452
     echo '    categories : code' >> $settings_file
452
     echo '    shortcut : gl' >> $settings_file
453
     echo '    shortcut : gl' >> $settings_file
453
-    echo '    timeout : 5.0' >> $settings_file
454
-    echo '    disabled : True' >> $settings_file
454
+    echo '    timeout : 10.0' >> $settings_file
455
+    echo '    disabled : False' >> $settings_file
455
     echo '' >> $settings_file
456
     echo '' >> $settings_file
456
     echo '  - name : github' >> $settings_file
457
     echo '  - name : github' >> $settings_file
457
     echo '    engine : github' >> $settings_file
458
     echo '    engine : github' >> $settings_file

+ 7
- 0
src/freedombone-image-customise View File

565
 PATCHWORK_COMMIT='60111a9e3385d65be0d17aa0d15fd20e5fb311ce'
565
 PATCHWORK_COMMIT='60111a9e3385d65be0d17aa0d15fd20e5fb311ce'
566
 
566
 
567
 install_patchwork() {
567
 install_patchwork() {
568
+    if [[ $VARIANT != "meshclient" ]]; then
569
+        return
570
+    fi
571
+
568
     get_npm_arch
572
     get_npm_arch
569
 
573
 
570
     git clone $PATCHWORK_REPO $rootdir/etc/patchwork
574
     git clone $PATCHWORK_REPO $rootdir/etc/patchwork
821
     # android adb to allow phones to be connected and for example transfer photos/documents
825
     # android adb to allow phones to be connected and for example transfer photos/documents
822
     chroot "$rootdir" apt-get -yq install android-tools-adb
826
     chroot "$rootdir" apt-get -yq install android-tools-adb
823
 
827
 
828
+    # USB cloning tool
829
+    chroot "$rootdir" apt-get -yq install gnome-multi-writer
830
+
824
     # Produce a text file on the desktop listing users on the mesh
831
     # Produce a text file on the desktop listing users on the mesh
825
     cat <<EOF > $rootdir/usr/bin/list-tox-users
832
     cat <<EOF > $rootdir/usr/bin/list-tox-users
826
 #!/bin/bash
833
 #!/bin/bash

+ 101
- 74
website/EN/mesh.html View File

3
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5
 <head>
5
 <head>
6
-<!-- 2017-09-18 Mon 11:40 -->
6
+<!-- 2017-09-23 Sat 21:46 -->
7
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
7
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
8
 <meta name="viewport" content="width=device-width, initial-scale=1" />
8
 <meta name="viewport" content="width=device-width, initial-scale=1" />
9
-<title></title>
9
+<title>&lrm;</title>
10
 <meta name="generator" content="Org mode" />
10
 <meta name="generator" content="Org mode" />
11
 <meta name="author" content="Bob Mottram" />
11
 <meta name="author" content="Bob Mottram" />
12
 <meta name="description" content="Turn the Beaglebone Black into a personal communications server"
12
 <meta name="description" content="Turn the Beaglebone Black into a personal communications server"
274
 </colgroup>
274
 </colgroup>
275
 <tbody>
275
 <tbody>
276
 <tr>
276
 <tr>
277
-<td class="org-left"><a href="#org81ddb36">What the system can do</a></td>
277
+<td class="org-left"><a href="#org802af98">What the system can do</a></td>
278
 <td class="org-left">-</td>
278
 <td class="org-left">-</td>
279
-<td class="org-left"><a href="#orgdc7c539">Disk Images</a></td>
279
+<td class="org-left"><a href="#org38eda48">Disk Images</a></td>
280
 <td class="org-left">-</td>
280
 <td class="org-left">-</td>
281
-<td class="org-left"><a href="#orgef64a0e">Building Disk Images</a></td>
281
+<td class="org-left"><a href="#org0c3a295">Building Disk Images</a></td>
282
 <td class="org-left">-</td>
282
 <td class="org-left">-</td>
283
-<td class="org-left"><a href="#orgf01387f">How to use it</a></td>
283
+<td class="org-left"><a href="#org5f6418e">How to use it</a></td>
284
 </tr>
284
 </tr>
285
 </tbody>
285
 </tbody>
286
 </table>
286
 </table>
287
 
287
 
288
+<blockquote>
289
+<p>
290
+"<i>I see mesh networks naturally evolving to become the dominant form of network over the next few decades, because it’s the most practical solution to a number of problems that will have to be solved in order to build the VR web as well as to connect the entire world to the internet. Centralized networks are only possible in highly developed countries with existing infrastructures like power and telephone grids, as well as roads. You can’t build a tower where you don’t have either power or access. For vast areas of the world, mesh networks will be the only feasible solution.</i>" &#x2013; Valkyrie Ice
291
+</p>
292
+</blockquote>
293
+
288
 <p>
294
 <p>
289
 The Freedombone Mesh is a wireless solution for autonomous communication that can be rapidly deployed in temporary, emergency or post-disaster situations where internet access is unavailable or compromised.
295
 The Freedombone Mesh is a wireless solution for autonomous communication that can be rapidly deployed in temporary, emergency or post-disaster situations where internet access is unavailable or compromised.
290
 </p>
296
 </p>
293
 Mesh networks are useful as a quick way to make a fully decentralised communications system which is not connected to or reliant upon the internet. Think festivals, hacker conferences, onboard ships at sea, disaster/war zones, small business internal office communications, protests, remote areas of the world, temporary "digital blackouts", scientific expeditions and off-world space colonies. The down side is that you can't access any internet content. The upside is that you can securely communicate with anyone on the local mesh. No ISPs. No payments or subscriptions beyond the cost of obtaining the hardware. Systems need to be within wifi range of each other for the mesh to be created. It can be an ultra-convenient way to do purely local communications.
299
 Mesh networks are useful as a quick way to make a fully decentralised communications system which is not connected to or reliant upon the internet. Think festivals, hacker conferences, onboard ships at sea, disaster/war zones, small business internal office communications, protests, remote areas of the world, temporary "digital blackouts", scientific expeditions and off-world space colonies. The down side is that you can't access any internet content. The upside is that you can securely communicate with anyone on the local mesh. No ISPs. No payments or subscriptions beyond the cost of obtaining the hardware. Systems need to be within wifi range of each other for the mesh to be created. It can be an ultra-convenient way to do purely local communications.
294
 </p>
300
 </p>
295
 
301
 
296
-<div id="outline-container-org81ddb36" class="outline-2">
297
-<h2 id="org81ddb36">What the system can do</h2>
298
-<div class="outline-text-2" id="text-org81ddb36">
302
+<p>
303
+The Freedombone mesh roughly follows MondoNet's ten social specifications:
304
+</p>
305
+
306
+<ul class="org-ul">
307
+<li><b>Decentralized</b>: The network should not be operated, maintained, or in any way reliant upon a single or minimally differentiated set of entities or technologies. No individual, entity or group should be central to the network to the extent that their absence would measurably impact its functionality or scope. Network participation should not require access to fixed, physical infrastructure of any sort.</li>
308
+<li><b>Universally Accessible</b>: The requisite technology and expertise required to participate in the network should be available at minimal cost and effort to every human being on the planet. Furthermore, all users should be able to extend the network’s content and functionality to suit their own needs, or those of others. No aspect of the network’s functioning should be reliant upon proprietary technologies, information or capital.</li>
309
+<li><b>Censor-proof</b>: The network should be resistant to both regulatory and technical attempts to limit the nature of the information shared, restrict usage by given individuals or communities, or render the network, or any portion of it, inoperable or inaccessible.</li>
310
+<li><b>Surveillance-proof</b>: The network should enable users to choose exactly what information they share with whom, and to participate anonymously if they so desire. Users should only have access to information if they are the designated recipients, or if it has been published openly.</li>
311
+<li><b>Secure</b>: The network should be organized in a way that minimizes the risk of malicious attacks or engineering failure. Information exchanged on the network should meet or exceed the delivery rate and reliability of information exchanged via the Internet.</li>
312
+<li><b>Scalable</b>: The network should be organized with the expectation that its scale could reach or even exceed that of today’s Internet. Special care should be taken to address to the challenge of maintaining efficiency without the presence of a centralized backbone.</li>
313
+<li><b>Permanent</b>: The network’s density and redundancy should be great enough that, despite its ad hoc nature, it will persistently operate on a broad scale, and be available in full to any user within range of another peer.</li>
314
+<li><b>Fast (enough)</b>: The network should always achieve whatever speed is required for a “bottom line” level of social and cultural participation. At present, we assert that the network’s data transfer rate should, at a minimum, be enough for voice-over-IP (VoIP) communications, and low-bitrate streaming video.</li>
315
+<li><b>Independent</b>: While the network will have the capacity to exchange information with Internet users and nodes, it should be able to operate independently, as well. A large-scale failure or closure of Internet infrastructure and content should have minimal effect on the network’s operations.</li>
316
+<li><b>Evolvable</b>: The network should be built with future development in mind. The platform should be flexible enough to support technologies, protocols and modes of usage that have not yet been developed.</li>
317
+</ul>
318
+
319
+<div id="outline-container-org802af98" class="outline-2">
320
+<h2 id="org802af98">What the system can do</h2>
321
+<div class="outline-text-2" id="text-org802af98">
299
 <ul class="org-ul">
322
 <ul class="org-ul">
300
 <li>Discovery of other users on the network</li>
323
 <li>Discovery of other users on the network</li>
301
 <li>Text based chat, one-to-one and in groups</li>
324
 <li>Text based chat, one-to-one and in groups</li>
317
 </div>
340
 </div>
318
 </div>
341
 </div>
319
 
342
 
320
-<div id="outline-container-orgdc7c539" class="outline-2">
321
-<h2 id="orgdc7c539">Disk Images</h2>
322
-<div class="outline-text-2" id="text-orgdc7c539">
343
+<div id="outline-container-org38eda48" class="outline-2">
344
+<h2 id="org38eda48">Disk Images</h2>
345
+<div class="outline-text-2" id="text-org38eda48">
323
 </div>
346
 </div>
324
-<div id="outline-container-org41eb788" class="outline-3">
325
-<h3 id="org41eb788">Writing many images quickly</h3>
326
-<div class="outline-text-3" id="text-org41eb788">
347
+<div id="outline-container-org2291a28" class="outline-3">
348
+<h3 id="org2291a28">Writing many images quickly</h3>
349
+<div class="outline-text-3" id="text-org2291a28">
327
 <p>
350
 <p>
328
 There may be situations where you need to write the same disk image to multiple drives at the same time in order to maximize rate of deployment. In the instructions given below the <b>dd</b> command is used for writing to the target drive, but to write to multiple drives you can use a tool such as <a href="https://wiki.gnome.org/Apps/MultiWriter">GNOME MultiWriter</a>.
351
 There may be situations where you need to write the same disk image to multiple drives at the same time in order to maximize rate of deployment. In the instructions given below the <b>dd</b> command is used for writing to the target drive, but to write to multiple drives you can use a tool such as <a href="https://wiki.gnome.org/Apps/MultiWriter">GNOME MultiWriter</a>.
329
 </p>
352
 </p>
333
 </p>
356
 </p>
334
 
357
 
335
 <div class="org-src-container">
358
 <div class="org-src-container">
336
-<pre><code class="src src-bash">sudo pacman -S gnome-multi-writer
337
-</code></pre>
359
+<pre class="src src-bash">sudo pacman -S gnome-multi-writer
360
+</pre>
338
 </div>
361
 </div>
339
 
362
 
340
 <p>
363
 <p>
342
 </p>
365
 </p>
343
 
366
 
344
 <div class="org-src-container">
367
 <div class="org-src-container">
345
-<pre><code class="src src-bash">sudo apt-get install gnome-multi-writer
346
-</code></pre>
368
+<pre class="src src-bash">sudo apt-get install gnome-multi-writer
369
+</pre>
347
 </div>
370
 </div>
371
+
372
+<p>
373
+The MultiWriter tool is also available within mesh client images, so that you can use mesh systems to create more copies of the same system.
374
+</p>
348
 </div>
375
 </div>
349
 </div>
376
 </div>
350
-<div id="outline-container-orgb7d45bb" class="outline-3">
351
-<h3 id="orgb7d45bb">Client images</h3>
352
-<div class="outline-text-3" id="text-orgb7d45bb">
377
+<div id="outline-container-orgd0546b8" class="outline-3">
378
+<h3 id="orgd0546b8">Client images</h3>
379
+<div class="outline-text-3" id="text-orgd0546b8">
353
 <div class="org-center">
380
 <div class="org-center">
354
 
381
 
355
 <div class="figure">
382
 <div class="figure">
363
 </p>
390
 </p>
364
 
391
 
365
 <div class="org-src-container">
392
 <div class="org-src-container">
366
-<pre><code class="src src-bash">sudo apt-get install xz-utils wget
393
+<pre class="src src-bash">sudo apt-get install xz-utils wget
367
 wget https://freedombone.net/downloads/current/freedombone-meshclient-i386.img.xz
394
 wget https://freedombone.net/downloads/current/freedombone-meshclient-i386.img.xz
368
 wget https://freedombone.net/downloads/current/freedombone-meshclient-i386.img.xz.sig
395
 wget https://freedombone.net/downloads/current/freedombone-meshclient-i386.img.xz.sig
369
 gpg --verify freedombone-meshclient-i386.img.xz.sig
396
 gpg --verify freedombone-meshclient-i386.img.xz.sig
372
 unxz freedombone-meshclient-i386.img.xz
399
 unxz freedombone-meshclient-i386.img.xz
373
 sudo dd <span class="org-variable-name">if</span>=/dev/zero <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">bs</span>=1M <span class="org-variable-name">count</span>=8
400
 sudo dd <span class="org-variable-name">if</span>=/dev/zero <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">bs</span>=1M <span class="org-variable-name">count</span>=8
374
 sudo dd <span class="org-variable-name">bs</span>=1M <span class="org-variable-name">if</span>=freedombone-meshclient-i386.img <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">conv</span>=fdatasync
401
 sudo dd <span class="org-variable-name">bs</span>=1M <span class="org-variable-name">if</span>=freedombone-meshclient-i386.img <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">conv</span>=fdatasync
375
-</code></pre>
402
+</pre>
376
 </div>
403
 </div>
377
 
404
 
378
 <p>
405
 <p>
384
 </p>
411
 </p>
385
 
412
 
386
 <div class="org-src-container">
413
 <div class="org-src-container">
387
-<pre><code class="src src-bash">sudo apt-get install xz-utils wget
414
+<pre class="src src-bash">sudo apt-get install xz-utils wget
388
 wget https://freedombone.net/downloads/current/freedombone-meshclient-insecure-i386.img.xz
415
 wget https://freedombone.net/downloads/current/freedombone-meshclient-insecure-i386.img.xz
389
 wget https://freedombone.net/downloads/current/freedombone-meshclient-insecure-i386.img.xz.sig
416
 wget https://freedombone.net/downloads/current/freedombone-meshclient-insecure-i386.img.xz.sig
390
 gpg --verify freedombone-meshclient-insecure-i386.img.xz.sig
417
 gpg --verify freedombone-meshclient-insecure-i386.img.xz.sig
393
 unxz freedombone-meshclient-insecure-i386.img.xz
420
 unxz freedombone-meshclient-insecure-i386.img.xz
394
 sudo dd <span class="org-variable-name">if</span>=/dev/zero <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">bs</span>=1M <span class="org-variable-name">count</span>=8
421
 sudo dd <span class="org-variable-name">if</span>=/dev/zero <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">bs</span>=1M <span class="org-variable-name">count</span>=8
395
 sudo dd <span class="org-variable-name">bs</span>=1M <span class="org-variable-name">if</span>=freedombone-meshclient-insecure-i386.img <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">conv</span>=fdatasync
422
 sudo dd <span class="org-variable-name">bs</span>=1M <span class="org-variable-name">if</span>=freedombone-meshclient-insecure-i386.img <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">conv</span>=fdatasync
396
-</code></pre>
423
+</pre>
397
 </div>
424
 </div>
398
 </div>
425
 </div>
399
 </div>
426
 </div>
400
 
427
 
401
-<div id="outline-container-orgb012fc0" class="outline-3">
402
-<h3 id="orgb012fc0">Router images</h3>
403
-<div class="outline-text-3" id="text-orgb012fc0">
428
+<div id="outline-container-orgefe9dc5" class="outline-3">
429
+<h3 id="orgefe9dc5">Router images</h3>
430
+<div class="outline-text-3" id="text-orgefe9dc5">
404
 <p>
431
 <p>
405
 Routers are intended to build network coverage for an area using small and low cost hardware. You can bolt them to walls or leave them on window ledges. They don't have any user interface and their only job is to haul network traffic across the mesh and to enable peers to find each other via running bootstrap nodes for Tox and IPFS. Copy the image to a microSD card and insert it into the router, plug in an Atheros wifi dongle and power on. That should be all you need to do.
432
 Routers are intended to build network coverage for an area using small and low cost hardware. You can bolt them to walls or leave them on window ledges. They don't have any user interface and their only job is to haul network traffic across the mesh and to enable peers to find each other via running bootstrap nodes for Tox and IPFS. Copy the image to a microSD card and insert it into the router, plug in an Atheros wifi dongle and power on. That should be all you need to do.
406
 </p>
433
 </p>
407
 </div>
434
 </div>
408
-<div id="outline-container-org86225c6" class="outline-4">
409
-<h4 id="org86225c6">Beaglebone Black</h4>
410
-<div class="outline-text-4" id="text-org86225c6">
435
+<div id="outline-container-org2f4e6c1" class="outline-4">
436
+<h4 id="org2f4e6c1">Beaglebone Black</h4>
437
+<div class="outline-text-4" id="text-org2f4e6c1">
411
 <div class="org-center">
438
 <div class="org-center">
412
 
439
 
413
 <div class="figure">
440
 <div class="figure">
421
 </p>
448
 </p>
422
 
449
 
423
 <div class="org-src-container">
450
 <div class="org-src-container">
424
-<pre><code class="src src-bash">sudo apt-get install xz-utils wget
451
+<pre class="src src-bash">sudo apt-get install xz-utils wget
425
 wget https://freedombone.net/downloads/v3/freedombone-mesh-3_beaglebone-armhf.img.xz
452
 wget https://freedombone.net/downloads/v3/freedombone-mesh-3_beaglebone-armhf.img.xz
426
 wget https://freedombone.net/downloads/v3/freedombone-mesh-3_beaglebone-armhf.img.xz.sig
453
 wget https://freedombone.net/downloads/v3/freedombone-mesh-3_beaglebone-armhf.img.xz.sig
427
 gpg --verify freedombone-mesh-3_beaglebone-armhf.img.xz.sig
454
 gpg --verify freedombone-mesh-3_beaglebone-armhf.img.xz.sig
429
 ab783ea807da1144bd076f7b43e54b5f4376ecf1ea1f86f56ac76c3469325802
456
 ab783ea807da1144bd076f7b43e54b5f4376ecf1ea1f86f56ac76c3469325802
430
 unxz freedombone-mesh-3_beaglebone-armhf.img.xz
457
 unxz freedombone-mesh-3_beaglebone-armhf.img.xz
431
 sudo dd <span class="org-variable-name">bs</span>=1M <span class="org-variable-name">if</span>=freedombone-mesh-3_beaglebone-armhf.img <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">conv</span>=fdatasync
458
 sudo dd <span class="org-variable-name">bs</span>=1M <span class="org-variable-name">if</span>=freedombone-mesh-3_beaglebone-armhf.img <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">conv</span>=fdatasync
432
-</code></pre>
459
+</pre>
433
 </div>
460
 </div>
434
 
461
 
435
 <p>
462
 <p>
444
 </div>
471
 </div>
445
 </div>
472
 </div>
446
 
473
 
447
-<div id="outline-container-orgef64a0e" class="outline-2">
448
-<h2 id="orgef64a0e">Building Disk Images</h2>
449
-<div class="outline-text-2" id="text-orgef64a0e">
474
+<div id="outline-container-org0c3a295" class="outline-2">
475
+<h2 id="org0c3a295">Building Disk Images</h2>
476
+<div class="outline-text-2" id="text-org0c3a295">
450
 <p>
477
 <p>
451
 It's better not to trust images downloaded from random places on the interwebs. Chances are that unless you are in the web of trust of the above GPG signatures then they don't mean very much to you. If you actually want something trustworthy then build the images from scratch. It will take some time. Here's how to do it.
478
 It's better not to trust images downloaded from random places on the interwebs. Chances are that unless you are in the web of trust of the above GPG signatures then they don't mean very much to you. If you actually want something trustworthy then build the images from scratch. It will take some time. Here's how to do it.
452
 </p>
479
 </p>
456
 </p>
483
 </p>
457
 
484
 
458
 <div class="org-src-container">
485
 <div class="org-src-container">
459
-<pre><code class="src src-bash">sudo apt-get -y install git wget build-essential
486
+<pre class="src src-bash">sudo apt-get -y install git wget build-essential
460
 wget https://freedombone.net/downloads/v3/freedombone-3.tar.gz
487
 wget https://freedombone.net/downloads/v3/freedombone-3.tar.gz
461
 wget https://freedombone.net/downloads/freedombone-3.tar.gz.sig
488
 wget https://freedombone.net/downloads/freedombone-3.tar.gz.sig
462
 gpg --verify freedombone-3.tar.gz.sig
489
 gpg --verify freedombone-3.tar.gz.sig
468
 sudo make install
495
 sudo make install
469
 freedombone-image --setup debian
496
 freedombone-image --setup debian
470
 freedombone-image -t i386 -v meshclient
497
 freedombone-image -t i386 -v meshclient
471
-</code></pre>
498
+</pre>
472
 </div>
499
 </div>
473
 
500
 
474
 <p>
501
 <p>
476
 </p>
503
 </p>
477
 
504
 
478
 <div class="org-src-container">
505
 <div class="org-src-container">
479
-<pre><code class="src src-bash">freedombone-image -t i386 -v meshclient --insecure yes
480
-</code></pre>
506
+<pre class="src src-bash">freedombone-image -t i386 -v meshclient --insecure yes
507
+</pre>
481
 </div>
508
 </div>
482
 
509
 
483
 <p>
510
 <p>
489
 </p>
516
 </p>
490
 
517
 
491
 <div class="org-src-container">
518
 <div class="org-src-container">
492
-<pre><code class="src src-bash">ls /dev/sd*
493
-</code></pre>
519
+<pre class="src src-bash">ls /dev/sd*
520
+</pre>
494
 </div>
521
 </div>
495
 
522
 
496
 <p>
523
 <p>
502
 </p>
529
 </p>
503
 
530
 
504
 <div class="org-src-container">
531
 <div class="org-src-container">
505
-<pre><code class="src src-bash">sudo dd <span class="org-variable-name">if</span>=/dev/zero <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">bs</span>=1M <span class="org-variable-name">count</span>=8
532
+<pre class="src src-bash">sudo dd <span class="org-variable-name">if</span>=/dev/zero <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">bs</span>=1M <span class="org-variable-name">count</span>=8
506
 sudo dd <span class="org-variable-name">bs</span>=1M <span class="org-variable-name">if</span>=myimagefile.img <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">conv</span>=fdatasync
533
 sudo dd <span class="org-variable-name">bs</span>=1M <span class="org-variable-name">if</span>=myimagefile.img <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">conv</span>=fdatasync
507
-</code></pre>
534
+</pre>
508
 </div>
535
 </div>
509
 
536
 
510
 <p>
537
 <p>
524
 </p>
551
 </p>
525
 
552
 
526
 <div class="org-src-container">
553
 <div class="org-src-container">
527
-<pre><code class="src src-bash">freedombone-image -t beaglebone -v mesh
528
-</code></pre>
554
+<pre class="src src-bash">freedombone-image -t beaglebone -v mesh
555
+</pre>
529
 </div>
556
 </div>
530
 
557
 
531
 <p>
558
 <p>
534
 </div>
561
 </div>
535
 </div>
562
 </div>
536
 
563
 
537
-<div id="outline-container-org6358707" class="outline-2">
538
-<h2 id="org6358707">Customisation</h2>
539
-<div class="outline-text-2" id="text-org6358707">
564
+<div id="outline-container-orgdbfa9a8" class="outline-2">
565
+<h2 id="orgdbfa9a8">Customisation</h2>
566
+<div class="outline-text-2" id="text-orgdbfa9a8">
540
 <p>
567
 <p>
541
 If you want to make your own specially branded version, such as for a particular event, then to change the default desktop backgrounds edit the images within <b>img/backgrounds</b> and to change the available avatars and desktop icons edit the images within <b>img/avatars</b>. Re-create disk images using the instructions shown previously.
568
 If you want to make your own specially branded version, such as for a particular event, then to change the default desktop backgrounds edit the images within <b>img/backgrounds</b> and to change the available avatars and desktop icons edit the images within <b>img/avatars</b>. Re-create disk images using the instructions shown previously.
542
 </p>
569
 </p>
546
 </p>
573
 </p>
547
 </div>
574
 </div>
548
 </div>
575
 </div>
549
-<div id="outline-container-orgf01387f" class="outline-2">
550
-<h2 id="orgf01387f">How to use it</h2>
551
-<div class="outline-text-2" id="text-orgf01387f">
576
+<div id="outline-container-org5f6418e" class="outline-2">
577
+<h2 id="org5f6418e">How to use it</h2>
578
+<div class="outline-text-2" id="text-org5f6418e">
552
 <p>
579
 <p>
553
 When you first boot from the USB drive the system will create some encryption keys, assign a unique network address to the system and then reboot itself. When that's done you should see a prompt asking for a username. This username just makes it easy for others to initially find you on the mesh and will appear in the list of users.
580
 When you first boot from the USB drive the system will create some encryption keys, assign a unique network address to the system and then reboot itself. When that's done you should see a prompt asking for a username. This username just makes it easy for others to initially find you on the mesh and will appear in the list of users.
554
 </p>
581
 </p>
558
 </p>
585
 </p>
559
 </div>
586
 </div>
560
 
587
 
561
-<div id="outline-container-org5ee0eb2" class="outline-3">
562
-<h3 id="org5ee0eb2">Boot trouble</h3>
563
-<div class="outline-text-3" id="text-org5ee0eb2">
588
+<div id="outline-container-org6f259f7" class="outline-3">
589
+<h3 id="org6f259f7">Boot trouble</h3>
590
+<div class="outline-text-3" id="text-org6f259f7">
564
 <p>
591
 <p>
565
 If the system doesn't boot and reports an error which includes <b>/dev/mapper/loop0p1</b> then reboot with <b>Ctrl-Alt-Del</b> and when you see the grub menu press <b>e</b> and manually change <b>/dev/mapper/loop0p1</b> to <b>/dev/sdb1</b>, then press <b>Ctrl-x</b>. If that doesn't work then reboot and try <b>/dev/sdc1</b> instead.
592
 If the system doesn't boot and reports an error which includes <b>/dev/mapper/loop0p1</b> then reboot with <b>Ctrl-Alt-Del</b> and when you see the grub menu press <b>e</b> and manually change <b>/dev/mapper/loop0p1</b> to <b>/dev/sdb1</b>, then press <b>Ctrl-x</b>. If that doesn't work then reboot and try <b>/dev/sdc1</b> instead.
566
 </p>
593
 </p>
570
 </p>
597
 </p>
571
 </div>
598
 </div>
572
 </div>
599
 </div>
573
-<div id="outline-container-org57403bb" class="outline-3">
574
-<h3 id="org57403bb">Set the Date</h3>
575
-<div class="outline-text-3" id="text-org57403bb">
600
+<div id="outline-container-org32ab229" class="outline-3">
601
+<h3 id="org32ab229">Set the Date</h3>
602
+<div class="outline-text-3" id="text-org32ab229">
576
 <p>
603
 <p>
577
 On the ordinary internet the date and time of your system would be set automatically via NTP. But this is not the internet and so you will need to manually ensure that your date and time settings are correct. You might need to periodically do this if your clock drifts. It's not essential that the time on your system be highly accurate, but if it drifts too far or goes back to epoch then things could become a little confusing in regard to the order of blog posts.
604
 On the ordinary internet the date and time of your system would be set automatically via NTP. But this is not the internet and so you will need to manually ensure that your date and time settings are correct. You might need to periodically do this if your clock drifts. It's not essential that the time on your system be highly accurate, but if it drifts too far or goes back to epoch then things could become a little confusing in regard to the order of blog posts.
578
 </p>
605
 </p>
582
 </p>
609
 </p>
583
 </div>
610
 </div>
584
 </div>
611
 </div>
585
-<div id="outline-container-orge4196db" class="outline-3">
586
-<h3 id="orge4196db">Check network status</h3>
587
-<div class="outline-text-3" id="text-orge4196db">
612
+<div id="outline-container-org0a0c31f" class="outline-3">
613
+<h3 id="org0a0c31f">Check network status</h3>
614
+<div class="outline-text-3" id="text-org0a0c31f">
588
 <p>
615
 <p>
589
 Unlike with ordinary wifi, on the mesh you don't get a signal strength icon and so it's not simple to see if you have a good connection.
616
 Unlike with ordinary wifi, on the mesh you don't get a signal strength icon and so it's not simple to see if you have a good connection.
590
 </p>
617
 </p>
608
 </div>
635
 </div>
609
 </div>
636
 </div>
610
 
637
 
611
-<div id="outline-container-org07b0383" class="outline-3">
612
-<h3 id="org07b0383">Chat System</h3>
613
-<div class="outline-text-3" id="text-org07b0383">
638
+<div id="outline-container-org334d737" class="outline-3">
639
+<h3 id="org334d737">Chat System</h3>
640
+<div class="outline-text-3" id="text-org334d737">
614
 <p>
641
 <p>
615
 Ensure that you're within wifi range of at least one other mesh peer (could be a router or client) and then you should see that the <i>Chat</i> and <i>Other Users</i> icons appear. Select the users icon and you should see a list of users on the mesh. Select the <i>Chat</i> icon and once you are connected you should see the status light turn green. If after a few minutes you don't get the green status light then try closing and re-opening the Tox chat application. Select the plus button to add a friend and then copy and paste in a Tox ID from the users list.
642
 Ensure that you're within wifi range of at least one other mesh peer (could be a router or client) and then you should see that the <i>Chat</i> and <i>Other Users</i> icons appear. Select the users icon and you should see a list of users on the mesh. Select the <i>Chat</i> icon and once you are connected you should see the status light turn green. If after a few minutes you don't get the green status light then try closing and re-opening the Tox chat application. Select the plus button to add a friend and then copy and paste in a Tox ID from the users list.
616
 </p>
643
 </p>
669
 </div>
696
 </div>
670
 </div>
697
 </div>
671
 
698
 
672
-<div id="outline-container-org56b3e5d" class="outline-3">
673
-<h3 id="org56b3e5d">Social Network</h3>
674
-<div class="outline-text-3" id="text-org56b3e5d">
699
+<div id="outline-container-org2195683" class="outline-3">
700
+<h3 id="org2195683">Social Network</h3>
701
+<div class="outline-text-3" id="text-org2195683">
675
 <p>
702
 <p>
676
 Patchwork is available as a social networking system for the mesh. Like all social network systems it has a stream of posts and you can follow or unfollow other users. You can also send private messages to other users with end-to-end encryption.
703
 Patchwork is available as a social networking system for the mesh. Like all social network systems it has a stream of posts and you can follow or unfollow other users. You can also send private messages to other users with end-to-end encryption.
677
 </p>
704
 </p>
706
 </div>
733
 </div>
707
 </div>
734
 </div>
708
 
735
 
709
-<div id="outline-container-orgc281f16" class="outline-3">
710
-<h3 id="orgc281f16">Sharing Files</h3>
711
-<div class="outline-text-3" id="text-orgc281f16">
736
+<div id="outline-container-org41de3cc" class="outline-3">
737
+<h3 id="org41de3cc">Sharing Files</h3>
738
+<div class="outline-text-3" id="text-org41de3cc">
712
 <p>
739
 <p>
713
 You can make files publicly available on the network simply by dragging and dropping them into the <i>Public</i> folder on the desktop. To view the files belonging to another user select the desktop icon called <i>Visit a site</i> and enter the username or Tox ID of the other user.
740
 You can make files publicly available on the network simply by dragging and dropping them into the <i>Public</i> folder on the desktop. To view the files belonging to another user select the desktop icon called <i>Visit a site</i> and enter the username or Tox ID of the other user.
714
 </p>
741
 </p>
723
 </div>
750
 </div>
724
 </div>
751
 </div>
725
 
752
 
726
-<div id="outline-container-org12f7a3e" class="outline-3">
727
-<h3 id="org12f7a3e">Blogging</h3>
728
-<div class="outline-text-3" id="text-org12f7a3e">
753
+<div id="outline-container-org534896d" class="outline-3">
754
+<h3 id="org534896d">Blogging</h3>
755
+<div class="outline-text-3" id="text-org534896d">
729
 <p>
756
 <p>
730
 To create a blog post select the <i>Blog</i> icon on the desktop and then use the up and down cursor keys, space bar and enter key to add a new entry. Edit the title of the entry and add your text. You can also include photos if you wish - just copy them to the <b>CreateBlog/content/images</b> directory and then link to them as shown.
757
 To create a blog post select the <i>Blog</i> icon on the desktop and then use the up and down cursor keys, space bar and enter key to add a new entry. Edit the title of the entry and add your text. You can also include photos if you wish - just copy them to the <b>CreateBlog/content/images</b> directory and then link to them as shown.
731
 </p>
758
 </p>