From 90b82e5ed4c5ce505ab60b66d2c74fb826016836 Mon Sep 17 00:00:00 2001 From: Bob Mottram Date: Wed, 23 Nov 2016 17:36:09 +0000 Subject: [PATCH] Document running the client command --- doc/EN/homeserver.org | 13 ++++++++++--- website/EN/homeserver.html | 18 ++++++++++++++---- 2 files changed, 24 insertions(+), 7 deletions(-) diff --git a/doc/EN/homeserver.org b/doc/EN/homeserver.org index c7032544..d34c59b9 100644 --- a/doc/EN/homeserver.org +++ b/doc/EN/homeserver.org @@ -17,14 +17,14 @@ 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. -First you will need to create an image. On a debian based distro: +First install freedombone onto your local system (not the target hardware that you want to run Freedombone on). On a debian based distro: #+begin_src bash sudo apt-get install git git clone https://github.com/bashrc/freedombone cd freedombone git checkout stockholm -make install +sudo make install freedombone-image --setup debian freedombone-image -t i386 --onion yes #+end_src @@ -36,14 +36,21 @@ sudo pacman -S git git clone https://github.com/bashrc/freedombone cd freedombone git checkout stockholm -make install +sudo make install freedombone-image --setup parabola freedombone-image -t i386 --onion yes #+end_src +Now prepare your local system to talk to the freedombone by running. This will set up avahi and create ssh keys if necessary. + +#+begin_src bash +freedombone-client +#+end_src + #+BEGIN_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 yes* option from the last command shown above. 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*. diff --git a/website/EN/homeserver.html b/website/EN/homeserver.html index 275f1525..0aa5d1f8 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"> - + @@ -251,7 +251,7 @@ The quickest way to get started is as follows. You will need to be running a Deb

-First you will need to create an image. On a debian based distro: +First install freedombone onto your local system (not the target hardware that you want to run Freedombone on). On a debian based distro:

@@ -259,7 +259,7 @@ First you will need to create an image. On a debian based distro: git clone https://github.com/bashrc/freedombone cd freedombone git checkout stockholm -make install +sudo make install freedombone-image --setup debian freedombone-image -t i386 --onion yes @@ -274,12 +274,21 @@ Or on Arch/Parabola: git clone https://github.com/bashrc/freedombone cd freedombone git checkout stockholm -make install +sudo make install freedombone-image --setup parabola freedombone-image -t i386 --onion yes
+

+Now prepare your local system to talk to the freedombone by running. This will set up avahi and create ssh keys if necessary. +

+ +
+
freedombone-client
+
+
+
@@ -287,6 +296,7 @@ freedombone-image -t i386 --onion yes

+

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 yes option from the last command shown above.