Bob Mottram 9 лет назад
Родитель
Сommit
6be42f4d81
1 измененных файлов: 168 добавлений и 125 удалений
  1. 168
    125
      website/EN/faq.html

+ 168
- 125
website/EN/faq.html Просмотреть файл

@@ -4,25 +4,32 @@
4 4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5 5
 <head>
6 6
 <title></title>
7
-<!-- 2015-10-27 Tue 11:37 -->
7
+<!-- 2015-10-27 Tue 13:14 -->
8 8
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
9 9
 <meta  name="generator" content="Org-mode" />
10 10
 <meta  name="author" content="Bob Mottram" />
11 11
 <meta  name="description" content="Turn the Beaglebone Black into a personal communications server"
12 12
  />
13 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" />
14 15
 <style type="text/css">
15 16
  <!--/*--><![CDATA[/*><!--*/
16
-  .title  { text-align: center; }
17
+  .title  { text-align: center;
18
+             margin-bottom: .2em; }
19
+  .subtitle { text-align: center;
20
+              font-size: medium;
21
+              font-weight: bold;
22
+              margin-top:0; }
17 23
   .todo   { font-family: monospace; color: red; }
18
-  .done   { color: green; }
24
+  .done   { font-family: monospace; color: green; }
25
+  .priority { font-family: monospace; color: orange; }
19 26
   .tag    { background-color: #eee; font-family: monospace;
20 27
             padding: 2px; font-size: 80%; font-weight: normal; }
21 28
   .timestamp { color: #bebebe; }
22 29
   .timestamp-kwd { color: #5f9ea0; }
23
-  .right  { margin-left: auto; margin-right: 0px;  text-align: right; }
24
-  .left   { margin-left: 0px;  margin-right: auto; text-align: left; }
25
-  .center { margin-left: auto; margin-right: auto; text-align: center; }
30
+  .org-right  { margin-left: auto; margin-right: 0px;  text-align: right; }
31
+  .org-left   { margin-left: 0px;  margin-right: auto; text-align: left; }
32
+  .org-center { margin-left: auto; margin-right: auto; text-align: center; }
26 33
   .underline { text-decoration: underline; }
27 34
   #postamble p, #preamble p { font-size: 90%; margin: .2em; }
28 35
   p.verse { margin-left: 3%; }
@@ -61,12 +68,12 @@
61 68
   caption.t-above { caption-side: top; }
62 69
   caption.t-bottom { caption-side: bottom; }
63 70
   td, th { vertical-align:top;  }
64
-  th.right  { text-align: center;  }
65
-  th.left   { text-align: center;   }
66
-  th.center { text-align: center; }
67
-  td.right  { text-align: right;  }
68
-  td.left   { text-align: left;   }
69
-  td.center { text-align: center; }
71
+  th.org-right  { text-align: center;  }
72
+  th.org-left   { text-align: center;   }
73
+  th.org-center { text-align: center; }
74
+  td.org-right  { text-align: right;  }
75
+  td.org-left   { text-align: left;   }
76
+  td.org-center { text-align: center; }
70 77
   dt { font-weight: bold; }
71 78
   .footpara:nth-child(2) { display: inline; }
72 79
   .footpara { display: block; }
@@ -91,6 +98,10 @@
91 98
     { background-color: #ffff00; color: #000000; font-weight: bold; }
92 99
   /*]]>*/-->
93 100
 </style>
101
+<link rel="stylesheet" type="text/css"
102
+href="http://sachachua.com/blog/wp-content/themes/sacha-v3/foundation/css/foundation.min.css"></link>
103
+<link rel="stylesheet" type="text/css" href="http://sachachua.com/org-export.css"></link>
104
+<link rel="stylesheet" type="text/css" href="http://sachachua.com/blog/wp-content/themes/sacha-v3/style.css"></link>
94 105
 <script type="text/javascript">
95 106
 /*
96 107
 @licstart  The following is the entire license notice for the
@@ -139,8 +150,10 @@ for the JavaScript code in this tag.
139 150
 </script>
140 151
 </head>
141 152
 <body>
153
+<div id="preamble" class="status">
154
+<a name="top" id="top"></a>
155
+</div>
142 156
 <div id="content">
143
-<h1 class="title"></h1>
144 157
 <div class="center">
145 158
 
146 159
 <div class="figure">
@@ -154,91 +167,91 @@ for the JavaScript code in this tag.
154 167
 
155 168
 
156 169
 <colgroup>
157
-<col  class="left" />
170
+<col  class="org-left" />
158 171
 </colgroup>
159 172
 <tbody>
160 173
 <tr>
161
-<td class="left"><a href="index.html">Home</a></td>
174
+<td class="org-left"><a href="index.html">Home</a></td>
162 175
 </tr>
163 176
 
164 177
 <tr>
165
-<td class="left"><a href="#sec-1">1</a></td>
178
+<td class="org-left"><a href="#orgheadline1">Why not supply a disk image download?</a></td>
166 179
 </tr>
167 180
 
168 181
 <tr>
169
-<td class="left"><a href="#sec-2">2</a></td>
182
+<td class="org-left"><a href="#orgheadline2">I don't have a static IP address. Can I still install this system?</a></td>
170 183
 </tr>
171 184
 
172 185
 <tr>
173
-<td class="left"><a href="#sec-3">3</a></td>
186
+<td class="org-left"><a href="#orgheadline3">What is the best hardware to run this system on?</a></td>
174 187
 </tr>
175 188
 
176 189
 <tr>
177
-<td class="left"><a href="#sec-4">4</a></td>
190
+<td class="org-left"><a href="#orgheadline4">Can I add more users to the system?</a></td>
178 191
 </tr>
179 192
 
180 193
 <tr>
181
-<td class="left"><a href="#sec-5">5</a></td>
194
+<td class="org-left"><a href="#orgheadline5">How do I remove a user from the system?</a></td>
182 195
 </tr>
183 196
 
184 197
 <tr>
185
-<td class="left"><a href="#sec-6">6</a></td>
198
+<td class="org-left"><a href="#orgheadline6">How do I reset the tripwire?</a></td>
186 199
 </tr>
187 200
 
188 201
 <tr>
189
-<td class="left"><a href="#sec-7">7</a></td>
202
+<td class="org-left"><a href="#orgheadline7">Is metadata protected?</a></td>
190 203
 </tr>
191 204
 
192 205
 <tr>
193
-<td class="left"><a href="#sec-8">8</a></td>
206
+<td class="org-left"><a href="#orgheadline8">How do I create email processing rules?</a></td>
194 207
 </tr>
195 208
 
196 209
 <tr>
197
-<td class="left"><a href="#sec-9">9</a></td>
210
+<td class="org-left"><a href="#orgheadline9">Why isn't dynamic DNS working?</a></td>
198 211
 </tr>
199 212
 
200 213
 <tr>
201
-<td class="left"><a href="#sec-10">10</a></td>
214
+<td class="org-left"><a href="#orgheadline10">How do I change my encryption settings?</a></td>
202 215
 </tr>
203 216
 
204 217
 <tr>
205
-<td class="left"><a href="#sec-11">11</a></td>
218
+<td class="org-left"><a href="#orgheadline11">How do I get a domain name?</a></td>
206 219
 </tr>
207 220
 
208 221
 <tr>
209
-<td class="left"><a href="#sec-12">12</a></td>
222
+<td class="org-left"><a href="#orgheadline12">How do I get a "real" SSL certificate?</a></td>
210 223
 </tr>
211 224
 
212 225
 <tr>
213
-<td class="left"><a href="#sec-13">13</a></td>
226
+<td class="org-left"><a href="#orgheadline13">How do I renew a StartSSL certificate?</a></td>
214 227
 </tr>
215 228
 
216 229
 <tr>
217
-<td class="left"><a href="#sec-14">14</a></td>
230
+<td class="org-left"><a href="#orgheadline14">Why use self-signed certificates?</a></td>
218 231
 </tr>
219 232
 
220 233
 <tr>
221
-<td class="left"><a href="#sec-15">15</a></td>
234
+<td class="org-left"><a href="#orgheadline15">Why not use the services of $company instead? They took the Seppuku pledge</a></td>
222 235
 </tr>
223 236
 
224 237
 <tr>
225
-<td class="left"><a href="#sec-16">16</a></td>
238
+<td class="org-left"><a href="#orgheadline16">Why does my email keep getting rejected as spam by Gmail/etc?</a></td>
226 239
 </tr>
227 240
 </tbody>
228 241
 </table>
229 242
 </div>
230 243
 
231
-<div id="outline-container-sec-1" class="outline-2">
232
-<h2 id="sec-1"><span class="section-number-2">1</span> Why not supply a disk image download?</h2>
233
-<div class="outline-text-2" id="text-1">
244
+<div id="outline-container-orgheadline1" class="outline-2">
245
+<h2 id="orgheadline1">Why not supply a disk image download?</h2>
246
+<div class="outline-text-2" id="text-orgheadline1">
234 247
 <p>
235 248
 Shipping a Freedombone disk image ready to install on a flash disk would be easy, but disk images are relatively opaque. It would be quite easy to hide something nasty within a disk image and the user might never know. To guard against that possibility installing via the <b>freedombone</b> command is a lot more transparent, since it's really just a bash script. You can check the script code to see exactly what it's doing, and the packages are all downloaded from standard Debian repos (you can even choose which one you trust) or git repos. Doing it this way the system is fully auditable, whereas when shipping a disk image it's harder to be confident that no nefarious extras have been added.
236 249
 </p>
237 250
 </div>
238 251
 </div>
239
-<div id="outline-container-sec-2" class="outline-2">
240
-<h2 id="sec-2"><span class="section-number-2">2</span> I don't have a static IP address. Can I still install this system?</h2>
241
-<div class="outline-text-2" id="text-2">
252
+<div id="outline-container-orgheadline2" class="outline-2">
253
+<h2 id="orgheadline2">I don't have a static IP address. Can I still install this system?</h2>
254
+<div class="outline-text-2" id="text-orgheadline2">
242 255
 <p>
243 256
 Yes. The minimum requirements are to have some hardware that you can install Debian onto and also that you have administrator access to your internet router so that you can forward ports to the system which has Freedombone installed.
244 257
 </p>
@@ -248,9 +261,9 @@ The lack of a static IP address can be worked around by using a dynamic DNS serv
248 261
 </p>
249 262
 </div>
250 263
 </div>
251
-<div id="outline-container-sec-3" class="outline-2">
252
-<h2 id="sec-3"><span class="section-number-2">3</span> What is the best hardware to run this system on?</h2>
253
-<div class="outline-text-2" id="text-3">
264
+<div id="outline-container-orgheadline3" class="outline-2">
265
+<h2 id="orgheadline3">What is the best hardware to run this system on?</h2>
266
+<div class="outline-text-2" id="text-orgheadline3">
254 267
 <p>
255 268
 It was originally designed to run on the Beaglebone Black, but that should be regarded as the most minimal system, because it's single core and has by today's standards a small amount of memory. Obviously the more powerful the hardware is the faster things like web pages (blog, social networking, etc) will be served but the more electricity such a system will require if you're running it 24/7. A good compromise between performance and energy consumption is something like an old netbook. The battery of an old netbook or laptop even gives you <a href="https://en.wikipedia.org/wiki/Uninterruptible_power_supply">UPS capability</a> to keep the system going during brief power outages or cable re-arrangements, and that means using full disk encryption on the server also becomes more practical.
256 269
 </p>
@@ -260,9 +273,9 @@ It was originally designed to run on the Beaglebone Black, but that should be re
260 273
 </p>
261 274
 </div>
262 275
 </div>
263
-<div id="outline-container-sec-4" class="outline-2">
264
-<h2 id="sec-4"><span class="section-number-2">4</span> Can I add more users to the system?</h2>
265
-<div class="outline-text-2" id="text-4">
276
+<div id="outline-container-orgheadline4" class="outline-2">
277
+<h2 id="orgheadline4">Can I add more users to the system?</h2>
278
+<div class="outline-text-2" id="text-orgheadline4">
266 279
 <p>
267 280
 Yes. Freedombone can support a small number of users, for a "<i>friends and family</i>" type of home installation. This gives them access to an email account, XMPP and the blog (depending on whether the variant which you installed includes those). To add a user login as root then run the command:
268 281
 </p>
@@ -282,9 +295,9 @@ Another point is that Freedombone installations are not intended to support many
282 295
 </p>
283 296
 </div>
284 297
 </div>
285
-<div id="outline-container-sec-5" class="outline-2">
286
-<h2 id="sec-5"><span class="section-number-2">5</span> How do I remove a user from the system?</h2>
287
-<div class="outline-text-2" id="text-5">
298
+<div id="outline-container-orgheadline5" class="outline-2">
299
+<h2 id="orgheadline5">How do I remove a user from the system?</h2>
300
+<div class="outline-text-2" id="text-orgheadline5">
288 301
 <p>
289 302
 To remove a user login as root then run the command:
290 303
 </p>
@@ -296,9 +309,9 @@ To remove a user login as root then run the command:
296 309
 </div>
297 310
 </div>
298 311
 </div>
299
-<div id="outline-container-sec-6" class="outline-2">
300
-<h2 id="sec-6"><span class="section-number-2">6</span> How do I reset the tripwire?</h2>
301
-<div class="outline-text-2" id="text-6">
312
+<div id="outline-container-orgheadline6" class="outline-2">
313
+<h2 id="orgheadline6">How do I reset the tripwire?</h2>
314
+<div class="outline-text-2" id="text-orgheadline6">
302 315
 <p>
303 316
 You will get a daily email which indicates which files on the system have changed recently. Once per week the system will install any updates and those may also show up on the list, along with any changes due to installed packages or changed settings. Watch out for any files which change unexpectedly, which could indicate an intruder. To reset the tripwire:
304 317
 </p>
@@ -316,17 +329,17 @@ You will need to press enter a couple of times. Doing this typically once per we
316 329
 </p>
317 330
 </div>
318 331
 </div>
319
-<div id="outline-container-sec-7" class="outline-2">
320
-<h2 id="sec-7"><span class="section-number-2">7</span> Is metadata protected?</h2>
321
-<div class="outline-text-2" id="text-7">
332
+<div id="outline-container-orgheadline7" class="outline-2">
333
+<h2 id="orgheadline7">Is metadata protected?</h2>
334
+<div class="outline-text-2" id="text-orgheadline7">
322 335
 <p>
323 336
 Even when using Freedombone metadata analysis by third parties is still possible. They might have a much harder time knowing what the content is, but they can potentially construct extensive dossiers based upon who communicated with your server when.  Metadata leakage is a general problem with most current web systems and it is hoped that more secure technology will become available in future. But for now if metadata protection is your main concern using Freedombone won't help.
324 337
 </p>
325 338
 </div>
326 339
 </div>
327
-<div id="outline-container-sec-8" class="outline-2">
328
-<h2 id="sec-8"><span class="section-number-2">8</span> How do I create email processing rules?</h2>
329
-<div class="outline-text-2" id="text-8">
340
+<div id="outline-container-orgheadline8" class="outline-2">
341
+<h2 id="orgheadline8">How do I create email processing rules?</h2>
342
+<div class="outline-text-2" id="text-orgheadline8">
330 343
 <p>
331 344
 You can administer email in the traditional manner by editing folders or procmail rules, but for convenience some commands are available to make that process simpler. See the relevant manpages for more details.
332 345
 </p>
@@ -335,39 +348,39 @@ You can administer email in the traditional manner by editing folders or procmai
335 348
 
336 349
 
337 350
 <colgroup>
338
-<col  class="left" />
351
+<col  class="org-left" />
339 352
 
340
-<col  class="left" />
353
+<col  class="org-left" />
341 354
 </colgroup>
342 355
 <tbody>
343 356
 <tr>
344
-<td class="left">freedombone-addlist</td>
345
-<td class="left">Adds a mailing list</td>
357
+<td class="org-left">freedombone-addlist</td>
358
+<td class="org-left">Adds a mailing list</td>
346 359
 </tr>
347 360
 
348 361
 <tr>
349
-<td class="left">freedombone-rmlist</td>
350
-<td class="left">Removes a mailing list</td>
362
+<td class="org-left">freedombone-rmlist</td>
363
+<td class="org-left">Removes a mailing list</td>
351 364
 </tr>
352 365
 
353 366
 <tr>
354
-<td class="left">freedombone-addemail</td>
355
-<td class="left">Transfers emails from an address to a given folder</td>
367
+<td class="org-left">freedombone-addemail</td>
368
+<td class="org-left">Transfers emails from an address to a given folder</td>
356 369
 </tr>
357 370
 
358 371
 <tr>
359
-<td class="left">freedombone-rmemail</td>
360
-<td class="left">Removes an email transferal rule</td>
372
+<td class="org-left">freedombone-rmemail</td>
373
+<td class="org-left">Removes an email transferal rule</td>
361 374
 </tr>
362 375
 
363 376
 <tr>
364
-<td class="left">freedombone-ignore</td>
365
-<td class="left">Ignores email from an address or with a subject line containing text</td>
377
+<td class="org-left">freedombone-ignore</td>
378
+<td class="org-left">Ignores email from an address or with a subject line containing text</td>
366 379
 </tr>
367 380
 
368 381
 <tr>
369
-<td class="left">freedombone-unignore</td>
370
-<td class="left">Removes an ignore rule</td>
382
+<td class="org-left">freedombone-unignore</td>
383
+<td class="org-left">Removes an ignore rule</td>
371 384
 </tr>
372 385
 </tbody>
373 386
 </table>
@@ -377,9 +390,9 @@ Spamassassin is also available and within Mutt you can use the S (shift+s) key t
377 390
 </p>
378 391
 </div>
379 392
 </div>
380
-<div id="outline-container-sec-9" class="outline-2">
381
-<h2 id="sec-9"><span class="section-number-2">9</span> Why isn't dynamic DNS working?</h2>
382
-<div class="outline-text-2" id="text-9">
393
+<div id="outline-container-orgheadline9" class="outline-2">
394
+<h2 id="orgheadline9">Why isn't dynamic DNS working?</h2>
395
+<div class="outline-text-2" id="text-orgheadline9">
383 396
 <p>
384 397
 If you run the command:
385 398
 </p>
@@ -447,9 +460,9 @@ http://httpbin.org/ip
447 460
 </div>
448 461
 </div>
449 462
 
450
-<div id="outline-container-sec-10" class="outline-2">
451
-<h2 id="sec-10"><span class="section-number-2">10</span> How do I change my encryption settings?</h2>
452
-<div class="outline-text-2" id="text-10">
463
+<div id="outline-container-orgheadline10" class="outline-2">
464
+<h2 id="orgheadline10">How do I change my encryption settings?</h2>
465
+<div class="outline-text-2" id="text-orgheadline10">
453 466
 <p>
454 467
 Suppose that some new encryption vulnerability has been announced and that you need to change your encryption settings. Maybe an algorithm thought to be secure is now no longer so and you need to remove it. You can change your settings by doing the following:
455 468
 </p>
@@ -467,9 +480,9 @@ You will then be able to edit the crypto settings for all of the installed appli
467 480
 </p>
468 481
 </div>
469 482
 </div>
470
-<div id="outline-container-sec-11" class="outline-2">
471
-<h2 id="sec-11"><span class="section-number-2">11</span> How do I get a domain name?</h2>
472
-<div class="outline-text-2" id="text-11">
483
+<div id="outline-container-orgheadline11" class="outline-2">
484
+<h2 id="orgheadline11">How do I get a domain name?</h2>
485
+<div class="outline-text-2" id="text-orgheadline11">
473 486
 <p>
474 487
 Suppose that you have bought a domain name (rather than using a free subdomain on freedns) and you want to use that instead.
475 488
 </p>
@@ -537,11 +550,11 @@ You should now be able to send an email from <i>postmaster@mynewdomainname</i> a
537 550
 </div>
538 551
 </div>
539 552
 
540
-<div id="outline-container-sec-12" class="outline-2">
541
-<h2 id="sec-12"><span class="section-number-2">12</span> How do I get a "real" SSL certificate?</h2>
542
-<div class="outline-text-2" id="text-12">
553
+<div id="outline-container-orgheadline12" class="outline-2">
554
+<h2 id="orgheadline12">How do I get a "real" SSL certificate?</h2>
555
+<div class="outline-text-2" id="text-orgheadline12">
543 556
 <p>
544
-You can obtain a free "official" (as in recognised by default by web browsers) SSL certificate from <a href="https://www.startssl.com/">StartSSL</a>. You will first need to have bought a domain name, since it's not possible to obtain one for a freedns subdomain, so see <a href="#sec-11">Using your own domain</a> for details of how to do that.  You should also have tested that you can send email to the domain and receive it on the Freedombone (via Mutt or any other email client).
557
+You can obtain a free "official" (as in recognised by default by web browsers) SSL certificate from <a href="https://www.startssl.com/">StartSSL</a>. You will first need to have bought a domain name, since it's not possible to obtain one for a freedns subdomain, so see <a href="#orgheadline11">Using your own domain</a> for details of how to do that.  You should also have tested that you can send email to the domain and receive it on the Freedombone (via Mutt or any other email client).
545 558
 </p>
546 559
 
547 560
 <p>
@@ -558,10 +571,10 @@ Now we can generate the certificate request as follows.
558 571
 
559 572
 <div class="org-src-container">
560 573
 
561
-<pre class="src src-bash">export HOSTNAME=mydomainname.com
562
-openssl genrsa -out /etc/ssl/private/$HOSTNAME.key 2048
563
-chown root:ssl-cert /etc/ssl/private/$HOSTNAME.key
564
-chmod 440 /etc/ssl/private/$HOSTNAME.key
574
+<pre class="src src-bash"><span class="org-builtin">export</span> <span class="org-variable-name">HOSTNAME</span>=mydomainname.com
575
+openssl genrsa -out /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.key 2048
576
+chown root:ssl-cert /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.key
577
+chmod 440 /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.key
565 578
 mkdir /etc/ssl/requests
566 579
 </pre>
567 580
 </div>
@@ -572,7 +585,7 @@ Now make a certificate request as follows.  You should copy and paste the whole
572 585
 
573 586
 <div class="org-src-container">
574 587
 
575
-<pre class="src src-bash">openssl req -new -sha256 -key /etc/ssl/private/$HOSTNAME.key -out /etc/ssl/requests/$HOSTNAME.csr
588
+<pre class="src src-bash">openssl req -new -sha256 -key /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.key -out /etc/ssl/requests/$<span class="org-variable-name">HOSTNAME</span>.csr
576 589
 </pre>
577 590
 </div>
578 591
 
@@ -590,7 +603,7 @@ View the request with:
590 603
 
591 604
 <div class="org-src-container">
592 605
 
593
-<pre class="src src-bash">cat /etc/ssl/requests/$HOSTNAME.csr
606
+<pre class="src src-bash">cat /etc/ssl/requests/$<span class="org-variable-name">HOSTNAME</span>.csr
594 607
 </pre>
595 608
 </div>
596 609
 
@@ -604,7 +617,7 @@ Log into your StartSSL account and select <b>Retrieve Certificate</b> from the <
604 617
 
605 618
 <div class="org-src-container">
606 619
 
607
-<pre class="src src-bash">editor /etc/ssl/certs/$HOSTNAME.crt
620
+<pre class="src src-bash">editor /etc/ssl/certs/$<span class="org-variable-name">HOSTNAME</span>.crt
608 621
 </pre>
609 622
 </div>
610 623
 
@@ -616,15 +629,15 @@ Paste the public key, then save and exit.  Then on the Freedombone.
616 629
 
617 630
 <pre class="src src-bash">mkdir /etc/ssl/roots
618 631
 mkdir /etc/ssl/chains
619
-wget "http://www.startssl.com/certs/ca.pem" --output-document="/etc/ssl/roots/startssl-root.ca"
620
-wget "http://www.startssl.com/certs/sub.class1.server.ca.pem" --output-document="/etc/ssl/chains/startssl-sub.class1.server.ca.pem"
621
-wget "http://www.startssl.com/certs/sub.class2.server.ca.pem" --output-document="/etc/ssl/chains/startssl-sub.class2.server.ca.pem"
622
-wget "http://www.startssl.com/certs/sub.class3.server.ca.pem" --output-document="/etc/ssl/chains/startssl-sub.class3.server.ca.pem"
623
-ln -s "/etc/ssl/roots/startssl-root.ca" "/etc/ssl/roots/$HOSTNAME-root.ca"
624
-ln -s "/etc/ssl/chains/startssl-sub.class1.server.ca.pem" "/etc/ssl/chains/$HOSTNAME.ca"
625
-cp "/etc/ssl/certs/$HOSTNAME.crt" "/etc/ssl/certs/$HOSTNAME.crt+chain+root"
626
-test -e "/etc/ssl/chains/$HOSTNAME.ca" &amp;&amp; cat "/etc/ssl/chains/$HOSTNAME.ca" &gt;&gt; "/etc/ssl/certs/$HOSTNAME.crt+chain+root"
627
-test -e "/etc/ssl/roots/$HOSTNAME-root.ca" &amp;&amp; cat "/etc/ssl/roots/$HOSTNAME-root.ca" &gt;&gt; "/etc/ssl/certs/$HOSTNAME.crt+chain+root"
632
+wget <span class="org-string">"http://www.startssl.com/certs/ca.pem"</span> --output-document=<span class="org-string">"/etc/ssl/roots/startssl-root.ca"</span>
633
+wget <span class="org-string">"http://www.startssl.com/certs/sub.class1.server.ca.pem"</span> --output-document=<span class="org-string">"/etc/ssl/chains/startssl-sub.class1.server.ca.pem"</span>
634
+wget <span class="org-string">"http://www.startssl.com/certs/sub.class2.server.ca.pem"</span> --output-document=<span class="org-string">"/etc/ssl/chains/startssl-sub.class2.server.ca.pem"</span>
635
+wget <span class="org-string">"http://www.startssl.com/certs/sub.class3.server.ca.pem"</span> --output-document=<span class="org-string">"/etc/ssl/chains/startssl-sub.class3.server.ca.pem"</span>
636
+ln -s <span class="org-string">"/etc/ssl/roots/startssl-root.ca"</span> <span class="org-string">"/etc/ssl/roots/$HOSTNAME-root.ca"</span>
637
+ln -s <span class="org-string">"/etc/ssl/chains/startssl-sub.class1.server.ca.pem"</span> <span class="org-string">"/etc/ssl/chains/$HOSTNAME.ca"</span>
638
+cp <span class="org-string">"/etc/ssl/certs/$HOSTNAME.crt"</span> <span class="org-string">"/etc/ssl/certs/$HOSTNAME.crt+chain+root"</span>
639
+<span class="org-builtin">test</span> -e <span class="org-string">"/etc/ssl/chains/$HOSTNAME.ca"</span> &amp;&amp; cat <span class="org-string">"/etc/ssl/chains/$HOSTNAME.ca"</span> &gt;&gt; <span class="org-string">"/etc/ssl/certs/$HOSTNAME.crt+chain+root"</span>
640
+<span class="org-builtin">test</span> -e <span class="org-string">"/etc/ssl/roots/$HOSTNAME-root.ca"</span> &amp;&amp; cat <span class="org-string">"/etc/ssl/roots/$HOSTNAME-root.ca"</span> &gt;&gt; <span class="org-string">"/etc/ssl/certs/$HOSTNAME.crt+chain+root"</span>
628 641
 </pre>
629 642
 </div>
630 643
 
@@ -637,8 +650,8 @@ To avoid any possibility of the certificates being accidentally overwritten by s
637 650
 <pre class="src src-bash">mkdir /etc/ssl/backups
638 651
 mkdir /etc/ssl/backups/certs
639 652
 mkdir /etc/ssl/backups/private
640
-cp /etc/ssl/certs/$HOSTNAME* /etc/ssl/backups/certs/
641
-cp /etc/ssl/private/$HOSTNAME* /etc/ssl/backups/private/
653
+cp /etc/ssl/certs/$<span class="org-variable-name">HOSTNAME</span>* /etc/ssl/backups/certs/
654
+cp /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>* /etc/ssl/backups/private/
642 655
 chmod -R 400 /etc/ssl/backups/certs/*
643 656
 chmod -R 400 /etc/ssl/backups/private/*
644 657
 </pre>
@@ -650,9 +663,9 @@ Remove the certificate password, so if the server is rebooted then it won't wait
650 663
 
651 664
 <div class="org-src-container">
652 665
 
653
-<pre class="src src-bash">openssl rsa -in /etc/ssl/private/$HOSTNAME.key -out /etc/ssl/private/$HOSTNAME.new.key
654
-cp /etc/ssl/private/$HOSTNAME.new.key /etc/ssl/private/$HOSTNAME.key
655
-shred -zu /etc/ssl/private/$HOSTNAME.new.key
666
+<pre class="src src-bash">openssl rsa -in /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.key -out /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.new.key
667
+cp /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.new.key /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.key
668
+shred -zu /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.new.key
656 669
 </pre>
657 670
 </div>
658 671
 
@@ -662,7 +675,7 @@ Create a bundled certificate which joins the certificate and chain file together
662 675
 
663 676
 <div class="org-src-container">
664 677
 
665
-<pre class="src src-bash">cat /etc/ssl/certs/$HOSTNAME.crt /etc/ssl/chains/startssl-sub.class1.server.ca.pem &gt; /etc/ssl/certs/$HOSTNAME.bundle.crt
678
+<pre class="src src-bash">cat /etc/ssl/certs/$<span class="org-variable-name">HOSTNAME</span>.crt /etc/ssl/chains/startssl-sub.class1.server.ca.pem &gt; /etc/ssl/certs/$<span class="org-variable-name">HOSTNAME</span>.bundle.crt
666 679
 </pre>
667 680
 </div>
668 681
 
@@ -673,7 +686,7 @@ And also add it to the overall bundle of certificates for the Freedombone. This
673 686
 <div class="org-src-container">
674 687
 
675 688
 <pre class="src src-bash">mkdir /etc/ssl/mycerts
676
-cp /etc/ssl/certs/$HOSTNAME.bundle.crt /etc/ssl/mycerts
689
+cp /etc/ssl/certs/$<span class="org-variable-name">HOSTNAME</span>.bundle.crt /etc/ssl/mycerts
677 690
 cat /etc/ssl/mycerts/*.crt &gt; /etc/ssl/freedombone-bundle.crt
678 691
 tar -czvf /etc/ssl/freedombone-certs.tar.gz /etc/ssl/mycerts/*.crt
679 692
 </pre>
@@ -685,7 +698,7 @@ Edit your configuration file.
685 698
 
686 699
 <div class="org-src-container">
687 700
 
688
-<pre class="src src-bash">editor /etc/nginx/sites-available/$HOSTNAME
701
+<pre class="src src-bash">editor /etc/nginx/sites-available/$<span class="org-variable-name">HOSTNAME</span>
689 702
 </pre>
690 703
 </div>
691 704
 
@@ -710,14 +723,14 @@ Save and exit, then restart the web server.
710 723
 </div>
711 724
 
712 725
 <p>
713
-Now visit your web site at <a href="https://mydomainname.com">https://mydomainname.com</a> and you should notice that there is no certificate warning displayed.  You will now be able to install systems which don't allow the use of self-signed certificates, such as <a href="https://github.com/redmatrix/hubzilla">Hubzilla</a>.
726
+Now visit your web site at <a href="https://mydomainname.com/">https://mydomainname.com/</a> and you should notice that there is no certificate warning displayed.  You will now be able to install systems which don't allow the use of self-signed certificates, such as <a href="https://github.com/redmatrix/hubzilla">Hubzilla</a>.
714 727
 </p>
715 728
 </div>
716 729
 </div>
717 730
 
718
-<div id="outline-container-sec-13" class="outline-2">
719
-<h2 id="sec-13"><span class="section-number-2">13</span> How do I renew a StartSSL certificate?</h2>
720
-<div class="outline-text-2" id="text-13">
731
+<div id="outline-container-orgheadline13" class="outline-2">
732
+<h2 id="orgheadline13">How do I renew a StartSSL certificate?</h2>
733
+<div class="outline-text-2" id="text-orgheadline13">
721 734
 <p>
722 735
 The StartSSL certificates last for a year. You can check the expiry date of your current certificate/s by going to your site and if you're using Firefox then click on the <b>lock icon</b>, select "<b>more information</b>" then "<b>view certificate</b>".
723 736
 </p>
@@ -731,7 +744,7 @@ Make sure that you have the StartSSL certificate which was created when you init
731 744
 </p>
732 745
 
733 746
 <p>
734
-Now go to <a href="https://startssl.com">startssl.com</a> and click on the keys icon on the right hand side to log in. Select the <b>Control panel</b> then <b>Validations Wizard</b> and choose <b>Email address validation</b>. Enter your email address, then wait for the validation email to show up in your inbox. It will contain a code when you can then enter.
747
+Now go to <a href="https://startssl.com/">startssl.com</a> and click on the keys icon on the right hand side to log in. Select the <b>Control panel</b> then <b>Validations Wizard</b> and choose <b>Email address validation</b>. Enter your email address, then wait for the validation email to show up in your inbox. It will contain a code when you can then enter.
735 748
 </p>
736 749
 
737 750
 <p>
@@ -787,9 +800,9 @@ The new certificate will then be installed.
787 800
 </p>
788 801
 </div>
789 802
 </div>
790
-<div id="outline-container-sec-14" class="outline-2">
791
-<h2 id="sec-14"><span class="section-number-2">14</span> Why use self-signed certificates?</h2>
792
-<div class="outline-text-2" id="text-14">
803
+<div id="outline-container-orgheadline14" class="outline-2">
804
+<h2 id="orgheadline14">Why use self-signed certificates?</h2>
805
+<div class="outline-text-2" id="text-orgheadline14">
793 806
 <p>
794 807
 Almost everywhere on the web you will read that self-signed certificates are worthless. They bring up scary looking browser warnings and gurus will advise you not to use them. Self-signed certificates are quite useful though. What the scary warnings mean - and it would be good if they explained this more clearly - is that you have an encrypted connection established but there is <i>no certainty about who that connection is with</i>. The usual solution to this is to get a "real" SSL certificate from one of the certificate authorities, but it's far from clear that such authorities can be trusted. There have been various scandals involving such organisations, and it does not seem plausible to assume that they are somehow immune to the sort of treatment which <a href="http://en.wikipedia.org/wiki/Lavabit">Lavabit</a> received. So although most internet users have been trained to look for the lock icon as an indication that the connection is secured that belief may not always be well founded.
795 808
 </p>
@@ -803,17 +816,17 @@ For now a self-signed certificate will probably in most cases protect your commu
803 816
 </p>
804 817
 </div>
805 818
 </div>
806
-<div id="outline-container-sec-15" class="outline-2">
807
-<h2 id="sec-15"><span class="section-number-2">15</span> Why not use the services of $company instead? They took the Seppuku pledge</h2>
808
-<div class="outline-text-2" id="text-15">
819
+<div id="outline-container-orgheadline15" class="outline-2">
820
+<h2 id="orgheadline15">Why not use the services of $company instead? They took the Seppuku pledge</h2>
821
+<div class="outline-text-2" id="text-orgheadline15">
809 822
 <p>
810
-<a href="http://seppuku.cryptostorm.org">That pledge</a> is utterly worthless. Years ago people trusted Google in the same sort of way, because they promised not be be evil and because a lot of the engineers working for them seemed like honest types who were "<i>on our side</i>". Post-<a href="https://en.wikipedia.org/wiki/Nymwars">nymwars</a> and post-<a href="https://en.wikipedia.org/wiki/PRISM_(surveillance_program)">PRISM</a> we know exactly how much Google cared about the privacy and security of its users. But Google is only one particular example. In general don't trust pledges made by companies, even if the people running them seem really sincere.
823
+<a href="http://seppuku.cryptostorm.org/">That pledge</a> is utterly worthless. Years ago people trusted Google in the same sort of way, because they promised not be be evil and because a lot of the engineers working for them seemed like honest types who were "<i>on our side</i>". Post-<a href="https://en.wikipedia.org/wiki/Nymwars">nymwars</a> and post-<a href="https://en.wikipedia.org/wiki/PRISM_(surveillance_program)">PRISM</a> we know exactly how much Google cared about the privacy and security of its users. But Google is only one particular example. In general don't trust pledges made by companies, even if the people running them seem really sincere.
811 824
 </p>
812 825
 </div>
813 826
 </div>
814
-<div id="outline-container-sec-16" class="outline-2">
815
-<h2 id="sec-16"><span class="section-number-2">16</span> Why does my email keep getting rejected as spam by Gmail/etc?</h2>
816
-<div class="outline-text-2" id="text-16">
827
+<div id="outline-container-orgheadline16" class="outline-2">
828
+<h2 id="orgheadline16">Why does my email keep getting rejected as spam by Gmail/etc?</h2>
829
+<div class="outline-text-2" id="text-orgheadline16">
817 830
 <p>
818 831
 Welcome to the world of email. Email is really the archetypal decentralized service, developed during the early days of the internet. In principle anyone can run an email server, and that's exactly what you're doing with Freedombone. Email is very useful, but it has a big problem, and that's that the protocols are totally insecure. That made it easy for spammers to do their thing, and in response highly elaborate spam filtering and blocking systems were developed. Chances are that your emails are being blocked in this way. Sometimes the blocking is so indisciminate that entire countries are excluded. What can you do about it? Unless you control the block list at the receiving end probably you can't do anything. There is zero accountability for such blocking, and you can't just contact someone and say "hey, I'm not a spammer". This system works well for the big internet companies because it effectively centralises email to a few well-known brand names and keeps any independent servers out.
819 832
 </p>
@@ -825,10 +838,40 @@ So the situation with email presently is pretty bad, and there's a clear selecti
825 838
 </div>
826 839
 </div>
827 840
 <div id="postamble" class="status">
828
-<p class="author">Author: Bob Mottram</p>
829
-<p class="date">Created: 2015-10-27 Tue 11:37</p>
830
-<p class="creator"><a href="http://www.gnu.org/software/emacs/">Emacs</a> 24.4.1 (<a href="http://orgmode.org">Org</a> mode 8.2.10)</p>
831
-<p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
841
+
842
+<style type="text/css">
843
+.back-to-top {
844
+    position: fixed;
845
+    bottom: 2em;
846
+    right: 0px;
847
+    text-decoration: none;
848
+    color: #000000;
849
+    background-color: rgba(235, 235, 235, 0.80);
850
+    font-size: 12px;
851
+    padding: 1em;
852
+    display: none;
853
+}
854
+
855
+.back-to-top:hover {
856
+    background-color: rgba(135, 135, 135, 0.50);
857
+}
858
+</style>
859
+
860
+<div class="back-to-top">
861
+<a href="#top">Back to top</a> | <a href="mailto:bob@robotics.uk.to">E-mail me</a>
862
+</div>
863
+
864
+<script type="text/javascript">
865
+    var offset = 220;
866
+    var duration = 500;
867
+    jQuery(window).scroll(function() {
868
+        if (jQuery(this).scrollTop() > offset) {
869
+            jQuery('.back-to-top').fadeIn(duration);
870
+        } else {
871
+            jQuery('.back-to-top').fadeOut(duration);
872
+        }
873
+    });
874
+</script>
832 875
 </div>
833 876
 </body>
834 877
 </html>