free
/
freedombone
Watch 1
Star 0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
Browse Source

Document running the client command

Bob Mottram 8 years ago
parent
adcc8878a4
commit
90b82e5ed4
2 changed files with 24 additions and 7 deletions
Unified View Show Diff Stats
  1. 10
    3
      doc/EN/homeserver.org
  2. 14
    4
      website/EN/homeserver.html

+ 10
- 3
doc/EN/homeserver.org View File

17
17
18 
 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.
 18 
 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.
19
19
20 
-First you will need to create an image. On a debian based distro:
20 
+First install freedombone onto your local system (not the target hardware that you want to run Freedombone on). On a debian based distro:
21
21
22 
 #+begin_src bash
 22 
 #+begin_src bash
23 
 sudo apt-get install git
 23 
 sudo apt-get install git
24 
 git clone https://github.com/bashrc/freedombone
 24 
 git clone https://github.com/bashrc/freedombone
25 
 cd freedombone
 25 
 cd freedombone
26 
 git checkout stockholm
 26 
 git checkout stockholm
27 
-make install
27 
+sudo make install
28 
 freedombone-image --setup debian
 28 
 freedombone-image --setup debian
29 
 freedombone-image -t i386 --onion yes
 29 
 freedombone-image -t i386 --onion yes
30 
 #+end_src
 30 
 #+end_src
36 
 git clone https://github.com/bashrc/freedombone
 36 
 git clone https://github.com/bashrc/freedombone
37 
 cd freedombone
 37 
 cd freedombone
38 
 git checkout stockholm
 38 
 git checkout stockholm
39 
-make install
39 
+sudo make install
40 
 freedombone-image --setup parabola
 40 
 freedombone-image --setup parabola
41 
 freedombone-image -t i386 --onion yes
 41 
 freedombone-image -t i386 --onion yes
42 
 #+end_src
 42 
 #+end_src
43
43
44 
+Now prepare your local system to talk to the freedombone by running. This will set up avahi and create ssh keys if necessary.
45 
+
46 
+#+begin_src bash
47 
+freedombone-client
48 
+#+end_src
49 
+
44 
 #+BEGIN_CENTER
 50 
 #+BEGIN_CENTER
45 
 [[file:images/tor_onion.jpg]]
 51 
 [[file:images/tor_onion.jpg]]
46 
 #+END_CENTER
 52 
 #+END_CENTER
53 
+
47 
 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.
 54 
 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.
48
55
49 
 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*.
 56 
 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*.

+ 14
- 4
website/EN/homeserver.html View File

3 
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 3 
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4 
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
 4 
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5 
 <head>
 5 
 <head>
6 
-<!-- 2016-11-11 Fri 21:30 -->
6 
+<!-- 2016-11-23 Wed 17:35 -->
7 
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
 7 
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
8 
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 8 
 <meta name="viewport" content="width=device-width, initial-scale=1" />
9 
 <title></title>
 9 
 <title></title>
251 
 </p>
 251 
 </p>
252
252
253 
 <p>
 253 
 <p>
254 
-First you will need to create an image. On a debian based distro:
254 
+First install freedombone onto your local system (not the target hardware that you want to run Freedombone on). On a debian based distro:
255 
 </p>
 255 
 </p>
256
256
257 
 <div class="org-src-container">
 257 
 <div class="org-src-container">
259 
 git clone https://github.com/bashrc/freedombone
 259 
 git clone https://github.com/bashrc/freedombone
260 
 <span class="org-builtin">cd</span> freedombone
 260 
 <span class="org-builtin">cd</span> freedombone
261 
 git checkout stockholm
 261 
 git checkout stockholm
262 
-make install
262 
+sudo make install
263 
 freedombone-image --setup debian
 263 
 freedombone-image --setup debian
264 
 freedombone-image -t i386 --onion yes
 264 
 freedombone-image -t i386 --onion yes
265 
 </pre>
 265 
 </pre>
274 
 git clone https://github.com/bashrc/freedombone
 274 
 git clone https://github.com/bashrc/freedombone
275 
 <span class="org-builtin">cd</span> freedombone
 275 
 <span class="org-builtin">cd</span> freedombone
276 
 git checkout stockholm
 276 
 git checkout stockholm
277 
-make install
277 
+sudo make install
278 
 freedombone-image --setup parabola
 278 
 freedombone-image --setup parabola
279 
 freedombone-image -t i386 --onion yes
 279 
 freedombone-image -t i386 --onion yes
280 
 </pre>
 280 
 </pre>
281 
 </div>
 281 
 </div>
282
282
283 
+<p>
284 
+Now prepare your local system to talk to the freedombone by running. This will set up avahi and create ssh keys if necessary.
285 
+</p>
286 
+
287 
+<div class="org-src-container">
288 
+<pre class="src src-bash">freedombone-client
289 
+</pre>
290 
+</div>
291 
+
283 
 <div class="org-center">
 292 
 <div class="org-center">
284
293
285 
 <div class="figure">
 294 
 <div class="figure">
287 
 </p>
 296 
 </p>
288 
 </div>
 297 
 </div>
289 
 </div>
 298 
 </div>
299 
+
290 
 <p>
 300 
 <p>
291 
 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 <b>&#x2013;onion yes</b> option from the last command shown above.
 301 
 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 <b>&#x2013;onion yes</b> option from the last command shown above.
292 
 </p>
 302 
 </p>