From 334f6aff94650a86a74d4f18d367e1a4dd1e05c2 Mon Sep 17 00:00:00 2001
From: Bob Mottram
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
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 thedd 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
Building an image for a Single Board Computer or Virtual Machine | +Building an image for a Single Board Computer or Virtual Machine |
Checklist | +Checklist |
Installation | +Installation |
Social Key Management - the 'Unforgettable Key' | +Social Key Management - the 'Unforgettable Key' |
Final Setup | +Final Setup |
Keydrives | +Keydrives |
On Client Machines | +On Client Machines |
Administering the system | +Administering the system |
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. ReBefore installing Freedombone you will need a few things.
@@ -388,17 +388,17 @@ Before installing Freedombone you will need a few things.There are three install options: Laptop/Desktop/Netbook, SBC and Virtual 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 menuconfigCurrently the following boards are supported:
@@ -466,7 +466,7 @@ Then copy it to a microSD card. Depending on your system you may need an adaptorsudo 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
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 noDuring 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
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.
-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.
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.
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 pAfter 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:
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 BackThis 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 keydYou 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-clientTo 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"> - +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@@ -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
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.
@@ -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
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 thesudo 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
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.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 idenunxz 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
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"> - +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 thSubstitute 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,noerrorPlug 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 tYou 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.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 addresssh fbone@freedombone.local -p 2222@@ -346,18 +346,18 @@ Or alternatively you can log in directly on the laptop. The initial username is
Enter your user details, domain name and dynamic DNS settings.
Navigate to your domain and register a new user.