diff --git a/doc/EN/armbian.org b/doc/EN/armbian.org index d79e3403..0b42666f 100644 --- a/doc/EN/armbian.org +++ b/doc/EN/armbian.org @@ -23,7 +23,7 @@ If you have a single board ARM computer which isn't one of the supported ones th Download the Armbian image for your board. It must be version 9 (Stretch), otherwise it won't work. Extract the image from its archive, then copy it to a microSD card: #+begin_src bash -sudo dd bs=32M if=[Armbian .img file] of=/dev/sdX conv=fdatasync,noerror +sudo dd bs=32M if=[Armbian .img file] of=/dev/sdX conv=fdatasync,sync,noerror #+end_src Where */dev/sdX* is the path for the microSD drive on your system. diff --git a/doc/EN/homeserver.org b/doc/EN/homeserver.org index 989c3343..30d0b855 100644 --- a/doc/EN/homeserver.org +++ b/doc/EN/homeserver.org @@ -70,7 +70,7 @@ You can now copy the image to the USB thumb drive, replacing *sdX* with the iden #+begin_src bash dd if=/dev/zero of=/dev/sdX bs=32M count=8 -dd bs=32M if=myimagefile.img of=/dev/sdX conv=fdatasync,noerror +dd bs=32M if=myimagefile.img of=/dev/sdX conv=fdatasync,sync,noerror #+end_src And wait. Again it will take a while to copy over. When that's done plug it into the laptop or netbook which you want to use as a server, power on and set the BIOS to boot from the USB stick. diff --git a/doc/EN/installation.org b/doc/EN/installation.org index 71d26e27..48d30133 100644 --- a/doc/EN/installation.org +++ b/doc/EN/installation.org @@ -129,7 +129,7 @@ unxz filename.img.xz Then copy it to a microSD card. Depending on your system you may need an adaptor to be able to do that. #+BEGIN_SRC bash -sudo dd bs=32M if=filename.img of=/dev/sdX conv=fdatasync,noerror +sudo dd bs=32M if=filename.img of=/dev/sdX conv=fdatasync,sync,noerror #+END_SRC Where *sdX* is the microSD drive. You can check which drive is the microSD drive using: diff --git a/doc/EN/mesh_images.org b/doc/EN/mesh_images.org index 70ff484d..dc654892 100644 --- a/doc/EN/mesh_images.org +++ b/doc/EN/mesh_images.org @@ -42,7 +42,7 @@ wget https://freedombone.net/downloads/v31/freedombone-meshclient-i386.img.xz.si 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,noerror +sudo dd bs=32M if=freedombone-meshclient-i386.img of=/dev/sdX conv=fdatasync,sync,noerror #+end_src To get a number of systems onto the mesh repeat the /dd/ command to create however many bootable USB drives you need. @@ -56,7 +56,7 @@ wget https://freedombone.net/downloads/v31/freedombone-meshclient-insecure-i386. 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,noerror +sudo dd bs=32M if=freedombone-meshclient-insecure-i386.img of=/dev/sdX conv=fdatasync,sync,noerror #+end_src ** Router images @@ -75,7 +75,7 @@ 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,noerror +sudo dd bs=32M if=freedombone-mesh_beaglebone-armhf.img of=/dev/sdX conv=fdatasync,sync,noerror #+end_src If you have a few Beaglebone Blacks to use as routers then repeat the /dd/ command to create however many microSD cards you need. @@ -120,7 +120,7 @@ You can now copy the image to the USB thumb drive, replacing *sdX* with the iden #+begin_src bash sudo dd if=/dev/zero of=/dev/sdX bs=32M count=8 -sudo dd bs=32M if=myimagefile.img of=/dev/sdX conv=fdatasync,noerror +sudo dd bs=32M if=myimagefile.img of=/dev/sdX conv=fdatasync,sync,noerror #+end_src And wait. Again it will take a while to copy over. When that's done plug it into the laptop or netbook which you want to use on the mesh, power on and set the BIOS to boot from the USB stick. diff --git a/doc/EN/release3.org b/doc/EN/release3.org index fddeea7e..c9bb8327 100644 --- a/doc/EN/release3.org +++ b/doc/EN/release3.org @@ -31,7 +31,7 @@ Copy the image to a microSD card or USB thumb drive, replacing sdX with the iden #+BEGIN_SRC bash unxz downloadedimagefile.img.xz -dd bs=32M if=downloadedimagefile.img of=/dev/sdX conv=fdatasync,noerror +dd bs=32M if=downloadedimagefile.img of=/dev/sdX conv=fdatasync,sync,noerror #+END_SRC And wait. It will take a while to copy over. When that's done you might want to increase the partition size on the drive, using a tool such as [[http://gparted.org][Gparted]]. Whether you need to do that will depend upon how many apps you intend to install and how much data they will store. diff --git a/doc/EN/release31.org b/doc/EN/release31.org index fa0b6f1d..4217ff48 100644 --- a/doc/EN/release31.org +++ b/doc/EN/release31.org @@ -39,7 +39,7 @@ Copy the image to a microSD card or USB thumb drive, replacing sdX with the iden #+BEGIN_SRC bash unxz downloadedimagefile.img.xz -dd bs=32M if=downloadedimagefile.img of=/dev/sdX conv=fdatasync,noerror +dd bs=32M if=downloadedimagefile.img of=/dev/sdX conv=fdatasync,sync,noerror #+END_SRC And wait. It will take a while to copy over. When that's done you might want to increase the partition size on the drive, using a tool such as [[http://gparted.org][Gparted]]. Whether you need to do that will depend upon how many apps you intend to install and how much data they will store. diff --git a/doc/EN/socialinstance.org b/doc/EN/socialinstance.org index 1a7e214f..b248b6cc 100644 --- a/doc/EN/socialinstance.org +++ b/doc/EN/socialinstance.org @@ -32,7 +32,7 @@ wget https://freedombone.net/downloads/v31/freedombone-pleroma-amd64.img.xz.sig gpg --verify freedombone-pleroma-amd64.img.xz.sig unxz freedombone-pleroma-amd64.img.xz sudo dd if=/dev/zero of=/dev/sdX bs=32M count=8 -sudo dd bs=32M if=freedombone-pleroma-amd64.img of=/dev/sdX conv=fdatasync,noerror +sudo dd bs=32M if=freedombone-pleroma-amd64.img of=/dev/sdX conv=fdatasync,sync,noerror #+end_src Also note that if the laptop has a removable SSD drive it's possible to copy the image directly to that if you have enough equipment. diff --git a/src/freedombone-image b/src/freedombone-image index 5d8de9c2..fb202a3e 100755 --- a/src/freedombone-image +++ b/src/freedombone-image @@ -719,7 +719,7 @@ if [[ $IMAGE_TYPE != "qemu"* ]]; then echo '' echo " unxz -k ${PROJECT_NAME}*.img.xz" echo ' sudo dd if=/dev/zero of=/dev/sdX bs=32M count=8' - echo " sudo dd bs=32M if=${PROJECT_NAME}*.img of=/dev/sdX conv=fdatasync,noerror" + echo " sudo dd bs=32M if=${PROJECT_NAME}*.img of=/dev/sdX conv=fdatasync,sync,noerror" echo '' fi diff --git a/website/EN/armbian.html b/website/EN/armbian.html index ca77c8c9..1c2d00e8 100644 --- a/website/EN/armbian.html +++ b/website/EN/armbian.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + ‎ @@ -260,7 +260,7 @@ Download the Armbian image for your board. It must be version 9 (Stretch), other

-
sudo dd bs=32M if=[Armbian .img file] of=/dev/sdX conv=fdatasync,noerror
+
sudo dd bs=32M if=[Armbian .img file] of=/dev/sdX conv=fdatasync,sync,noerror
diff --git a/website/EN/homeserver.html b/website/EN/homeserver.html index 8a88c88c..fddecce6 100644 --- a/website/EN/homeserver.html +++ b/website/EN/homeserver.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + ‎ @@ -243,9 +243,9 @@ for the JavaScript code in this tag. -
-

Home Server

-
+
+

Home Server

+

The quickest way to get started is as follows. You will need to be running a Debian based system (version 8 or later), have an old but still working laptop or netbook which you can use as a server, and 8GB or larger USB thumb drive and an ethernet cable to connect the laptop to your internet router.

@@ -336,7 +336,7 @@ You can now copy the image to the USB thumb drive, replacing sdX with the 
dd if=/dev/zero of=/dev/sdX bs=32M count=8
-dd bs=32M if=myimagefile.img of=/dev/sdX conv=fdatasync,noerror
+dd bs=32M if=myimagefile.img of=/dev/sdX conv=fdatasync,sync,noerror
diff --git a/website/EN/installation.html b/website/EN/installation.html index 51b27e6a..f28d989d 100644 --- a/website/EN/installation.html +++ b/website/EN/installation.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + ‎ @@ -242,9 +242,9 @@ for the JavaScript code in this tag.

-
-

Installation

-
+ -
-

Building an image for a Single Board Computer or Virtual Machine

-
+
+

Building an image for a Single Board Computer or Virtual Machine

+

You don't have to trust images downloaded from random internet locations signed with untrusted keys. You can build one from scratch yourself, and this is the recommended procedure for maximum security. For guidance on how to build images see the manpage for the freedombone-image command.

@@ -372,9 +372,9 @@ If the image build fails with an error such as "Error reading from server. Re
-
-

Checklist

-
+
+

Checklist

+

Before installing Freedombone you will need a few things.

@@ -388,17 +388,17 @@ Before installing Freedombone you will need a few things.
-
-

Installation

-
+
+

Installation

+

There are three install options: Laptop/Desktop/Netbook, SBC and Virtual Machine.

-
-

On a Laptop, Netbook or Desktop machine

-
+
+

On a Laptop, Netbook or Desktop machine

+

If you have an existing system, such as an old laptop or netbook which you can leave running as a server, then install a new version of Debian Stretch onto it. During the Debian install you won't need the print server or the desktop environment, and unchecking those will reduce the attack surface. Once Debian enter the following commands:

@@ -417,9 +417,9 @@ freedombone menuconfig
-
-

On a single board computer (SBC)

-
+
+

On a single board computer (SBC)

+

Currently the following boards are supported:

@@ -466,7 +466,7 @@ Then copy it to a microSD card. Depending on your system you may need an adaptor

-
sudo dd bs=32M if=filename.img of=/dev/sdX conv=fdatasync,noerror
+
sudo dd bs=32M if=filename.img of=/dev/sdX conv=fdatasync,sync,noerror
@@ -498,9 +498,9 @@ Using the password 'freedombone'. Take a note of the new login password and then
-
-

As a Virtual Machine

-
+
+

As a Virtual Machine

+

Qemu is currently supported, since it's s fully free software system. You can run a 64 bit Qemu image with:

@@ -517,42 +517,42 @@ The default login will be username 'fbone' and password 'freedombone'. Take a no
-
-

Social Key Management - the 'Unforgettable Key'

-
+
+

Social Key Management - the 'Unforgettable Key'

+

During the install procedure you will be asked if you wish to import GPG keys. If you don't already possess GPG keys then just select "Ok" and they will be generated during the install. If you do already have GPG keys then there are a few possibilities

-
-

You have the gnupg keyring on an encrypted USB drive

-
+
+

You have the gnupg keyring on an encrypted USB drive

+

If you previously made a master keydrive containing the full keyring (the .gnupg directory). This is the most straightforward case, but not as secure as splitting the key into fragments.

-
-

You have a number of key fragments on USB drives retrieved from friends

-
+
+

You have a number of key fragments on USB drives retrieved from friends

+

-If you previously made some USB drives containing key fragments then retrieve them from your friends and plug them in one after the other. After the last drive has been read then remove it and just select "Ok". The system will then try to reconstruct the key. For this to work you will need to have previously made three or more Keydrives. +If you previously made some USB drives containing key fragments then retrieve them from your friends and plug them in one after the other. After the last drive has been read then remove it and just select "Ok". The system will then try to reconstruct the key. For this to work you will need to have previously made three or more Keydrives.

-
-

You can specify some ssh login details for friends servers containing key fragments

-
+
+

You can specify some ssh login details for friends servers containing key fragments

+

Enter three or more sets of login details and the installer will try to retrieve key fragments and then assemble them into the full key. This only works if you previously were using remote backups and had social key management enabled.

-
-

Final Setup

-
+
+

Final Setup

+

Any manual post-installation setup instructions or passwords can be found in /home/username/README.

@@ -670,16 +670,16 @@ On your internet router, typically under firewall settings, open the following p
-
-

Keydrives

-
+
+

Keydrives

+

After installing for the first time it's a good idea to create some keydrives. These will store your gpg key so that if all else fails you will still be able to restore from backup. There are two ways to do this:

-
-

Master Keydrive

-
+
+

Master Keydrive

+

This is the traditional security model in which you carry your full keyring on an encrypted USB drive. To make a master keydrive first format a USB drive as a LUKS encrypted drive. In Ubuntu this can be done from the Disk Utility application. Then plug it into the Freedombone system, then from your local machine run:

@@ -694,9 +694,9 @@ Select Administrator controls then Backup and Restore then Back

-
-

Fragment keydrives

-
+
+

Fragment keydrives

+

This breaks your GPG key into a number of fragments and randomly selects one to add to the USB drive. First format a USB drive as a LUKS encrypted drive. In Ubuntu this can be done from the Disk Utility application. Plug it into the Freedombone system then from your local machine run the following commands:

@@ -716,9 +716,9 @@ Fragments are randomly assigned and so you will need at least three or four keyd
-
-

On Client Machines

-
+
+

On Client Machines

+

You can configure laptops or desktop machines which connect to the Freedombone server in the following way. This alters encryption settings to improve overall security.

@@ -736,9 +736,9 @@ freedombone-client
-
-

Administering the system

-
+
+

Administering the system

+

To administer the system after installation log in via ssh, become the root user and then launch the control panel.

diff --git a/website/EN/mesh_images.html b/website/EN/mesh_images.html index 1d38c86e..0a1c7d96 100644 --- a/website/EN/mesh_images.html +++ b/website/EN/mesh_images.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + ‎ @@ -242,17 +242,17 @@ for the JavaScript code in this tag.

-
-

Mesh Network: Images

+
+

Mesh Network: Images

-
-

Pre-built Disk Images

-
+
+

Pre-built Disk Images

+
-
-

Writing many images quickly

-
+
+

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.

@@ -280,9 +280,9 @@ The MultiWriter tool is also available within mesh client images, so that you ca

-
-

Client images

-
+
+

Client images

+

mesh_netbook.jpg @@ -300,7 +300,7 @@ wget https://freedombone.net/downloads/v31/freedombone-meshclient-i386.img.xz.si 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,noerror +sudo dd bs=32M if=freedombone-meshclient-i386.img of=/dev/sdX conv=fdatasync,sync,noerror

@@ -319,22 +319,22 @@ wget https://freedombone.net/downloads/v31/freedombone-meshclient-insecure-i386. 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,noerror +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 @@ -353,7 +353,7 @@ 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,noerror +sudo dd bs=32M if=freedombone-mesh_beaglebone-armhf.img of=/dev/sdX conv=fdatasync,sync,noerror

@@ -369,9 +369,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.

@@ -426,7 +426,7 @@ 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,noerror
+sudo dd bs=32M if=myimagefile.img of=/dev/sdX conv=fdatasync,sync,noerror
diff --git a/website/EN/release31.html b/website/EN/release31.html index 2e5cc98b..e51f30b3 100644 --- a/website/EN/release31.html +++ b/website/EN/release31.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + ‎ @@ -242,9 +242,9 @@ for the JavaScript code in this tag.

-
-

Version 3.1, 2018-04-15

-
+
+

Version 3.1, 2018-04-15

+

Newer and shinier than before, Freedombone 3.1 rests upon the solid foundation of Debian stable and delivers major new self-hosted apps, improved mesh networking and a new logo. It supports version 3 onion addresses and the ability to use email with onion and I2P addresses. New apps are:

@@ -281,9 +281,9 @@ The future is decentralized.
-
-

Installation

-
+
+

Installation

+

The simplest way to install is from a pre-made disk image. Images can be downloaded here. You will need to have previously obtained a domain name and have a dynamic DNS account somewhere. Or if you don't need clearnet domains and will be using Tor compatible browsers then you can use the "onion only" images where apps will be accessible via an onion address.

@@ -294,7 +294,7 @@ Copy the image to a microSD card or USB thumb drive, replacing sdX with the iden 
unxz downloadedimagefile.img.xz
-dd bs=32M if=downloadedimagefile.img of=/dev/sdX conv=fdatasync,noerror
+dd bs=32M if=downloadedimagefile.img of=/dev/sdX conv=fdatasync,sync,noerror
@@ -339,9 +339,9 @@ More detailed installation instructions are linked from -

Upgrading from a previous install

-
+
+

Upgrading from a previous install

+

To upgrade from version 3 just go to the administrator control panel and select check for updates.

diff --git a/website/EN/socialinstance.html b/website/EN/socialinstance.html index be858047..354ab09c 100644 --- a/website/EN/socialinstance.html +++ b/website/EN/socialinstance.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + ‎ @@ -242,9 +242,9 @@ for the JavaScript code in this tag.

-
-

Social Instance

-
+
+

Social Instance

+

A social instance image allows you to easily set up a fediverse server, which federates using the OStatus or ActivityPub protocol. You will need:

@@ -263,9 +263,9 @@ The installation process is the same as usual, with the only difference being th
-
-

Copy the image to the USB drive

-
+
+

Copy the image to the USB drive

+

Substitute sdX with the device name for your USB drive.

@@ -277,7 +277,7 @@ wget https://freedombone.net/downloads/v31/freedombone-pleroma-amd64.img.xz.sig gpg --verify freedombone-pleroma-amd64.img.xz.sig unxz freedombone-pleroma-amd64.img.xz sudo dd if=/dev/zero of=/dev/sdX bs=32M count=8 -sudo dd bs=32M if=freedombone-pleroma-amd64.img of=/dev/sdX conv=fdatasync,noerror +sudo dd bs=32M if=freedombone-pleroma-amd64.img of=/dev/sdX conv=fdatasync,sync,noerror
@@ -287,9 +287,9 @@ Also note that if the laptop has a removable SSD drive it's possible to copy the
-
-

Connect the laptop to your internet router

-
+
+

Connect the laptop to your internet router

+

Plug the USB drive into the laptop and connect it to your internet router with the ethernet cable.

@@ -302,9 +302,9 @@ Plug the USB drive into the laptop and connect it to your internet router with t
-
-

Boot the laptop from the USB drive

-
+
+

Boot the laptop from the USB drive

+

You may need to alter the BIOS settings to get this to work reliably.

@@ -317,9 +317,9 @@ You may need to alter the BIOS settings to get this to work reliably.
-
-

Forward ports 80 (HTTP) and 443 (HTTPS) from your internet router to the laptop

-
+
+

Forward ports 80 (HTTP) and 443 (HTTPS) from your internet router to the laptop

+

Log into your internet router using a non-Tor browser (usually it's on an address like 192.168.1.1 or 192.168.1.254). Often port forwarding settings are together with firewall settings.

@@ -332,9 +332,9 @@ Log into your internet router using a non-Tor browser (usually it's on an addres
-
-

From another machine ssh into the laptop

-
+
+

From another machine ssh into the laptop

+
ssh fbone@freedombone.local -p 2222
@@ -346,18 +346,18 @@ Or alternatively you can log in directly on the laptop. The initial username is
-
-

Follow the setup procedure

-
+
+

Follow the setup procedure

+

Enter your user details, domain name and dynamic DNS settings.

-
-

When installation is complete

-
+
+

When installation is complete

+

Navigate to your domain and register a new user.