Bob Mottram před 9 roky
rodič
revize
54a585b620
3 změnil soubory, kde provedl 170 přidání a 166 odebrání
  1. 16
    1
      doc/EN/faq.org
  2. binární
      man/freedombone-adduser.1.gz
  3. 154
    165
      website/EN/faq.html

+ 16
- 1
doc/EN/faq.org Zobrazit soubor

@@ -15,6 +15,7 @@
15 15
 | [[I don't have a static IP address. Can I still install this system?]]         |
16 16
 | [[What is the best hardware to run this system on?]]                           |
17 17
 | [[Can I add more users to the system?]]                                        |
18
+| [[How do I remove a user from the system?]]                                    |
18 19
 | [[How do I reset the tripwire?]]                                               |
19 20
 | [[Is metadata protected?]]                                                     |
20 21
 | [[How do I create email processing rules?]]                                    |
@@ -39,7 +40,21 @@ It was originally designed to run on the Beaglebone Black, but that should be re
39 40
 
40 41
 /Out of fashion/ but still working computer hardware tends to be cheap and readily available, yet still good for providing internet services.
41 42
 * Can I add more users to the system?
42
-Like any other GNU/Linux system you can add more users. It's easy to add users to Owncloud, XMPP or Hubzilla. However, Freedombone is designed primarily to be a single user system (i.e. a personal server) and if there are multiple users then the number of them is expected to be small - perhaps five or less. Freedombone is not intended to be "/web scale/" in terms of supporting tens or hundreds of users on a single server. Instead, each server can host a small number of users and then the servers federate together as a network of peers.
43
+Yes. Freedombone can support a small number of users, for a "/friends and family/" 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:
44
+
45
+#+BEGIN_SRC bash
46
+freedombone-adduser [username]
47
+#+END_SRC
48
+
49
+Something to consider when having more than a single user on the system is the security situation. The original administrator user will have access to all of the data for other users (including their encryption keys), so if you do add extra users they need to have *complete trust* in the administrator.
50
+
51
+Another point is that Freedombone installations are not intended to support many users (maybe ten at most). Large numbers of users may make the system unstable, and the more users you have on one system the more it becomes a single point of failure and also perhaps a honeypot from the standpoint of adversaries. Think of what happened with Lavabit and the moral dilemma which an administrator can be faced with (comply with threats and betray the trust of your users or don't comply and suffer other consequences). Ideally, you never want to put yourself into a situation where you can be forced to betray others.
52
+* How do I remove a user from the system?
53
+To remove a user login as root then run the command:
54
+
55
+#+BEGIN_SRC bash
56
+freedombone-rmuser [username]
57
+#+END_SRC
43 58
 * How do I reset the tripwire?
44 59
 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:
45 60
 

binární
man/freedombone-adduser.1.gz Zobrazit soubor


+ 154
- 165
website/EN/faq.html Zobrazit soubor

@@ -4,32 +4,25 @@
4 4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5 5
 <head>
6 6
 <title></title>
7
-<!-- 2015-09-08 Tue 19:27 -->
7
+<!-- 2015-10-27 Tue 11:37 -->
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" />
15 14
 <style type="text/css">
16 15
  <!--/*--><![CDATA[/*><!--*/
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; }
16
+  .title  { text-align: center; }
23 17
   .todo   { font-family: monospace; color: red; }
24
-  .done   { font-family: monospace; color: green; }
25
-  .priority { font-family: monospace; color: orange; }
18
+  .done   { color: green; }
26 19
   .tag    { background-color: #eee; font-family: monospace;
27 20
             padding: 2px; font-size: 80%; font-weight: normal; }
28 21
   .timestamp { color: #bebebe; }
29 22
   .timestamp-kwd { color: #5f9ea0; }
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; }
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; }
33 26
   .underline { text-decoration: underline; }
34 27
   #postamble p, #preamble p { font-size: 90%; margin: .2em; }
35 28
   p.verse { margin-left: 3%; }
@@ -68,12 +61,12 @@
68 61
   caption.t-above { caption-side: top; }
69 62
   caption.t-bottom { caption-side: bottom; }
70 63
   td, th { vertical-align:top;  }
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; }
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; }
77 70
   dt { font-weight: bold; }
78 71
   .footpara:nth-child(2) { display: inline; }
79 72
   .footpara { display: block; }
@@ -98,10 +91,6 @@
98 91
     { background-color: #ffff00; color: #000000; font-weight: bold; }
99 92
   /*]]>*/-->
100 93
 </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>
105 94
 <script type="text/javascript">
106 95
 /*
107 96
 @licstart  The following is the entire license notice for the
@@ -150,10 +139,8 @@ for the JavaScript code in this tag.
150 139
 </script>
151 140
 </head>
152 141
 <body>
153
-<div id="preamble" class="status">
154
-<a name="top" id="top"></a>
155
-</div>
156 142
 <div id="content">
143
+<h1 class="title"></h1>
157 144
 <div class="center">
158 145
 
159 146
 <div class="figure">
@@ -167,87 +154,91 @@ for the JavaScript code in this tag.
167 154
 
168 155
 
169 156
 <colgroup>
170
-<col  class="org-left" />
157
+<col  class="left" />
171 158
 </colgroup>
172 159
 <tbody>
173 160
 <tr>
174
-<td class="org-left"><a href="index.html">Home</a></td>
161
+<td class="left"><a href="index.html">Home</a></td>
175 162
 </tr>
176 163
 
177 164
 <tr>
178
-<td class="org-left"><a href="#orgheadline1">Why not supply a disk image download?</a></td>
165
+<td class="left"><a href="#sec-1">1</a></td>
179 166
 </tr>
180 167
 
181 168
 <tr>
182
-<td class="org-left"><a href="#orgheadline2">I don't have a static IP address. Can I still install this system?</a></td>
169
+<td class="left"><a href="#sec-2">2</a></td>
183 170
 </tr>
184 171
 
185 172
 <tr>
186
-<td class="org-left"><a href="#orgheadline3">What is the best hardware to run this system on?</a></td>
173
+<td class="left"><a href="#sec-3">3</a></td>
187 174
 </tr>
188 175
 
189 176
 <tr>
190
-<td class="org-left"><a href="#orgheadline4">Can I add more users to the system?</a></td>
177
+<td class="left"><a href="#sec-4">4</a></td>
191 178
 </tr>
192 179
 
193 180
 <tr>
194
-<td class="org-left"><a href="#orgheadline5">How do I reset the tripwire?</a></td>
181
+<td class="left"><a href="#sec-5">5</a></td>
195 182
 </tr>
196 183
 
197 184
 <tr>
198
-<td class="org-left"><a href="#orgheadline6">Is metadata protected?</a></td>
185
+<td class="left"><a href="#sec-6">6</a></td>
199 186
 </tr>
200 187
 
201 188
 <tr>
202
-<td class="org-left"><a href="#orgheadline7">How do I create email processing rules?</a></td>
189
+<td class="left"><a href="#sec-7">7</a></td>
203 190
 </tr>
204 191
 
205 192
 <tr>
206
-<td class="org-left"><a href="#orgheadline8">Why isn't dynamic DNS working?</a></td>
193
+<td class="left"><a href="#sec-8">8</a></td>
207 194
 </tr>
208 195
 
209 196
 <tr>
210
-<td class="org-left"><a href="#orgheadline9">How do I change my encryption settings?</a></td>
197
+<td class="left"><a href="#sec-9">9</a></td>
211 198
 </tr>
212 199
 
213 200
 <tr>
214
-<td class="org-left"><a href="#orgheadline10">How do I get a domain name?</a></td>
201
+<td class="left"><a href="#sec-10">10</a></td>
215 202
 </tr>
216 203
 
217 204
 <tr>
218
-<td class="org-left"><a href="#orgheadline11">How do I get a "real" SSL certificate?</a></td>
205
+<td class="left"><a href="#sec-11">11</a></td>
219 206
 </tr>
220 207
 
221 208
 <tr>
222
-<td class="org-left"><a href="#orgheadline12">How do I renew a StartSSL certificate?</a></td>
209
+<td class="left"><a href="#sec-12">12</a></td>
223 210
 </tr>
224 211
 
225 212
 <tr>
226
-<td class="org-left"><a href="#orgheadline13">Why use self-signed certificates?</a></td>
213
+<td class="left"><a href="#sec-13">13</a></td>
227 214
 </tr>
228 215
 
229 216
 <tr>
230
-<td class="org-left"><a href="#orgheadline14">Why not use the services of $company instead? They took the Seppuku pledge</a></td>
217
+<td class="left"><a href="#sec-14">14</a></td>
231 218
 </tr>
232 219
 
233 220
 <tr>
234
-<td class="org-left"><a href="#orgheadline15">Why does my email keep getting rejected as spam by Gmail/etc?</a></td>
221
+<td class="left"><a href="#sec-15">15</a></td>
222
+</tr>
223
+
224
+<tr>
225
+<td class="left"><a href="#sec-16">16</a></td>
235 226
 </tr>
236 227
 </tbody>
237 228
 </table>
238 229
 </div>
239 230
 
240
-<div id="outline-container-orgheadline1" class="outline-2">
241
-<h2 id="orgheadline1">Why not supply a disk image download?</h2>
242
-<div class="outline-text-2" id="text-orgheadline1">
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">
243 234
 <p>
244 235
 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.
245 236
 </p>
246 237
 </div>
247 238
 </div>
248
-<div id="outline-container-orgheadline2" class="outline-2">
249
-<h2 id="orgheadline2">I don't have a static IP address. Can I still install this system?</h2>
250
-<div class="outline-text-2" id="text-orgheadline2">
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">
251 242
 <p>
252 243
 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.
253 244
 </p>
@@ -257,9 +248,9 @@ The lack of a static IP address can be worked around by using a dynamic DNS serv
257 248
 </p>
258 249
 </div>
259 250
 </div>
260
-<div id="outline-container-orgheadline3" class="outline-2">
261
-<h2 id="orgheadline3">What is the best hardware to run this system on?</h2>
262
-<div class="outline-text-2" id="text-orgheadline3">
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">
263 254
 <p>
264 255
 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.
265 256
 </p>
@@ -269,17 +260,45 @@ It was originally designed to run on the Beaglebone Black, but that should be re
269 260
 </p>
270 261
 </div>
271 262
 </div>
272
-<div id="outline-container-orgheadline4" class="outline-2">
273
-<h2 id="orgheadline4">Can I add more users to the system?</h2>
274
-<div class="outline-text-2" id="text-orgheadline4">
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">
266
+<p>
267
+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
+</p>
269
+
270
+<div class="org-src-container">
271
+
272
+<pre class="src src-bash">freedombone-adduser [username]
273
+</pre>
274
+</div>
275
+
276
+<p>
277
+Something to consider when having more than a single user on the system is the security situation. The original administrator user will have access to all of the data for other users (including their encryption keys), so if you do add extra users they need to have <b>complete trust</b> in the administrator.
278
+</p>
279
+
280
+<p>
281
+Another point is that Freedombone installations are not intended to support many users (maybe ten at most). Large numbers of users may make the system unstable, and the more users you have on one system the more it becomes a single point of failure and also perhaps a honeypot from the standpoint of adversaries. Think of what happened with Lavabit and the moral dilemma which an administrator can be faced with (comply with threats and betray the trust of your users or don't comply and suffer other consequences). Ideally, you never want to put yourself into a situation where you can be forced to betray others.
282
+</p>
283
+</div>
284
+</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">
275 288
 <p>
276
-Like any other GNU/Linux system you can add more users. It's easy to add users to Owncloud, XMPP or Hubzilla. However, Freedombone is designed primarily to be a single user system (i.e. a personal server) and if there are multiple users then the number of them is expected to be small - perhaps five or less. Freedombone is not intended to be "<i>web scale</i>" in terms of supporting tens or hundreds of users on a single server. Instead, each server can host a small number of users and then the servers federate together as a network of peers.
289
+To remove a user login as root then run the command:
277 290
 </p>
291
+
292
+<div class="org-src-container">
293
+
294
+<pre class="src src-bash">freedombone-rmuser [username]
295
+</pre>
296
+</div>
278 297
 </div>
279 298
 </div>
280
-<div id="outline-container-orgheadline5" class="outline-2">
281
-<h2 id="orgheadline5">How do I reset the tripwire?</h2>
282
-<div class="outline-text-2" id="text-orgheadline5">
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">
283 302
 <p>
284 303
 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:
285 304
 </p>
@@ -297,17 +316,17 @@ You will need to press enter a couple of times. Doing this typically once per we
297 316
 </p>
298 317
 </div>
299 318
 </div>
300
-<div id="outline-container-orgheadline6" class="outline-2">
301
-<h2 id="orgheadline6">Is metadata protected?</h2>
302
-<div class="outline-text-2" id="text-orgheadline6">
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">
303 322
 <p>
304 323
 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.
305 324
 </p>
306 325
 </div>
307 326
 </div>
308
-<div id="outline-container-orgheadline7" class="outline-2">
309
-<h2 id="orgheadline7">How do I create email processing rules?</h2>
310
-<div class="outline-text-2" id="text-orgheadline7">
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">
311 330
 <p>
312 331
 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.
313 332
 </p>
@@ -316,39 +335,39 @@ You can administer email in the traditional manner by editing folders or procmai
316 335
 
317 336
 
318 337
 <colgroup>
319
-<col  class="org-left" />
338
+<col  class="left" />
320 339
 
321
-<col  class="org-left" />
340
+<col  class="left" />
322 341
 </colgroup>
323 342
 <tbody>
324 343
 <tr>
325
-<td class="org-left">freedombone-addlist</td>
326
-<td class="org-left">Adds a mailing list</td>
344
+<td class="left">freedombone-addlist</td>
345
+<td class="left">Adds a mailing list</td>
327 346
 </tr>
328 347
 
329 348
 <tr>
330
-<td class="org-left">freedombone-rmlist</td>
331
-<td class="org-left">Removes a mailing list</td>
349
+<td class="left">freedombone-rmlist</td>
350
+<td class="left">Removes a mailing list</td>
332 351
 </tr>
333 352
 
334 353
 <tr>
335
-<td class="org-left">freedombone-addemail</td>
336
-<td class="org-left">Transfers emails from an address to a given folder</td>
354
+<td class="left">freedombone-addemail</td>
355
+<td class="left">Transfers emails from an address to a given folder</td>
337 356
 </tr>
338 357
 
339 358
 <tr>
340
-<td class="org-left">freedombone-rmemail</td>
341
-<td class="org-left">Removes an email transferal rule</td>
359
+<td class="left">freedombone-rmemail</td>
360
+<td class="left">Removes an email transferal rule</td>
342 361
 </tr>
343 362
 
344 363
 <tr>
345
-<td class="org-left">freedombone-ignore</td>
346
-<td class="org-left">Ignores email from an address or with a subject line containing text</td>
364
+<td class="left">freedombone-ignore</td>
365
+<td class="left">Ignores email from an address or with a subject line containing text</td>
347 366
 </tr>
348 367
 
349 368
 <tr>
350
-<td class="org-left">freedombone-unignore</td>
351
-<td class="org-left">Removes an ignore rule</td>
369
+<td class="left">freedombone-unignore</td>
370
+<td class="left">Removes an ignore rule</td>
352 371
 </tr>
353 372
 </tbody>
354 373
 </table>
@@ -358,9 +377,9 @@ Spamassassin is also available and within Mutt you can use the S (shift+s) key t
358 377
 </p>
359 378
 </div>
360 379
 </div>
361
-<div id="outline-container-orgheadline8" class="outline-2">
362
-<h2 id="orgheadline8">Why isn't dynamic DNS working?</h2>
363
-<div class="outline-text-2" id="text-orgheadline8">
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">
364 383
 <p>
365 384
 If you run the command:
366 385
 </p>
@@ -428,9 +447,9 @@ http://httpbin.org/ip
428 447
 </div>
429 448
 </div>
430 449
 
431
-<div id="outline-container-orgheadline9" class="outline-2">
432
-<h2 id="orgheadline9">How do I change my encryption settings?</h2>
433
-<div class="outline-text-2" id="text-orgheadline9">
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">
434 453
 <p>
435 454
 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:
436 455
 </p>
@@ -448,9 +467,9 @@ You will then be able to edit the crypto settings for all of the installed appli
448 467
 </p>
449 468
 </div>
450 469
 </div>
451
-<div id="outline-container-orgheadline10" class="outline-2">
452
-<h2 id="orgheadline10">How do I get a domain name?</h2>
453
-<div class="outline-text-2" id="text-orgheadline10">
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">
454 473
 <p>
455 474
 Suppose that you have bought a domain name (rather than using a free subdomain on freedns) and you want to use that instead.
456 475
 </p>
@@ -518,11 +537,11 @@ You should now be able to send an email from <i>postmaster@mynewdomainname</i> a
518 537
 </div>
519 538
 </div>
520 539
 
521
-<div id="outline-container-orgheadline11" class="outline-2">
522
-<h2 id="orgheadline11">How do I get a "real" SSL certificate?</h2>
523
-<div class="outline-text-2" id="text-orgheadline11">
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">
524 543
 <p>
525
-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="#orgheadline10">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).
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).
526 545
 </p>
527 546
 
528 547
 <p>
@@ -539,10 +558,10 @@ Now we can generate the certificate request as follows.
539 558
 
540 559
 <div class="org-src-container">
541 560
 
542
-<pre class="src src-bash"><span class="org-builtin">export</span> <span class="org-variable-name">HOSTNAME</span>=mydomainname.com
543
-openssl genrsa -out /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.key 2048
544
-chown root:ssl-cert /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.key
545
-chmod 440 /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.key
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
546 565
 mkdir /etc/ssl/requests
547 566
 </pre>
548 567
 </div>
@@ -553,7 +572,7 @@ Now make a certificate request as follows.  You should copy and paste the whole
553 572
 
554 573
 <div class="org-src-container">
555 574
 
556
-<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
575
+<pre class="src src-bash">openssl req -new -sha256 -key /etc/ssl/private/$HOSTNAME.key -out /etc/ssl/requests/$HOSTNAME.csr
557 576
 </pre>
558 577
 </div>
559 578
 
@@ -571,7 +590,7 @@ View the request with:
571 590
 
572 591
 <div class="org-src-container">
573 592
 
574
-<pre class="src src-bash">cat /etc/ssl/requests/$<span class="org-variable-name">HOSTNAME</span>.csr
593
+<pre class="src src-bash">cat /etc/ssl/requests/$HOSTNAME.csr
575 594
 </pre>
576 595
 </div>
577 596
 
@@ -585,7 +604,7 @@ Log into your StartSSL account and select <b>Retrieve Certificate</b> from the <
585 604
 
586 605
 <div class="org-src-container">
587 606
 
588
-<pre class="src src-bash">editor /etc/ssl/certs/$<span class="org-variable-name">HOSTNAME</span>.crt
607
+<pre class="src src-bash">editor /etc/ssl/certs/$HOSTNAME.crt
589 608
 </pre>
590 609
 </div>
591 610
 
@@ -597,15 +616,15 @@ Paste the public key, then save and exit.  Then on the Freedombone.
597 616
 
598 617
 <pre class="src src-bash">mkdir /etc/ssl/roots
599 618
 mkdir /etc/ssl/chains
600
-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>
601
-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>
602
-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>
603
-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>
604
-ln -s <span class="org-string">"/etc/ssl/roots/startssl-root.ca"</span> <span class="org-string">"/etc/ssl/roots/$HOSTNAME-root.ca"</span>
605
-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>
606
-cp <span class="org-string">"/etc/ssl/certs/$HOSTNAME.crt"</span> <span class="org-string">"/etc/ssl/certs/$HOSTNAME.crt+chain+root"</span>
607
-<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>
608
-<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>
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"
609 628
 </pre>
610 629
 </div>
611 630
 
@@ -618,8 +637,8 @@ To avoid any possibility of the certificates being accidentally overwritten by s
618 637
 <pre class="src src-bash">mkdir /etc/ssl/backups
619 638
 mkdir /etc/ssl/backups/certs
620 639
 mkdir /etc/ssl/backups/private
621
-cp /etc/ssl/certs/$<span class="org-variable-name">HOSTNAME</span>* /etc/ssl/backups/certs/
622
-cp /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>* /etc/ssl/backups/private/
640
+cp /etc/ssl/certs/$HOSTNAME* /etc/ssl/backups/certs/
641
+cp /etc/ssl/private/$HOSTNAME* /etc/ssl/backups/private/
623 642
 chmod -R 400 /etc/ssl/backups/certs/*
624 643
 chmod -R 400 /etc/ssl/backups/private/*
625 644
 </pre>
@@ -631,9 +650,9 @@ Remove the certificate password, so if the server is rebooted then it won't wait
631 650
 
632 651
 <div class="org-src-container">
633 652
 
634
-<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
635
-cp /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.new.key /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.key
636
-shred -zu /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.new.key
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
637 656
 </pre>
638 657
 </div>
639 658
 
@@ -643,7 +662,7 @@ Create a bundled certificate which joins the certificate and chain file together
643 662
 
644 663
 <div class="org-src-container">
645 664
 
646
-<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
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
647 666
 </pre>
648 667
 </div>
649 668
 
@@ -654,7 +673,7 @@ And also add it to the overall bundle of certificates for the Freedombone. This
654 673
 <div class="org-src-container">
655 674
 
656 675
 <pre class="src src-bash">mkdir /etc/ssl/mycerts
657
-cp /etc/ssl/certs/$<span class="org-variable-name">HOSTNAME</span>.bundle.crt /etc/ssl/mycerts
676
+cp /etc/ssl/certs/$HOSTNAME.bundle.crt /etc/ssl/mycerts
658 677
 cat /etc/ssl/mycerts/*.crt &gt; /etc/ssl/freedombone-bundle.crt
659 678
 tar -czvf /etc/ssl/freedombone-certs.tar.gz /etc/ssl/mycerts/*.crt
660 679
 </pre>
@@ -666,7 +685,7 @@ Edit your configuration file.
666 685
 
667 686
 <div class="org-src-container">
668 687
 
669
-<pre class="src src-bash">editor /etc/nginx/sites-available/$<span class="org-variable-name">HOSTNAME</span>
688
+<pre class="src src-bash">editor /etc/nginx/sites-available/$HOSTNAME
670 689
 </pre>
671 690
 </div>
672 691
 
@@ -691,14 +710,14 @@ Save and exit, then restart the web server.
691 710
 </div>
692 711
 
693 712
 <p>
694
-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>.
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>.
695 714
 </p>
696 715
 </div>
697 716
 </div>
698 717
 
699
-<div id="outline-container-orgheadline12" class="outline-2">
700
-<h2 id="orgheadline12">How do I renew a StartSSL certificate?</h2>
701
-<div class="outline-text-2" id="text-orgheadline12">
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">
702 721
 <p>
703 722
 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>".
704 723
 </p>
@@ -712,7 +731,7 @@ Make sure that you have the StartSSL certificate which was created when you init
712 731
 </p>
713 732
 
714 733
 <p>
715
-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.
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.
716 735
 </p>
717 736
 
718 737
 <p>
@@ -768,9 +787,9 @@ The new certificate will then be installed.
768 787
 </p>
769 788
 </div>
770 789
 </div>
771
-<div id="outline-container-orgheadline13" class="outline-2">
772
-<h2 id="orgheadline13">Why use self-signed certificates?</h2>
773
-<div class="outline-text-2" id="text-orgheadline13">
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">
774 793
 <p>
775 794
 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.
776 795
 </p>
@@ -784,17 +803,17 @@ For now a self-signed certificate will probably in most cases protect your commu
784 803
 </p>
785 804
 </div>
786 805
 </div>
787
-<div id="outline-container-orgheadline14" class="outline-2">
788
-<h2 id="orgheadline14">Why not use the services of $company instead? They took the Seppuku pledge</h2>
789
-<div class="outline-text-2" id="text-orgheadline14">
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">
790 809
 <p>
791
-<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.
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.
792 811
 </p>
793 812
 </div>
794 813
 </div>
795
-<div id="outline-container-orgheadline15" class="outline-2">
796
-<h2 id="orgheadline15">Why does my email keep getting rejected as spam by Gmail/etc?</h2>
797
-<div class="outline-text-2" id="text-orgheadline15">
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">
798 817
 <p>
799 818
 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.
800 819
 </p>
@@ -806,40 +825,10 @@ So the situation with email presently is pretty bad, and there's a clear selecti
806 825
 </div>
807 826
 </div>
808 827
 <div id="postamble" class="status">
809
-
810
-<style type="text/css">
811
-.back-to-top {
812
-    position: fixed;
813
-    bottom: 2em;
814
-    right: 0px;
815
-    text-decoration: none;
816
-    color: #000000;
817
-    background-color: rgba(235, 235, 235, 0.80);
818
-    font-size: 12px;
819
-    padding: 1em;
820
-    display: none;
821
-}
822
-
823
-.back-to-top:hover {
824
-    background-color: rgba(135, 135, 135, 0.50);
825
-}
826
-</style>
827
-
828
-<div class="back-to-top">
829
-<a href="#top">Back to top</a> | <a href="mailto:bob@robotics.uk.to">E-mail me</a>
830
-</div>
831
-
832
-<script type="text/javascript">
833
-    var offset = 220;
834
-    var duration = 500;
835
-    jQuery(window).scroll(function() {
836
-        if (jQuery(this).scrollTop() > offset) {
837
-            jQuery('.back-to-top').fadeIn(duration);
838
-        } else {
839
-            jQuery('.back-to-top').fadeOut(duration);
840
-        }
841
-    });
842
-</script>
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>
843 832
 </div>
844 833
 </body>
845 834
 </html>