Browse Source

Installation

Bob Mottram 9 years ago
parent
commit
bfb8e6722f
3 changed files with 82 additions and 60 deletions
  1. 23
    6
      doc/EN/installation.org
  2. BIN
      img/freedom.png
  3. 59
    54
      website/EN/installation.html

+ 23
- 6
doc/EN/installation.org View File

4
 #+KEYWORDS: freedombox, debian, beaglebone, hubzilla, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber
4
 #+KEYWORDS: freedombox, debian, beaglebone, hubzilla, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber
5
 #+DESCRIPTION: Turn the Beaglebone Black into a personal communications server
5
 #+DESCRIPTION: Turn the Beaglebone Black into a personal communications server
6
 #+OPTIONS: ^:nil toc:nil
6
 #+OPTIONS: ^:nil toc:nil
7
-#+BEGIN_CENTER
8
-[[./images/logo.png]]
9
-#+END_CENTER
10
-| [[file:index.html][Home]] | [[Building an image for an SBC or Virtual Machine]] | [[Checklist]] | [[./mesh.html][Mesh network]] | [[Installation]] | [[Social Key Management (aka 'The Unforgettable Key')]] | [[Final Setup]] | [[Keydrives]] | [[On Client Machines]] | [[Administering the system]] |
11
 
7
 
12
-* Building an image for an SBC or Virtual Machine
8
+#+BEGIN_HTML
9
+<center>
10
+<a href="index.html"><img style="max-width: 100%; max-height: 100%; padding: 0; margin: 0; display: block; width:100%; top: 0; left: 0; float:right;" src="images/freedom.png"/></a>
11
+</center>
12
+<br><br><br><br><br>
13
+#+END_HTML
14
+
15
+#+BEGIN_HTML
16
+<font color="white">.</font> 
17
+#+END_HTML
18
+
19
+| [[Building an image for a Single Board Computer or Virtual Machine]] |
20
+| [[Checklist]]                                                        |
21
+| [[Mesh network]]                                                     |
22
+| [[Installation]]                                                     |
23
+| [[Social Key Management - the 'Unforgettable Key']]                  |
24
+| [[Final Setup]]                                                      |
25
+| [[Keydrives]]                                                        |
26
+| [[On Client Machines]]                                               |
27
+| [[Administering the system]]                                         |
28
+
29
+* Building an image for a Single Board Computer or Virtual Machine
13
 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.
30
 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.
14
 
31
 
15
 Install the freedombone commands onto your laptop/desktop:
32
 Install the freedombone commands onto your laptop/desktop:
141
 
158
 
142
 The default login will be username 'fbone' and password 'freedombone'. Take a note of the new login password and then you can proceed through the rest of the installation.
159
 The default login will be username 'fbone' and password 'freedombone'. Take a note of the new login password and then you can proceed through the rest of the installation.
143
 
160
 
144
-* Social Key Management (aka 'The Unforgettable Key')
161
+* Social Key Management - the 'Unforgettable Key'
145
 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
162
 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
146
 
163
 
147
 ** You have the gnupg keyring on an encrypted USB drive
164
 ** You have the gnupg keyring on an encrypted USB drive

BIN
img/freedom.png View File


+ 59
- 54
website/EN/installation.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
-<!-- 2015-12-04 Fri 09:59 -->
7
-<meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
8
-<meta  name="viewport" content="width=device-width, initial-scale=1" />
9
 <title></title>
6
 <title></title>
7
+<!-- 2015-12-14 Mon 22:30 -->
8
+<meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
10
 <meta  name="generator" content="Org-mode" />
9
 <meta  name="generator" content="Org-mode" />
11
 <meta  name="author" content="Bob Mottram" />
10
 <meta  name="author" content="Bob Mottram" />
12
 <meta  name="description" content="Turn the Beaglebone Black into a personal communications server"
11
 <meta  name="description" content="Turn the Beaglebone Black into a personal communications server"
13
  />
12
  />
14
 <meta  name="keywords" content="freedombox, debian, beaglebone, hubzilla, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber" />
13
 <meta  name="keywords" content="freedombox, debian, beaglebone, hubzilla, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber" />
14
+<meta  name="viewport" content="width=device-width, initial-scale=1" />
15
 <style type="text/css">
15
 <style type="text/css">
16
  <!--/*--><![CDATA[/*><!--*/
16
  <!--/*--><![CDATA[/*><!--*/
17
   .title  { text-align: center;
17
   .title  { text-align: center;
154
 <a name="top" id="top"></a>
154
 <a name="top" id="top"></a>
155
 </div>
155
 </div>
156
 <div id="content">
156
 <div id="content">
157
-<div class="center">
157
+<center>
158
+<a href="index.html"><img style="max-width: 100%; max-height: 100%; padding: 0; margin: 0; display: block; width:100%; top: 0; left: 0; float:right;" src="images/freedom.png"/></a>
159
+</center>
160
+<br><br><br><br><br>
161
+
162
+<font color="white">.</font> 
158
 
163
 
159
-<div class="figure">
160
-<p><img src="./images/logo.png" alt="logo.png" />
161
-</p>
162
-</div>
163
-</div>
164
 <table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
164
 <table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
165
 
165
 
166
 
166
 
167
 <colgroup>
167
 <colgroup>
168
 <col  class="org-left" />
168
 <col  class="org-left" />
169
+</colgroup>
170
+<tbody>
171
+<tr>
172
+<td class="org-left"><a href="#orgheadline1">Building an image for a Single Board Computer or Virtual Machine</a></td>
173
+</tr>
169
 
174
 
170
-<col  class="org-left" />
171
-
172
-<col  class="org-left" />
175
+<tr>
176
+<td class="org-left"><a href="#orgheadline2">Checklist</a></td>
177
+</tr>
173
 
178
 
174
-<col  class="org-left" />
179
+<tr>
180
+<td class="org-left"><a href="#orgheadline3">Mesh network</a></td>
181
+</tr>
175
 
182
 
176
-<col  class="org-left" />
183
+<tr>
184
+<td class="org-left"><a href="#orgheadline4">Installation</a></td>
185
+</tr>
177
 
186
 
178
-<col  class="org-left" />
187
+<tr>
188
+<td class="org-left"><a href="#orgheadline5">Social Key Management - the 'Unforgettable Key'</a></td>
189
+</tr>
179
 
190
 
180
-<col  class="org-left" />
191
+<tr>
192
+<td class="org-left"><a href="#orgheadline6">Final Setup</a></td>
193
+</tr>
181
 
194
 
182
-<col  class="org-left" />
195
+<tr>
196
+<td class="org-left"><a href="#orgheadline7">Keydrives</a></td>
197
+</tr>
183
 
198
 
184
-<col  class="org-left" />
199
+<tr>
200
+<td class="org-left"><a href="#orgheadline8">On Client Machines</a></td>
201
+</tr>
185
 
202
 
186
-<col  class="org-left" />
187
-</colgroup>
188
-<tbody>
189
 <tr>
203
 <tr>
190
-<td class="org-left"><a href="index.html">Home</a></td>
191
-<td class="org-left"><a href="#orgheadline1">Building an image for an SBC or Virtual Machine</a></td>
192
-<td class="org-left"><a href="#orgheadline2">Checklist</a></td>
193
-<td class="org-left"><a href="./mesh.html">Mesh network</a></td>
194
-<td class="org-left"><a href="#orgheadline3">Installation</a></td>
195
-<td class="org-left"><a href="#orgheadline4">Social Key Management (aka 'The Unforgettable Key')</a></td>
196
-<td class="org-left"><a href="#orgheadline5">Final Setup</a></td>
197
-<td class="org-left"><a href="#orgheadline6">Keydrives</a></td>
198
-<td class="org-left"><a href="#orgheadline7">On Client Machines</a></td>
199
-<td class="org-left"><a href="#orgheadline8">Administering the system</a></td>
204
+<td class="org-left"><a href="#orgheadline9">Administering the system</a></td>
200
 </tr>
205
 </tr>
201
 </tbody>
206
 </tbody>
202
 </table>
207
 </table>
203
 
208
 
204
 <div id="outline-container-orgheadline1" class="outline-2">
209
 <div id="outline-container-orgheadline1" class="outline-2">
205
-<h2 id="orgheadline1">Building an image for an SBC or Virtual Machine</h2>
210
+<h2 id="orgheadline1">Building an image for a Single Board Computer or Virtual Machine</h2>
206
 <div class="outline-text-2" id="text-orgheadline1">
211
 <div class="outline-text-2" id="text-orgheadline1">
207
 <p>
212
 <p>
208
 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 <b>freedombone-image</b> command.
213
 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 <b>freedombone-image</b> command.
295
 </ul>
300
 </ul>
296
 </div>
301
 </div>
297
 </div>
302
 </div>
298
-<div id="outline-container-orgheadline9" class="outline-2">
299
-<h2 id="orgheadline9">Mesh network</h2>
300
-<div class="outline-text-2" id="text-orgheadline9">
303
+<div id="outline-container-orgheadline3" class="outline-2">
304
+<h2 id="orgheadline3">Mesh network</h2>
305
+<div class="outline-text-2" id="text-orgheadline3">
301
 <p>
306
 <p>
302
 If you are installing one of the mesh network variants then see <a href="./mesh.html">these instructions</a> for details.
307
 If you are installing one of the mesh network variants then see <a href="./mesh.html">these instructions</a> for details.
303
 </p>
308
 </p>
304
 </div>
309
 </div>
305
 </div>
310
 </div>
306
-<div id="outline-container-orgheadline3" class="outline-2">
307
-<h2 id="orgheadline3">Installation</h2>
308
-<div class="outline-text-2" id="text-orgheadline3">
311
+<div id="outline-container-orgheadline4" class="outline-2">
312
+<h2 id="orgheadline4">Installation</h2>
313
+<div class="outline-text-2" id="text-orgheadline4">
309
 <p>
314
 <p>
310
 There are three install options: Laptop/Desktop/Netbook, SBC and Virtual Machine.
315
 There are three install options: Laptop/Desktop/Netbook, SBC and Virtual Machine.
311
 </p>
316
 </p>
440
 </div>
445
 </div>
441
 </div>
446
 </div>
442
 
447
 
443
-<div id="outline-container-orgheadline4" class="outline-2">
444
-<h2 id="orgheadline4">Social Key Management (aka 'The Unforgettable Key')</h2>
445
-<div class="outline-text-2" id="text-orgheadline4">
448
+<div id="outline-container-orgheadline5" class="outline-2">
449
+<h2 id="orgheadline5">Social Key Management - the 'Unforgettable Key'</h2>
450
+<div class="outline-text-2" id="text-orgheadline5">
446
 <p>
451
 <p>
447
 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
452
 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
448
 </p>
453
 </p>
460
 <h3 id="orgheadline14">You have a number of key fragments on USB drives retrieved from friends</h3>
465
 <h3 id="orgheadline14">You have a number of key fragments on USB drives retrieved from friends</h3>
461
 <div class="outline-text-3" id="text-orgheadline14">
466
 <div class="outline-text-3" id="text-orgheadline14">
462
 <p>
467
 <p>
463
-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 <a href="#orgheadline6">Keydrives</a>.
468
+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 <a href="#orgheadline7">Keydrives</a>.
464
 </p>
469
 </p>
465
 </div>
470
 </div>
466
 </div>
471
 </div>
473
 </div>
478
 </div>
474
 </div>
479
 </div>
475
 </div>
480
 </div>
476
-<div id="outline-container-orgheadline5" class="outline-2">
477
-<h2 id="orgheadline5">Final Setup</h2>
478
-<div class="outline-text-2" id="text-orgheadline5">
481
+<div id="outline-container-orgheadline6" class="outline-2">
482
+<h2 id="orgheadline6">Final Setup</h2>
483
+<div class="outline-text-2" id="text-orgheadline6">
479
 <p>
484
 <p>
480
 Any manual post-installation setup instructions or passwords can be found in /home/username/README. You should remove any passwords from that file and store them within a password manager such as KeepassX.
485
 Any manual post-installation setup instructions or passwords can be found in /home/username/README. You should remove any passwords from that file and store them within a password manager such as KeepassX.
481
 </p>
486
 </p>
598
 </div>
603
 </div>
599
 </div>
604
 </div>
600
 
605
 
601
-<div id="outline-container-orgheadline6" class="outline-2">
602
-<h2 id="orgheadline6">Keydrives</h2>
603
-<div class="outline-text-2" id="text-orgheadline6">
606
+<div id="outline-container-orgheadline7" class="outline-2">
607
+<h2 id="orgheadline7">Keydrives</h2>
608
+<div class="outline-text-2" id="text-orgheadline7">
604
 <p>
609
 <p>
605
 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:
610
 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:
606
 </p>
611
 </p>
648
 </div>
653
 </div>
649
 </div>
654
 </div>
650
 </div>
655
 </div>
651
-<div id="outline-container-orgheadline7" class="outline-2">
652
-<h2 id="orgheadline7">On Client Machines</h2>
653
-<div class="outline-text-2" id="text-orgheadline7">
656
+<div id="outline-container-orgheadline8" class="outline-2">
657
+<h2 id="orgheadline8">On Client Machines</h2>
658
+<div class="outline-text-2" id="text-orgheadline8">
654
 <p>
659
 <p>
655
 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.
660
 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.
656
 </p>
661
 </p>
668
 </div>
673
 </div>
669
 </div>
674
 </div>
670
 
675
 
671
-<div id="outline-container-orgheadline8" class="outline-2">
672
-<h2 id="orgheadline8">Administering the system</h2>
673
-<div class="outline-text-2" id="text-orgheadline8">
676
+<div id="outline-container-orgheadline9" class="outline-2">
677
+<h2 id="orgheadline9">Administering the system</h2>
678
+<div class="outline-text-2" id="text-orgheadline9">
674
 <p>
679
 <p>
675
 To administer the system after installation log in via ssh, become the root user and then launch the control panel.
680
 To administer the system after installation log in via ssh, become the root user and then launch the control panel.
676
 </p>
681
 </p>