From efc318db22c93fda2bdd179620906b674f79cfe3 Mon Sep 17 00:00:00 2001 From: Bob Mottram Date: Sat, 16 Jun 2018 10:32:25 +0100 Subject: [PATCH] Less verbose index page --- doc/EN/index.org | 12 +- website/EN/index.html | 41 +++-- website/EN/mesh_images.html | 308 ++++++++++++++++++------------------ 3 files changed, 187 insertions(+), 174 deletions(-) diff --git a/doc/EN/index.org b/doc/EN/index.org index 346715d8..0508bf4c 100644 --- a/doc/EN/index.org +++ b/doc/EN/index.org @@ -17,13 +17,11 @@ So you want to run your own internet services? Email, chat, VoIP, web sites, fil You can run Freedombone on an old laptop or a single board computer. See the [[./installmethods.html][list of installation methods]]. You can also use it to [[./mesh.html][set up a mesh network]] in your local area. -Check out the [[./apps.html][list of available apps]] and [[./faq.html][Frequently Asked Questions]] section. Recent developments are also described on [[https://blog.freedombone.net/tag/freedombone][the blog]]. You might also wish to know how to [[./backups.html][backup and restore the system]]. - -Disk images which can be cloned straight to USB or microSD drives are [[./downloads/v31][available here]]. - -If you find bugs, or want to add a new app to this system see the [[./devguide.html][Developers Guide]] and [[./codeofconduct.html][Code of Conduct]]. There is a Matrix chat room available at *#fbone:matrix.freedombone.net* and an XMPP channel at *support@chat.freedombone.net*. The XMPP channel requires membership which you can ask for via [[./support.html][these contact details]]. - -If you like this project and want to support continued development then [[./support.html][here's what to do]]. +#+attr_html: :align center +| [[./downloads/v31][Downloads]] | [[./apps.html][Apps]] | +| [[./devguide.html][Developers]] | [[./codeofconduct.html][Code of Conduct]] | +| [[https://blog.freedombone.net/tag/freedombone][Blog]] | [[./backups.html][Backups]] | +| [[./faq.html][FAQ]] | [[./support.html][Contact]] | #+attr_html: :width 10% :height 2% :align center [[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/website/EN/index.html b/website/EN/index.html index b9a4a698..12d439c9 100644 --- a/website/EN/index.html +++ b/website/EN/index.html @@ -4,7 +4,7 @@ - + @@ -165,21 +165,36 @@ So you want to run your own internet services? Email, chat, VoIP, web sites, fil You can run Freedombone on an old laptop or a single board computer. See the list of installation methods. You can also use it to set up a mesh network in your local area.

-

-Check out the list of available apps and Frequently Asked Questions section. Recent developments are also described on the blog. You might also wish to know how to backup and restore the system. -

+ -

-Disk images which can be cloned straight to USB or microSD drives are available here. -

-

-If you find bugs, or want to add a new app to this system see the Developers Guide and Code of Conduct. There is a Matrix chat room available at #fbone:matrix.freedombone.net and an XMPP channel at support@chat.freedombone.net. The XMPP channel requires membership which you can ask for via these contact details. -

++-

-If you like this project and want to support continued development then here's what to do. -

++ + + + + + + + + + + + + + + + + + + + + + +
DownloadsApps
DevelopersCode of Conduct
BlogBackups
FAQContact
diff --git a/website/EN/mesh_images.html b/website/EN/mesh_images.html index 0a1c7d96..4a7a4dae 100644 --- a/website/EN/mesh_images.html +++ b/website/EN/mesh_images.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - -‎ - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +Copyright (C) 2012-2013 Free Software Foundation, Inc. The JavaScript code in this tag is free software: you can redistribute it and/or modify it under the terms of the GNU @@ -236,23 +144,23 @@ for the JavaScript code in this tag.
+

logo.png

-
-

Mesh Network: Images

+
+

Mesh Network: Images

-
-

Pre-built Disk Images

-
-
-
-

Writing many images quickly

-
+
+

Pre-built Disk Images

+
+
+

Writing many images quickly

+

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 dd command is used for writing to the target drive, but to write to multiple drives you can use a tool such as GNOME MultiWriter.

@@ -262,6 +170,7 @@ For example on Arch/Parabola:

+ 
sudo pacman -S gnome-multi-writer
@@ -271,6 +180,7 @@ Or on Debian based systems:

+ 
sudo apt-get install gnome-multi-writer
@@ -280,9 +190,9 @@ The MultiWriter tool is also available within mesh client images, so that you ca

-
-

Client images

-
+
+

Client images

+

mesh_netbook.jpg @@ -293,14 +203,57 @@ 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.

+

+Install some prerequisites: +

+
+ 
sudo apt-get install xz-utils wget
-wget https://freedombone.net/downloads/v31/freedombone-meshclient-i386.img.xz
+
+
+ +

+To download images with dat: +

+ +
+ +
dat clone dat://e2ed9767d6ab64f4c43a2adbce65af225133fec7ba95737f0a2f6ae292ba358e/
+cd e2ed9767d6ab64f4c43a2adbce65af225133fec7ba95737f0a2f6ae292ba358e
+
+
+ +

+Or to download images directly with wget (may be slower): +

+ +
+ +
wget https://freedombone.net/downloads/v31/freedombone-meshclient-i386.img.xz
 wget https://freedombone.net/downloads/v31/freedombone-meshclient-i386.img.xz.sig
-gpg --verify freedombone-meshclient-i386.img.xz.sig
+
+
+ +

+Check the signature: +

+ +
+ +
gpg --verify freedombone-meshclient-i386.img.xz.sig
 unxz freedombone-meshclient-i386.img.xz
-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
+
+
+ +

+Then clone to the USB drive, where sdX is your USB device: +

+ +
+ +
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
@@ -312,29 +265,72 @@ To get a number of systems onto the mesh repeat the dd command to create 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: +

+
+ 
sudo apt-get install xz-utils wget
-wget https://freedombone.net/downloads/v31/freedombone-meshclient-insecure-i386.img.xz
+
+
+ +

+To download images with dat: +

+ +
+ +
dat clone dat://6d1b73d13b6f9b5c481c6dfd64be6aa58e1cd2d153a6bb04bbc177999ee9925e/
+cd 6d1b73d13b6f9b5c481c6dfd64be6aa58e1cd2d153a6bb04bbc177999ee9925e
+
+
+ +

+Or to download images directly with wget (may be slower): +

+ +
+ +
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
-gpg --verify freedombone-meshclient-insecure-i386.img.xz.sig
+
+
+ +

+Check the signature: +

+ +
+ +
gpg --verify freedombone-meshclient-insecure-i386.img.xz.sig
 unxz freedombone-meshclient-insecure-i386.img.xz
-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
+
+
+ +

+Then clone to the USB drive, where sdX is your USB device: +

+ +
+ +
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
-
-

Router images

-
+
+

Router images

+

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.

-
-

Beaglebone Black

-
+
+

Beaglebone Black

+

mesh_router.jpg @@ -346,14 +342,13 @@ The above picture shows a Beaglebone Black with the image copied onto a microSD

+ 
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.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
-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
@@ -369,9 +364,9 @@ There is still a software freedom issue with the Beaglebone Black, but it doesn'
-
-

Building Disk Images

-
+
+

Building Disk Images

+

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.

@@ -381,12 +376,13 @@ First you will need to create an image. On a Debian based system (tested on Debi

+ 
sudo apt-get -y install git wget build-essential
 wget https://freedombone.net/downloads/v31/freedombone.tar.gz
 wget https://freedombone.net/downloads/v31/freedombone.tar.gz.sig
 gpg --verify freedombone.tar.gz.sig
 tar -xzvf freedombone.tar.gz
-cd freedombone
+cd freedombone
 git checkout stretch
 sudo make install
 freedombone-image --setup debian
@@ -399,6 +395,7 @@ If you don't have Atheros or free software compatible wifi adapter then you can
 

 
 

+
 
freedombone-image -t i386 -v meshclient --insecure yes
 

 

@@ -412,6 +409,7 @@ List what drives are on your system with:
 

 
 

+
 
ls /dev/sd*
 

 

@@ -425,8 +423,9 @@ You can now copy the image to the USB thumb drive, replacing sdX with the
 

 
 

-
sudo dd if=/dev/zero of=/dev/sdX bs=32M count=8
-sudo dd bs=32M if=myimagefile.img of=/dev/sdX conv=fdatasync,sync,noerror
+
+
sudo dd if=/dev/zero of=/dev/sdX bs=32M count=8
+sudo dd bs=32M if=myimagefile.img of=/dev/sdX conv=fdatasync,sync,noerror
 

 

 
@@ -447,6 +446,7 @@ You can also use single board computers (SBCs) such as the BeagleBone Black to m
 

 
 

+
 
freedombone-image -t beaglebone -v mesh