From 65c6de6e4b3183f133eeba94f38f7dacb956df9a Mon Sep 17 00:00:00 2001 From: Bob Mottram Date: Thu, 12 Apr 2018 13:33:09 +0100 Subject: [PATCH] Update document formatting --- doc/EN/faq.org | 3 +- doc/EN/fediverse.org | 7 +- doc/EN/homeserver.org | 29 +-- doc/EN/installation.org | 13 +- doc/EN/installmethods.org | 3 +- doc/EN/mesh.org | 14 +- doc/EN/mesh_capabilities.org | 11 +- doc/EN/mesh_custom.org | 11 +- doc/EN/mesh_images.org | 17 +- doc/EN/mesh_philosophic.org | 7 +- doc/EN/meshindex.org | 9 +- doc/EN/mirrors.org | 47 ----- doc/EN/mobile.org | 13 +- doc/EN/related.org | 49 ----- doc/EN/release3.org | 9 +- doc/EN/security.org | 3 +- doc/EN/socialinstance.org | 24 +-- doc/EN/support.org | 17 +- doc/EN/usage.org | 14 +- doc/EN/usage_email.org | 11 +- doc/EN/users.org | 4 +- doc/EN/variants.org | 50 ----- website/EN/mirrors.html | 366 ----------------------------------- website/EN/related.html | 305 ----------------------------- website/EN/variants.html | 308 ----------------------------- 25 files changed, 72 insertions(+), 1272 deletions(-) delete mode 100644 doc/EN/mirrors.org delete mode 100644 doc/EN/related.org delete mode 100644 doc/EN/variants.org delete mode 100644 website/EN/mirrors.html delete mode 100644 website/EN/related.html delete mode 100644 website/EN/variants.html diff --git a/doc/EN/faq.org b/doc/EN/faq.org index 3d5096a2..dc800cbe 100644 --- a/doc/EN/faq.org +++ b/doc/EN/faq.org @@ -329,9 +329,8 @@ If you can find some details for an obfs4 Tor bridge (its IP address, port numbe ssh into your Freedombone system, go to the *administrator control panel*, select *security settings* then *Tor Bridges* and *Add a bridge*. You can then enter the details. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel_bridges.jpg]] -#+END_CENTER Any bridges that you add will also show up on the About screen of the administrator control panel. diff --git a/doc/EN/fediverse.org b/doc/EN/fediverse.org index 5af89588..90f6cdbd 100644 --- a/doc/EN/fediverse.org +++ b/doc/EN/fediverse.org @@ -6,13 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_CENTER -*Homesteading the Fediverse* -#+END_CENTER +* Homesteading the Fediverse Some things you might want to know about the Fediverse: diff --git a/doc/EN/homeserver.org b/doc/EN/homeserver.org index 1871ca3b..ec0afaa1 100644 --- a/doc/EN/homeserver.org +++ b/doc/EN/homeserver.org @@ -1,19 +1,16 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, home server +#+DESCRIPTION: Freedombone home server setup #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+begin_export html -

Home Server

-#+end_export +* 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. @@ -47,9 +44,8 @@ Now prepare your local system to talk to the freedombone by running the followin freedombone-client #+end_src -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/tor_onion.jpg]] -#+END_CENTER The version in which sites are available only via onion addresses is the easiest to get started with, since you can evaluate the system without committing to buying an ICANN domain name or needing to get involved with SSL/TLS certificates at all. However, if you do want your sites to be available typically as subdomains of a domain name which you own then remove the *--onion-addresses-only yes* option from the last command shown above. Also see the [[./domains.html][guide on setting up an ICANN domain name]]. @@ -57,9 +53,8 @@ The *onion-addresses-only* option *does not* mean that everything gets routed th If you want to create images for microSD cards used within various single board computers then replace the *i386* with *beaglebone* / *cubieboard2* / *cubietruck* / *a20-olinuxino-lime* / *a20-olinuxino-lime2* / *a20-olinuxino-micro* or *apu*. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/beaglebone_black9.jpg]] -#+END_CENTER This takes a while. Maybe an hour or so, depending on the speed of your system and the internets. The good news though is that once created you can use the resulting image any number of times, and you don't need to trust some pre-built image. @@ -107,9 +102,8 @@ freedombone-client --verify This will show the hash code for the public ssh key of the Freedombone system. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/ssh_key_verify.jpg]] -#+END_CENTER Open another terminal window then run: @@ -120,15 +114,13 @@ ssh myusername@freedombone.local -p 2222 Use the password you wrote down earlier to log in. Select the *administrator control panel* with up and down cursor keys, space bar and enter key. You should see something like this, and you might need to re-enter your password. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel.jpg]] -#+END_CENTER Then select *About*. You'll see a list of sites and their onion addresses. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel_about.jpg]] -#+END_CENTER The About screen contains the ssh server public key hashes and you can compare the relevant one with the previous terminal window to verify that they're the same. If they're not then you might have a /machine-in-the-middle/ snooping on you. @@ -136,9 +128,8 @@ You have now confirmed a secure connection. Probably. If you're still sceptical Press any key to exit from the About screen. You can then select *Add/Remove apps* and add whatever applications you wish to run. Note that some apps will only run on x86 systems, but most will install and run on ARM single board computers. More details on particular apps can be [[./apps.html][found here]]. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel_apps.jpg]] -#+END_CENTER Once your apps have installed you can go back to the About screen, pick an onion address and try it within a Tor compatible browser. You'll need to know the login passwords and those can be found within the /Passwords/ section of the administrator control panel. An axiom of the Freedombone system is that /if given the choice users will usually use insecure passwords/, so on this system passwords are generated randomly. If you need to then you can transfer the passwords into your favourite password manager and remove them from the server by going to the *Security Settings* section of the administrator control panel and choosing *Export passwords* and *Password storage*. diff --git a/doc/EN/installation.org b/doc/EN/installation.org index 3fca1d84..f5d8acf1 100644 --- a/doc/EN/installation.org +++ b/doc/EN/installation.org @@ -1,20 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, hubzilla, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, installation +#+DESCRIPTION: Freedombone installation #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Installation

-
-#+END_EXPORT +* Installation | [[Building an image for a Single Board Computer or Virtual Machine]] | | [[Checklist]] | diff --git a/doc/EN/installmethods.org b/doc/EN/installmethods.org index 522a086e..457ac946 100644 --- a/doc/EN/installmethods.org +++ b/doc/EN/installmethods.org @@ -6,9 +6,8 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER Most people don't have a static external IP address, so you will need to have an account on a dymanic DNS service. [[https://freedns.afraid.org][FreeDNS]] is the one recommended, but others are available. diff --git a/doc/EN/mesh.org b/doc/EN/mesh.org index aab59e7f..39c67da7 100644 --- a/doc/EN/mesh.org +++ b/doc/EN/mesh.org @@ -1,18 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, mesh +#+DESCRIPTION: Freedombone mesh network #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+begin_export html -

Mesh Network

-#+end_export +* Mesh Network The Freedombone Mesh is a wireless solution for autonomous or internet connected communication that can be rapidly deployed in temporary, emergency or post-disaster situations where internet access is unavailable or compromised. @@ -22,9 +19,8 @@ The Freedombone Mesh is a wireless solution for autonomous or internet connected * [[./mesh_custom.html][Customisation]] * [[./mesh_usage.html][How to use it]] -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/mesh_desktop1.png]] -#+END_CENTER 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 businesses who don't want the overhead of server maintenance, protests, remote areas of the world, temporary "digital blackouts", scientific expeditions and off-world space colonies. diff --git a/doc/EN/mesh_capabilities.org b/doc/EN/mesh_capabilities.org index 5adf8d8e..678e5346 100644 --- a/doc/EN/mesh_capabilities.org +++ b/doc/EN/mesh_capabilities.org @@ -1,18 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, mesh +#+DESCRIPTION: Freedombone mesh network capabilities #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+begin_export html -

Mesh Network: Capabilities

-#+end_export +* Mesh Network: Capabilities The mesh system has the following capabilities: diff --git a/doc/EN/mesh_custom.org b/doc/EN/mesh_custom.org index 29596d8e..7809b339 100644 --- a/doc/EN/mesh_custom.org +++ b/doc/EN/mesh_custom.org @@ -1,18 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, mesh +#+DESCRIPTION: Freedombone mesh network customisation #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+begin_export html -

Mesh Network: Customisation

-#+end_export +* Mesh Network: Customisation 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 *img/backgrounds* and to change the available avatars and desktop icons edit the images within *img/avatars*. Re-create disk images using the instructions shown previously. diff --git a/doc/EN/mesh_images.org b/doc/EN/mesh_images.org index 20534c8b..2cff5e79 100644 --- a/doc/EN/mesh_images.org +++ b/doc/EN/mesh_images.org @@ -1,18 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, mesh +#+DESCRIPTION: Freedombone mesh network images #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+begin_export html -

Mesh Network: Images

-#+end_export +* Mesh Network: Images * Pre-built Disk Images ** Writing many images quickly @@ -33,9 +30,8 @@ sudo apt-get install gnome-multi-writer 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. ** Client images -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/mesh_netbook.jpg]] -#+END_CENTER "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. @@ -70,9 +66,8 @@ sudo dd bs=1M if=freedombone-meshclient-insecure-i386.img of=/dev/sdX conv=fdata ** 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 -#+BEGIN_CENTER +#+attr_html: :width 50% :align center [[file:images/mesh_router.jpg]] -#+END_CENTER The above picture shows a Beaglebone Black with the image copied onto a microSD card (there's no need to do anything with the internal EMMC). A USB Atheros wifi adaptor with a large antenna is attached and in this case power is from the mains, although it could be from a battery or solar power system capable of supplying 5 volts and maybe 1A (depending upon how active the router is). diff --git a/doc/EN/mesh_philosophic.org b/doc/EN/mesh_philosophic.org index b52f8cef..0448ea8e 100644 --- a/doc/EN/mesh_philosophic.org +++ b/doc/EN/mesh_philosophic.org @@ -6,13 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+begin_export html -

Mesh Network: Philosophic

-#+end_export +* Mesh Network: Philosophic #+begin_quote "/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 diff --git a/doc/EN/meshindex.org b/doc/EN/meshindex.org index b23b05be..c557fcf5 100644 --- a/doc/EN/meshindex.org +++ b/doc/EN/meshindex.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Welcome to the Freedombone Mesh

-
-#+END_EXPORT +* Welcome to the Freedombone Mesh The following apps are available: diff --git a/doc/EN/mirrors.org b/doc/EN/mirrors.org deleted file mode 100644 index f3f47737..00000000 --- a/doc/EN/mirrors.org +++ /dev/null @@ -1,47 +0,0 @@ -#+TITLE: -#+AUTHOR: Bob Mottram -#+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Mirroring git repositories -#+OPTIONS: ^:nil toc:nil -#+HTML_HEAD: - -#+BEGIN_CENTER -[[file:images/logo.png]] -#+END_CENTER - -#+BEGIN_EXPORT html -
-

Mirrors

-
-#+END_EXPORT - -| [[What are mirrors and why do they exist?]] | -| [[What security do mirrors have?]] | -| [[How do I set up mirrors?]] | -| [[Do mirrors include debian package repositories?]] | -| [[What do I need to do to keep the mirrored repositories updated?]] | - -* What are mirrors and why do they exist? -It would be nice if all of the applications used by this project were packaged for Debian, but currently they're not. This means that various upstream git repositories are used and these mostly reside on Github. What if Github were to go away, become paying only or be censored in some manner which was difficult to work around? To guard against this possibility the repositories are mirrored on each install and can then be made available to other users so that new installations or updates could still occur without the original default repos. -* What security do mirrors have? -On each install you have a /mirrors/ user created, whose only purpose is to mirror upstream repositories. A random password is generated for the /mirrors/ user which can be seen within the control panel and so given to other users who may need it. -* How do I set up mirrors? -The interactive installer will ask whether you want to configure the main respositories. Enter the URL, which will typically be an onion address, the ssh port number and the password for the mirrors on that system. -* Do mirrors include debian package repositories? -No. Packages for Debian will still be accessed in the conventional manner. -* Can I change mirrors after the system has been installed -Yes. From the control panel select "/Set the main repository/" - -#+BEGIN_CENTER -[[file:images/controlpanel/control_panel_mirrors.jpg]] -#+END_CENTER - -* What do I need to do to keep the mirrored repositories updated? -Nothing. That happens as part of regular automatic updates. - -#+BEGIN_EXPORT html -
-Return to the home page -
-#+END_EXPORT diff --git a/doc/EN/mobile.org b/doc/EN/mobile.org index 1fb82841..eef17c4c 100644 --- a/doc/EN/mobile.org +++ b/doc/EN/mobile.org @@ -1,20 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, mobile +#+DESCRIPTION: Freedombone mobile setup #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Mobile

-
-#+END_EXPORT +* Mobile Mobile phones are insecure devices, but they're regarded as being so essential to modern life that telling people not to use them isn't a viable option. Here are some recommendations on setting up a mobile phone (aka "smartphone") to work with Freedombone. diff --git a/doc/EN/related.org b/doc/EN/related.org deleted file mode 100644 index b9a64e93..00000000 --- a/doc/EN/related.org +++ /dev/null @@ -1,49 +0,0 @@ -#+TITLE: -#+AUTHOR: Bob Mottram -#+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, hubzilla, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server -#+OPTIONS: ^:nil toc:nil -#+HTML_HEAD: - -#+BEGIN_CENTER -[[file:images/logo.png]] -#+END_CENTER - -#+BEGIN_EXPORT html -
-

Related Projects

-
-#+END_EXPORT - -#+BEGIN_EXPORT html -
-The following projects made Freedombone possible.
- - - - - - - - - - - - - - - - - - - - - - - - - -
Nginx
Openssl
Gnupg
Debian
Freedombox
Beagleboard
Dokuwiki
GNU Social
Hubzilla
Tor
Prosody
Syncthing
Tox
Bettercrypto
-
-#+END_EXPORT diff --git a/doc/EN/release3.org b/doc/EN/release3.org index ba8984e7..4c890a59 100644 --- a/doc/EN/release3.org +++ b/doc/EN/release3.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/release3.jpg]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Building an internet run by the users, for the users

-
-#+END_EXPORT +* Building an internet run by the users, for the users The internet may still be mostly in the clutches of a few giant megacorporations and dubious governments with sketchy agendas, but it doesn't have to remain that way. With the third version of the Freedombone system there is now more scope than before to take back your privacy, have ownership of personal data and run your own online communities without undesirable intermediaries. diff --git a/doc/EN/security.org b/doc/EN/security.org index d2f21925..edcaaf23 100644 --- a/doc/EN/security.org +++ b/doc/EN/security.org @@ -6,9 +6,8 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER * Authentication with keys It's a lot more secure to log in to the Freedombone system using ssh keys rather than with a password. You can set that up by first running: diff --git a/doc/EN/socialinstance.org b/doc/EN/socialinstance.org index cade74e1..7106503e 100644 --- a/doc/EN/socialinstance.org +++ b/doc/EN/socialinstance.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT HTML -
-

Social Instance

-
-#+END_EXPORT +* 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: @@ -46,25 +41,22 @@ Also note that if the laptop has a removable SSD drive it's possible to copy the Plug the USB drive into the laptop and connect it to your internet router with the ethernet cable. -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/laptop_router.jpg]] -#+END_CENTER * Boot the laptop from the USB drive You may need to alter the BIOS settings to get this to work reliably. -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/bios_boot_usb.jpg]] -#+END_CENTER * 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. -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/port_forwarding.png]] -#+END_CENTER * From another machine ssh into the laptop @@ -82,12 +74,10 @@ Enter your user details, domain name and dynamic DNS settings. Navigate to your domain and register a new user. -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/pleroma_register.jpg]] -#+END_CENTER More details about setting up and using Pleroma [[./app_pleroma.html][can be found here]]. -#+BEGIN_CENTER +#+attr_html: :width 50% :align center [[file:images/tusky.jpg]] -#+END_CENTER diff --git a/doc/EN/support.org b/doc/EN/support.org index a8f8a514..95ae8431 100644 --- a/doc/EN/support.org +++ b/doc/EN/support.org @@ -1,20 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, support +#+DESCRIPTION: How to support the Freedombone project #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Support

-
-#+END_EXPORT +* Support * Contact details @@ -48,9 +43,9 @@ A better design for this website would be nice to have. Photos, icons or other a ** Howto videos If you're good at making videos then a howto for installing Freedombone onto various types of hardware, or testing the mesh system in realistic/exotic scenarios would be good. You could even host videos on PeerTube or Mediagoblin. ** More education and promotion -#+BEGIN_CENTER +#+attr_html: :width 50% :align center [[./images/educate.png]] -#+END_CENTER + Many people are unaware that running their own internet services /is even a possibility/. Many also believe that internet services can be provided only if they're supported by advertising or donations, and that only gigantic data centres have enough computing capacity to serve web pages on a worldwide scale. Others may be fearful of encryption due to misrepresentations or misunderstandings of it in the mainstream media. Some may be intimidated by the apparent complexity and think that you need to be some sort of silicon valley genius in order to run a web service on your own. Even many technically-minded folks often believe that they can't run a home server unless they have a static IP address, which isn't true, and others are put off by thinking that any such server will be immediately [[https://en.wikipedia.org/wiki/Pwn][pwned]] by blackhat hackers. Raising awareness beyond the near zero current level, overcoming fear and paranoia and dispelling some of the prevalent myths will definitely help. diff --git a/doc/EN/usage.org b/doc/EN/usage.org index 4bc059bd..7e29419b 100644 --- a/doc/EN/usage.org +++ b/doc/EN/usage.org @@ -1,20 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, hubzilla, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone +#+DESCRIPTION: How to use the Freedombone system #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Usage

-
-#+END_EXPORT +* Usage | [[Improving security]] | | [[Administrating the system via an onion address (Tor)]] | @@ -93,4 +88,5 @@ sudo su control #+END_SRC +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel_manage_users.jpg]] diff --git a/doc/EN/usage_email.org b/doc/EN/usage_email.org index 75112993..f032bc5f 100644 --- a/doc/EN/usage_email.org +++ b/doc/EN/usage_email.org @@ -1,14 +1,13 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, hubzilla, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, email +#+DESCRIPTION: How to use email on Freedombone #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER | [[Things to be aware of]] | | [[A technical note about email transport security]] | @@ -59,10 +58,8 @@ gpg --send-keys username@domainname exit #+END_SRC * Mutt email client - -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[./images/mutt.jpeg]] -#+END_CENTER Mutt is a terminal based email client which comes already installed onto the Freedombone. To access it you'll need to access it via ssh with: diff --git a/doc/EN/users.org b/doc/EN/users.org index 29be50d6..17b08222 100644 --- a/doc/EN/users.org +++ b/doc/EN/users.org @@ -6,9 +6,8 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER Log into the system with: @@ -18,4 +17,5 @@ ssh username@domainname -p 2222 Select *Administrator controls* then *User Management*. +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel_manage_users.jpg]] diff --git a/doc/EN/variants.org b/doc/EN/variants.org deleted file mode 100644 index a2bab6ab..00000000 --- a/doc/EN/variants.org +++ /dev/null @@ -1,50 +0,0 @@ -#+TITLE: -#+AUTHOR: Bob Mottram -#+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server -#+OPTIONS: ^:nil toc:nil -#+HTML_HEAD: - -#+BEGIN_CENTER -[[file:images/logo.png]] -#+END_CENTER - -#+BEGIN_EXPORT html -
-

Variants

-
-#+END_EXPORT - -Freedombone may be installed either in its entirety or as different variants with a more specialised purpose. So for example if you just want to run a blog but don't care about any other services then you can do that. The following variants are available: - -#+BEGIN_EXPORT html -
- - - - - - - - - - - - - - - - - -
Mailbox
An email server with GPG encryption
Cloud
Sync and share files. Never lose important files again
Social
Social networking with Hubzilla and GNU Social
Media
Runs media services such as DLNA to play music or videos on your devices
Writer
Host your blog and wiki
Chat
Encrypted IRC, XMPP, Tox and VoIP services for one-to-one and many-to-many chat
Developer
Github-like system to host your software projects
Mesh
A wireless mesh network which is like the internet, but not the internet
-
-#+END_EXPORT - -Non-mesh installs also come with an RSS reader which provides strong reading privacy on desktop and mobile via the use of a Tor onion service. - -#+BEGIN_EXPORT html -
-Return to the home page -
-#+END_EXPORT diff --git a/website/EN/mirrors.html b/website/EN/mirrors.html deleted file mode 100644 index 1e721178..00000000 --- a/website/EN/mirrors.html +++ /dev/null @@ -1,366 +0,0 @@ - - - - - - - - - - - - - - - - - -
- -
-
-
- -
-

logo.png -

-
-
- -
-

Mirrors

-
- - - - --- - - - - - - - - - - - - - - - - - - - - - -
What are mirrors and why do they exist?
What security do mirrors have?
How do I set up mirrors?
Do mirrors include debian package repositories?
What do I need to do to keep the mirrored repositories updated?
- -
-

What are mirrors and why do they exist?

-
-

-It would be nice if all of the applications used by this project were packaged for Debian, but currently they're not. This means that various upstream git repositories are used and these mostly reside on Github. What if Github were to go away, become paying only or be censored in some manner which was difficult to work around? To guard against this possibility the repositories are mirrored on each install and can then be made available to other users so that new installations or updates could still occur without the original default repos. -

-
-
-
-

What security do mirrors have?

-
-

-On each install you have a mirrors user created, whose only purpose is to mirror upstream repositories. A random password is generated for the mirrors user which can be seen within the control panel and so given to other users who may need it. -

-
-
-
-

How do I set up mirrors?

-
-

-The interactive installer will ask whether you want to configure the main respositories. Enter the URL, which will typically be an onion address, the ssh port number and the password for the mirrors on that system. -

-
-
-
-

Do mirrors include debian package repositories?

-
-

-No. Packages for Debian will still be accessed in the conventional manner. -

-
-
-
-

Can I change mirrors after the system has been installed

-
-

-Yes. From the control panel select "Set the main repository" -

- -
- -
-

control_panel_mirrors.jpg -

-
-
-
-
- -
-

What do I need to do to keep the mirrored repositories updated?

-
-

-Nothing. That happens as part of regular automatic updates. -

- -
-Return to the home page -
-
-
-
-
- - - - -
- - diff --git a/website/EN/related.html b/website/EN/related.html deleted file mode 100644 index 47da1bfd..00000000 --- a/website/EN/related.html +++ /dev/null @@ -1,305 +0,0 @@ - - - - - - - - - - - - - - - - - -
- -
-
-
- -
-

logo.png -

-
-
- -
-

Related Projects

-
- -
-The following projects made Freedombone possible.
- - - - - - - - - - - - - - - - - - - - - - - - - -
Nginx
Openssl
Gnupg
Debian
Freedombox
Beagleboard
Dokuwiki
GNU Social
Hubzilla
Tor
Prosody
Syncthing
Tox
Bettercrypto
-
-
-
- - - - -
- - diff --git a/website/EN/variants.html b/website/EN/variants.html deleted file mode 100644 index 8fed739a..00000000 --- a/website/EN/variants.html +++ /dev/null @@ -1,308 +0,0 @@ - - - - - - - - - - - - - - - - - -
- -
-
-
- -
-

logo.png -

-
-
- -
-

Variants

-
- -

-Freedombone may be installed either in its entirety or as different variants with a more specialised purpose. So for example if you just want to run a blog but don't care about any other services then you can do that. The following variants are available: -

- -
- - - - - - - - - - - - - - - - - -
Mailbox
An email server with GPG encryption
Cloud
Sync and share files. Never lose important files again
Social
Social networking with Hubzilla and GNU Social
Media
Runs media services such as DLNA to play music or videos on your devices
Writer
Host your blog and wiki
Chat
Encrypted IRC, XMPP, Tox and VoIP services for one-to-one and many-to-many chat
Developer
Github-like system to host your software projects
Mesh
A wireless mesh network which is like the internet, but not the internet
-
- -

-Non-mesh installs also come with an RSS reader which provides strong reading privacy on desktop and mobile via the use of a Tor onion service. -

- -
-Return to the home page -
-
-
- - - - -
- -