Browse Source

Documentation for bridges

Bob Mottram 8 years ago
parent
commit
d606b64b4e
3 changed files with 159 additions and 112 deletions
  1. 14
    0
      doc/EN/faq.org
  2. BIN
      img/controlpanel/control_panel_bridges.jpg
  3. 145
    112
      website/EN/faq.html

+ 14
- 0
doc/EN/faq.org View File

@@ -45,6 +45,7 @@
45 45
 | [[Why use self-signed certificates?]]                                             |
46 46
 | [[Why not use the services of $company instead? They took the Seppuku pledge]]    |
47 47
 | [[Why does my email keep getting rejected as spam by Gmail/etc?]]                 |
48
+| [[Tor is censored/blocked in my area. What can I do?]]                            |
48 49
 #+END_CENTER
49 50
 
50 51
 * What applications are supported?
@@ -316,3 +317,16 @@ So the situation with email presently is pretty bad, and there's a clear selecti
316 317
 Return to the <a href="index.html">home page</a>
317 318
 </center>
318 319
 #+END_EXPORT
320
+
321
+* Tor is censored/blocked in my area. What can I do?
322
+If you can find some details for an obfs4 Tor bridge (its IP address, port number and key or nickname) then you can set up the system to use it to connect to the Tor network. Unlike relay nodes the IP addresses for bridges are not public information and so can't be easily known and added to block lists by authoritarian regimes or over-zealous ISPs.
323
+
324
+ssh into your Freedombone system, go to the *administrator control panel*, select *security settings* then *Tor Bridges* and *Add a bridge*. You can then enter the details.
325
+
326
+#+BEGIN_CENTER
327
+[[file:images/controlpanel/control_panel_bridges.jpg]]
328
+#+END_CENTER
329
+
330
+Any bridges that you add will also show up on the About screen of the administrator control panel.
331
+
332
+You can also set your system to act as a Tor bridge, although this is not recommended since in most cases you will have a dynamic external IP address. If you need to help someone get around local censorship temporarily though this could be an option.

BIN
img/controlpanel/control_panel_bridges.jpg View File


+ 145
- 112
website/EN/faq.html View File

@@ -3,7 +3,7 @@
3 3
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4 4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5 5
 <head>
6
-<!-- 2016-12-11 Sun 10:02 -->
6
+<!-- 2016-12-22 Thu 14:34 -->
7 7
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
8 8
 <meta name="viewport" content="width=device-width, initial-scale=1" />
9 9
 <title></title>
@@ -256,31 +256,31 @@ for the JavaScript code in this tag.
256 256
 </colgroup>
257 257
 <tbody>
258 258
 <tr>
259
-<td class="org-left"><a href="#org3ead92c">What applications are supported?</a></td>
259
+<td class="org-left"><a href="#org3a29429">What applications are supported?</a></td>
260 260
 </tr>
261 261
 
262 262
 <tr>
263
-<td class="org-left"><a href="#org739e143">I don't have a static IP address. Can I still install this system?</a></td>
263
+<td class="org-left"><a href="#org67ecd6d">I don't have a static IP address. Can I still install this system?</a></td>
264 264
 </tr>
265 265
 
266 266
 <tr>
267
-<td class="org-left"><a href="#org40b9e69">Why Freedombone and not FreedomBox?</a></td>
267
+<td class="org-left"><a href="#orge30f669">Why Freedombone and not FreedomBox?</a></td>
268 268
 </tr>
269 269
 
270 270
 <tr>
271
-<td class="org-left"><a href="#org317ba3c">Why not support building images for Raspberry Pi?</a></td>
271
+<td class="org-left"><a href="#org4d256b9">Why not support building images for Raspberry Pi?</a></td>
272 272
 </tr>
273 273
 
274 274
 <tr>
275
-<td class="org-left"><a href="#orge29c6dc">Why use Tor? I've heard it's used by bad people</a></td>
275
+<td class="org-left"><a href="#orgde438bf">Why use Tor? I've heard it's used by bad people</a></td>
276 276
 </tr>
277 277
 
278 278
 <tr>
279
-<td class="org-left"><a href="#org1178e30">Why use Github?</a></td>
279
+<td class="org-left"><a href="#org88f2a63">Why use Github?</a></td>
280 280
 </tr>
281 281
 
282 282
 <tr>
283
-<td class="org-left"><a href="#orgae7cb0a">Keys and emails should not be stored on servers. Why do you do that?</a></td>
283
+<td class="org-left"><a href="#org2d3a546">Keys and emails should not be stored on servers. Why do you do that?</a></td>
284 284
 </tr>
285 285
 
286 286
 <tr>
@@ -288,95 +288,99 @@ for the JavaScript code in this tag.
288 288
 </tr>
289 289
 
290 290
 <tr>
291
-<td class="org-left"><a href="#org2855982">Why can't I access my .onion site with a Tor browser?</a></td>
291
+<td class="org-left"><a href="#org4aee8ef">Why can't I access my .onion site with a Tor browser?</a></td>
292 292
 </tr>
293 293
 
294 294
 <tr>
295
-<td class="org-left"><a href="#orgea5dc10">What is the best hardware to run this system on?</a></td>
295
+<td class="org-left"><a href="#org27100bc">What is the best hardware to run this system on?</a></td>
296 296
 </tr>
297 297
 
298 298
 <tr>
299
-<td class="org-left"><a href="#org34252c3">Can I add more users to the system?</a></td>
299
+<td class="org-left"><a href="#org9380234">Can I add more users to the system?</a></td>
300 300
 </tr>
301 301
 
302 302
 <tr>
303
-<td class="org-left"><a href="#orga0c1c16">Why not use Signal for mobile chat?</a></td>
303
+<td class="org-left"><a href="#org570a459">Why not use Signal for mobile chat?</a></td>
304 304
 </tr>
305 305
 
306 306
 <tr>
307
-<td class="org-left"><a href="#orgf477f4f">What is the most secure chat app to use on mobile?</a></td>
307
+<td class="org-left"><a href="#orgc02a0b0">What is the most secure chat app to use on mobile?</a></td>
308 308
 </tr>
309 309
 
310 310
 <tr>
311
-<td class="org-left"><a href="#orgf907d60">How do I remove a user from the system?</a></td>
311
+<td class="org-left"><a href="#org5a6ba30">How do I remove a user from the system?</a></td>
312 312
 </tr>
313 313
 
314 314
 <tr>
315
-<td class="org-left"><a href="#org38e7ff9">Why is logging for web sites turned off by default?</a></td>
315
+<td class="org-left"><a href="#org928c1ce">Why is logging for web sites turned off by default?</a></td>
316 316
 </tr>
317 317
 
318 318
 <tr>
319
-<td class="org-left"><a href="#org5d8bdd8">How do I reset the tripwire?</a></td>
319
+<td class="org-left"><a href="#orge5ad98d">How do I reset the tripwire?</a></td>
320 320
 </tr>
321 321
 
322 322
 <tr>
323
-<td class="org-left"><a href="#org0f16231">Is metadata protected?</a></td>
323
+<td class="org-left"><a href="#org08d71c4">Is metadata protected?</a></td>
324 324
 </tr>
325 325
 
326 326
 <tr>
327
-<td class="org-left"><a href="#org77108f2">How do I create email processing rules?</a></td>
327
+<td class="org-left"><a href="#orgb1aa486">How do I create email processing rules?</a></td>
328 328
 </tr>
329 329
 
330 330
 <tr>
331
-<td class="org-left"><a href="#org7b70405">Why isn't dynamic DNS working?</a></td>
331
+<td class="org-left"><a href="#org9b198a0">Why isn't dynamic DNS working?</a></td>
332 332
 </tr>
333 333
 
334 334
 <tr>
335
-<td class="org-left"><a href="#orge246bc6">How do I change my encryption settings?</a></td>
335
+<td class="org-left"><a href="#orgf8bdd06">How do I change my encryption settings?</a></td>
336 336
 </tr>
337 337
 
338 338
 <tr>
339
-<td class="org-left"><a href="#org5fd44f7">How do I get a domain name?</a></td>
339
+<td class="org-left"><a href="#org9b3fd9d">How do I get a domain name?</a></td>
340 340
 </tr>
341 341
 
342 342
 <tr>
343
-<td class="org-left"><a href="#org5c87e4b">How do I get a "real" SSL/TLS/HTTPS certificate?</a></td>
343
+<td class="org-left"><a href="#orgd2e9b99">How do I get a "real" SSL/TLS/HTTPS certificate?</a></td>
344 344
 </tr>
345 345
 
346 346
 <tr>
347
-<td class="org-left"><a href="#orgdc345fd">How do I renew a Let's Encrypt certificate?</a></td>
347
+<td class="org-left"><a href="#orgcbdc6fe">How do I renew a Let's Encrypt certificate?</a></td>
348 348
 </tr>
349 349
 
350 350
 <tr>
351
-<td class="org-left"><a href="#orgb492b32">I tried to renew a Let's Encrypt certificate and it failed. What should I do?</a></td>
351
+<td class="org-left"><a href="#org77d9daa">I tried to renew a Let's Encrypt certificate and it failed. What should I do?</a></td>
352 352
 </tr>
353 353
 
354 354
 <tr>
355
-<td class="org-left"><a href="#org48853b7">Why use self-signed certificates?</a></td>
355
+<td class="org-left"><a href="#orgb58e7a0">Why use self-signed certificates?</a></td>
356 356
 </tr>
357 357
 
358 358
 <tr>
359
-<td class="org-left"><a href="#org39dbf05">Why not use the services of $company instead? They took the Seppuku pledge</a></td>
359
+<td class="org-left"><a href="#org4e8813a">Why not use the services of $company instead? They took the Seppuku pledge</a></td>
360 360
 </tr>
361 361
 
362 362
 <tr>
363
-<td class="org-left"><a href="#org6ec6280">Why does my email keep getting rejected as spam by Gmail/etc?</a></td>
363
+<td class="org-left"><a href="#org13b758c">Why does my email keep getting rejected as spam by Gmail/etc?</a></td>
364
+</tr>
365
+
366
+<tr>
367
+<td class="org-left"><a href="#org58edcf0">Tor is censored/blocked in my area. What can I do?</a></td>
364 368
 </tr>
365 369
 </tbody>
366 370
 </table>
367 371
 </div>
368 372
 
369
-<div id="outline-container-org3ead92c" class="outline-2">
370
-<h2 id="org3ead92c">What applications are supported?</h2>
371
-<div class="outline-text-2" id="text-org3ead92c">
373
+<div id="outline-container-org3a29429" class="outline-2">
374
+<h2 id="org3a29429">What applications are supported?</h2>
375
+<div class="outline-text-2" id="text-org3a29429">
372 376
 <p>
373 377
 <a href="./apps.html">See here</a> for the complete list of apps. In addition to those as part of the base install you get an email server.
374 378
 </p>
375 379
 </div>
376 380
 </div>
377
-<div id="outline-container-org739e143" class="outline-2">
378
-<h2 id="org739e143">I don't have a static IP address. Can I still install this system?</h2>
379
-<div class="outline-text-2" id="text-org739e143">
381
+<div id="outline-container-org67ecd6d" class="outline-2">
382
+<h2 id="org67ecd6d">I don't have a static IP address. Can I still install this system?</h2>
383
+<div class="outline-text-2" id="text-org67ecd6d">
380 384
 <p>
381 385
 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.
382 386
 </p>
@@ -386,17 +390,17 @@ The lack of a static IP address can be worked around by using a dynamic DNS serv
386 390
 </p>
387 391
 </div>
388 392
 </div>
389
-<div id="outline-container-org40b9e69" class="outline-2">
390
-<h2 id="org40b9e69">Why Freedombone and not FreedomBox?</h2>
391
-<div class="outline-text-2" id="text-org40b9e69">
393
+<div id="outline-container-orge30f669" class="outline-2">
394
+<h2 id="orge30f669">Why Freedombone and not FreedomBox?</h2>
395
+<div class="outline-text-2" id="text-orge30f669">
392 396
 <p>
393 397
 When the project began in late 2013 the FreedomBox project seemed to be going nowhere, and was only designed to work with the DreamPlug hardware. There was some new hardware out - the Beaglebone Black - which could run Debian and was also a free hardware design so seemed more appropriate. Hence the name "Freedombone", being like FreedomBox but on a Beaglebone. There are some similarities and differences between the two projects:
394 398
 </p>
395 399
 </div>
396 400
 
397
-<div id="outline-container-org0c1b6f2" class="outline-3">
398
-<h3 id="org0c1b6f2">Similarities</h3>
399
-<div class="outline-text-3" id="text-org0c1b6f2">
401
+<div id="outline-container-org375ee28" class="outline-3">
402
+<h3 id="org375ee28">Similarities</h3>
403
+<div class="outline-text-3" id="text-org375ee28">
400 404
 <ul class="org-ul">
401 405
 <li>Uses freedom-maker and vmdebootstrap to build debian images</li>
402 406
 <li>Supports the use of Tor onion addresses to access websites</li>
@@ -410,9 +414,9 @@ When the project began in late 2013 the FreedomBox project seemed to be going no
410 414
 </ul>
411 415
 </div>
412 416
 </div>
413
-<div id="outline-container-orge7426aa" class="outline-3">
414
-<h3 id="orge7426aa">Differences</h3>
415
-<div class="outline-text-3" id="text-orge7426aa">
417
+<div id="outline-container-org6d20201" class="outline-3">
418
+<h3 id="org6d20201">Differences</h3>
419
+<div class="outline-text-3" id="text-org6d20201">
416 420
 <ul class="org-ul">
417 421
 <li>FreedomBox is a Debian pure blend. Freedombone is not</li>
418 422
 <li>Freedombone only supports Free Software. FreedomBox includes some closed binary boot blobs for certain ARM boards</li>
@@ -427,9 +431,9 @@ When the project began in late 2013 the FreedomBox project seemed to be going no
427 431
 </div>
428 432
 </div>
429 433
 </div>
430
-<div id="outline-container-org317ba3c" class="outline-2">
431
-<h2 id="org317ba3c">Why not support building images for Raspberry Pi?</h2>
432
-<div class="outline-text-2" id="text-org317ba3c">
434
+<div id="outline-container-org4d256b9" class="outline-2">
435
+<h2 id="org4d256b9">Why not support building images for Raspberry Pi?</h2>
436
+<div class="outline-text-2" id="text-org4d256b9">
433 437
 <p>
434 438
 The FreedomBox project supports Raspberry Pi builds, and the image build system for Freedombone is based on the same system. However, although the Raspberry Pi can run a version of Debian it requires a closed proprietary blob in order to boot the hardware. Who knows what that blob might contain or what exploits it could facilitate. From an adversarial point of view if you were trying to deliver "bulk equipment interference" then it doesn't get any better than piggybacking on something which has control of the boot process, and hence all subsequently run processes.
435 439
 </p>
@@ -439,9 +443,9 @@ So although the Raspberry Pi is cheap and hugely popular it's not supported by t
439 443
 </p>
440 444
 </div>
441 445
 </div>
442
-<div id="outline-container-orge29c6dc" class="outline-2">
443
-<h2 id="orge29c6dc">Why use Tor? I've heard it's used by bad people</h2>
444
-<div class="outline-text-2" id="text-orge29c6dc">
446
+<div id="outline-container-orgde438bf" class="outline-2">
447
+<h2 id="orgde438bf">Why use Tor? I've heard it's used by bad people</h2>
448
+<div class="outline-text-2" id="text-orgde438bf">
445 449
 <p>
446 450
 Before you run screaming for the hills based upon whatever scare story you may have just read in the mainstream media there are a few things worthy of consideration. Tor is installed by default on Freedombone, <i>but not as a relay or exit node</i>. It's only used to provide onion addresses so that this gives you or the viewers of your sites some choice about how they access the information. It also allows you to subscribe to and read RSS feeds privately.
447 451
 </p>
@@ -459,9 +463,9 @@ The media may also have sold you torrid tales about individual Tor project devel
459 463
 </p>
460 464
 </div>
461 465
 </div>
462
-<div id="outline-container-org1178e30" class="outline-2">
463
-<h2 id="org1178e30">Why use Github?</h2>
464
-<div class="outline-text-2" id="text-org1178e30">
466
+<div id="outline-container-org88f2a63" class="outline-2">
467
+<h2 id="org88f2a63">Why use Github?</h2>
468
+<div class="outline-text-2" id="text-org88f2a63">
465 469
 <p>
466 470
 Github is paradoxically a centralized, closed and proprietary system which happens to mostly host free and open source projects. Up until now it has been relatively benign, but at some point in the name of "growth" it will likely start becoming more evil, or just become like SourceForge - which was also once much loved by FOSS developers, but turned into a den of malvertizing.
467 471
 </p>
@@ -479,9 +483,9 @@ Currently many of the repositories used for applications which are not yet packa
479 483
 </p>
480 484
 </div>
481 485
 </div>
482
-<div id="outline-container-orgae7cb0a" class="outline-2">
483
-<h2 id="orgae7cb0a">Keys and emails should not be stored on servers. Why do you do that?</h2>
484
-<div class="outline-text-2" id="text-orgae7cb0a">
486
+<div id="outline-container-org2d3a546" class="outline-2">
487
+<h2 id="org2d3a546">Keys and emails should not be stored on servers. Why do you do that?</h2>
488
+<div class="outline-text-2" id="text-org2d3a546">
485 489
 <p>
486 490
 Ordinarily this is good advice. However, the threat model for a device in your home is different from the one for a generic server in a massive warehouse. Compare and contrast:
487 491
 </p>
@@ -539,9 +543,9 @@ In the home environment a box with a good firewall and no GUI components install
539 543
 </div>
540 544
 </div>
541 545
 
542
-<div id="outline-container-org2855982" class="outline-2">
543
-<h2 id="org2855982">Why can't I access my .onion site with a Tor browser?</h2>
544
-<div class="outline-text-2" id="text-org2855982">
546
+<div id="outline-container-org4aee8ef" class="outline-2">
547
+<h2 id="org4aee8ef">Why can't I access my .onion site with a Tor browser?</h2>
548
+<div class="outline-text-2" id="text-org4aee8ef">
545 549
 <p>
546 550
 Probably you need to add the site to the NoScript whitelist. Typically click/press on the noscript icon (or select from the menu on mobile) then select <i>whitelist</i> and add the site URL. You may also need to disable HTTPS Everywhere when using onion addresses, which don't use https.
547 551
 </p>
@@ -551,9 +555,9 @@ Another factor to be aware of is that it can take a while for the onion address
551 555
 </p>
552 556
 </div>
553 557
 </div>
554
-<div id="outline-container-orgea5dc10" class="outline-2">
555
-<h2 id="orgea5dc10">What is the best hardware to run this system on?</h2>
556
-<div class="outline-text-2" id="text-orgea5dc10">
558
+<div id="outline-container-org27100bc" class="outline-2">
559
+<h2 id="org27100bc">What is the best hardware to run this system on?</h2>
560
+<div class="outline-text-2" id="text-org27100bc">
557 561
 <p>
558 562
 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.
559 563
 </p>
@@ -563,9 +567,9 @@ It was originally designed to run on the Beaglebone Black, but that should be re
563 567
 </p>
564 568
 </div>
565 569
 </div>
566
-<div id="outline-container-org34252c3" class="outline-2">
567
-<h2 id="org34252c3">Can I add more users to the system?</h2>
568
-<div class="outline-text-2" id="text-org34252c3">
570
+<div id="outline-container-org9380234" class="outline-2">
571
+<h2 id="org9380234">Can I add more users to the system?</h2>
572
+<div class="outline-text-2" id="text-org9380234">
569 573
 <p>
570 574
 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, SIP phone and the blog (depending on whether the variant which you installed includes those).
571 575
 </p>
@@ -588,9 +592,9 @@ Another point is that Freedombone installations are not intended to support many
588 592
 </p>
589 593
 </div>
590 594
 </div>
591
-<div id="outline-container-orga0c1c16" class="outline-2">
592
-<h2 id="orga0c1c16">Why not use Signal for mobile chat?</h2>
593
-<div class="outline-text-2" id="text-orga0c1c16">
595
+<div id="outline-container-org570a459" class="outline-2">
596
+<h2 id="org570a459">Why not use Signal for mobile chat?</h2>
597
+<div class="outline-text-2" id="text-org570a459">
594 598
 <p>
595 599
 Celebrities recommend Signal. It's Free Software so it must be good, right?
596 600
 </p>
@@ -613,9 +617,9 @@ To give credit where it's due Signal is good, but it could be a lot better. The
613 617
 </p>
614 618
 </div>
615 619
 </div>
616
-<div id="outline-container-orgf477f4f" class="outline-2">
617
-<h2 id="orgf477f4f">What is the most secure chat app to use on mobile?</h2>
618
-<div class="outline-text-2" id="text-orgf477f4f">
620
+<div id="outline-container-orgc02a0b0" class="outline-2">
621
+<h2 id="orgc02a0b0">What is the most secure chat app to use on mobile?</h2>
622
+<div class="outline-text-2" id="text-orgc02a0b0">
619 623
 <p>
620 624
 On mobile there are various options. The apps which are likely to be most secure are ones which have end-to-end encryption enabled by default and which can also be onion routed via Orbot. End-to-end encryption secures the content of the message and onion routing obscures the metadata, making it hard for a passive adversary to know who is communicating with who.
621 625
 </p>
@@ -625,13 +629,13 @@ The current safest way to chat is to use <a href="https://conversations.im">Conv
625 629
 </p>
626 630
 
627 631
 <p>
628
-There are many <a href="#orga0c1c16">other fashionable chat apps</a> with end-to-end security, but often they are closed source, have a single central server or can't be onion routed. It's also important to remember that closed source chat apps should be assumed to be untrustworthy, since their security cannot be independently verified.
632
+There are many <a href="#org570a459">other fashionable chat apps</a> with end-to-end security, but often they are closed source, have a single central server or can't be onion routed. It's also important to remember that closed source chat apps should be assumed to be untrustworthy, since their security cannot be independently verified.
629 633
 </p>
630 634
 </div>
631 635
 </div>
632
-<div id="outline-container-orgf907d60" class="outline-2">
633
-<h2 id="orgf907d60">How do I remove a user from the system?</h2>
634
-<div class="outline-text-2" id="text-orgf907d60">
636
+<div id="outline-container-org5a6ba30" class="outline-2">
637
+<h2 id="org5a6ba30">How do I remove a user from the system?</h2>
638
+<div class="outline-text-2" id="text-org5a6ba30">
635 639
 <p>
636 640
 To remove a user:
637 641
 </p>
@@ -646,9 +650,9 @@ Select <i>Administrator controls</i> then <i>Manage Users</i> and then <i>Delete
646 650
 </p>
647 651
 </div>
648 652
 </div>
649
-<div id="outline-container-org38e7ff9" class="outline-2">
650
-<h2 id="org38e7ff9">Why is logging for web sites turned off by default?</h2>
651
-<div class="outline-text-2" id="text-org38e7ff9">
653
+<div id="outline-container-org928c1ce" class="outline-2">
654
+<h2 id="org928c1ce">Why is logging for web sites turned off by default?</h2>
655
+<div class="outline-text-2" id="text-org928c1ce">
652 656
 <p>
653 657
 If you're making profits out of the logs by running large server warehouses and then data mining what users click on - as is the business model of well known internet companies - then logging everything makes total sense. However, if you're running a home server then logging really only makes sense if you're trying to diagnose some specific problem with the system, and outside of that context logging everything becomes more of a liability than an asset.
654 658
 </p>
@@ -662,9 +666,9 @@ On the Freedombone system web logs containing IP addresses are turned off by def
662 666
 </p>
663 667
 </div>
664 668
 </div>
665
-<div id="outline-container-org5d8bdd8" class="outline-2">
666
-<h2 id="org5d8bdd8">How do I reset the tripwire?</h2>
667
-<div class="outline-text-2" id="text-org5d8bdd8">
669
+<div id="outline-container-orge5ad98d" class="outline-2">
670
+<h2 id="orge5ad98d">How do I reset the tripwire?</h2>
671
+<div class="outline-text-2" id="text-orge5ad98d">
668 672
 <p>
669 673
 The tripwire will be automatically reset once per week. If you want to reset it earlier then do the following:
670 674
 </p>
@@ -679,9 +683,9 @@ Select <i>Administrator controls</i> then "reset tripwire" using cursors and spa
679 683
 </p>
680 684
 </div>
681 685
 </div>
682
-<div id="outline-container-org0f16231" class="outline-2">
683
-<h2 id="org0f16231">Is metadata protected?</h2>
684
-<div class="outline-text-2" id="text-org0f16231">
686
+<div id="outline-container-org08d71c4" class="outline-2">
687
+<h2 id="org08d71c4">Is metadata protected?</h2>
688
+<div class="outline-text-2" id="text-org08d71c4">
685 689
 <blockquote>
686 690
 <p>
687 691
 "<i>We kill people based on metadata</i>"
@@ -697,9 +701,9 @@ Even when using Freedombone metadata analysis by third parties is still possible
697 701
 </p>
698 702
 </div>
699 703
 </div>
700
-<div id="outline-container-org77108f2" class="outline-2">
701
-<h2 id="org77108f2">How do I create email processing rules?</h2>
702
-<div class="outline-text-2" id="text-org77108f2">
704
+<div id="outline-container-orgb1aa486" class="outline-2">
705
+<h2 id="orgb1aa486">How do I create email processing rules?</h2>
706
+<div class="outline-text-2" id="text-orgb1aa486">
703 707
 <div class="org-src-container">
704 708
 <pre class="src src-bash">ssh username@domainname -p 2222
705 709
 </pre>
@@ -755,9 +759,9 @@ Spamassassin is also available and within Mutt you can use the S (shift+s) key t
755 759
 </p>
756 760
 </div>
757 761
 </div>
758
-<div id="outline-container-org7b70405" class="outline-2">
759
-<h2 id="org7b70405">Why isn't dynamic DNS working?</h2>
760
-<div class="outline-text-2" id="text-org7b70405">
762
+<div id="outline-container-org9b198a0" class="outline-2">
763
+<h2 id="org9b198a0">Why isn't dynamic DNS working?</h2>
764
+<div class="outline-text-2" id="text-org9b198a0">
761 765
 <p>
762 766
 If you run the command:
763 767
 </p>
@@ -780,9 +784,9 @@ https://www.privateinternetaccess.com/pages/whats-my-ip/
780 784
 </div>
781 785
 </div>
782 786
 
783
-<div id="outline-container-orge246bc6" class="outline-2">
784
-<h2 id="orge246bc6">How do I change my encryption settings?</h2>
785
-<div class="outline-text-2" id="text-orge246bc6">
787
+<div id="outline-container-orgf8bdd06" class="outline-2">
788
+<h2 id="orgf8bdd06">How do I change my encryption settings?</h2>
789
+<div class="outline-text-2" id="text-orgf8bdd06">
786 790
 <p>
787 791
 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:
788 792
 </p>
@@ -797,9 +801,9 @@ Select <i>Administrator controls</i> then select <i>Security Settings</i>. You w
797 801
 </p>
798 802
 </div>
799 803
 </div>
800
-<div id="outline-container-org5fd44f7" class="outline-2">
801
-<h2 id="org5fd44f7">How do I get a domain name?</h2>
802
-<div class="outline-text-2" id="text-org5fd44f7">
804
+<div id="outline-container-org9b3fd9d" class="outline-2">
805
+<h2 id="org9b3fd9d">How do I get a domain name?</h2>
806
+<div class="outline-text-2" id="text-org9b3fd9d">
803 807
 <p>
804 808
 Suppose that you have bought a domain name (rather than using a free subdomain on freedns) and you want to use that instead.
805 809
 </p>
@@ -863,9 +867,9 @@ You should now be able to send an email from <i>postmaster@mynewdomainname</i> a
863 867
 </div>
864 868
 </div>
865 869
 
866
-<div id="outline-container-org5c87e4b" class="outline-2">
867
-<h2 id="org5c87e4b">How do I get a "real" SSL/TLS/HTTPS certificate?</h2>
868
-<div class="outline-text-2" id="text-org5c87e4b">
870
+<div id="outline-container-orgd2e9b99" class="outline-2">
871
+<h2 id="orgd2e9b99">How do I get a "real" SSL/TLS/HTTPS certificate?</h2>
872
+<div class="outline-text-2" id="text-orgd2e9b99">
869 873
 <p>
870 874
 If you did the full install or selected the social variant then the system will have tried to obtain a Let's Encrypt certificate automatically during the install process. If this failed for any reason, or if you have created a new site which you need a certificate for then do the following:
871 875
 </p>
@@ -884,9 +888,9 @@ One thing to be aware of is that Let's Encrypt doesn't support many dynamic DNS
884 888
 </p>
885 889
 </div>
886 890
 </div>
887
-<div id="outline-container-orgdc345fd" class="outline-2">
888
-<h2 id="orgdc345fd">How do I renew a Let's Encrypt certificate?</h2>
889
-<div class="outline-text-2" id="text-orgdc345fd">
891
+<div id="outline-container-orgcbdc6fe" class="outline-2">
892
+<h2 id="orgcbdc6fe">How do I renew a Let's Encrypt certificate?</h2>
893
+<div class="outline-text-2" id="text-orgcbdc6fe">
890 894
 <p>
891 895
 Normally certificates will be automatically renewed once per month, so you don't need to be concerned about it. If anything goes wrong with the automatic renewal then you should receive a warning email.
892 896
 </p>
@@ -905,9 +909,9 @@ Select <i>Administrator controls</i> then <b>Security settings</b> then <b>Renew
905 909
 </p>
906 910
 </div>
907 911
 </div>
908
-<div id="outline-container-orgb492b32" class="outline-2">
909
-<h2 id="orgb492b32">I tried to renew a Let's Encrypt certificate and it failed. What should I do?</h2>
910
-<div class="outline-text-2" id="text-orgb492b32">
912
+<div id="outline-container-org77d9daa" class="outline-2">
913
+<h2 id="org77d9daa">I tried to renew a Let's Encrypt certificate and it failed. What should I do?</h2>
914
+<div class="outline-text-2" id="text-org77d9daa">
911 915
 <p>
912 916
 Most likely it's because Let's Encrypt doesn't support your particular domain or subdomain. Currently free subdomains tend not to work. You'll need to buy a domain name, link it to your dynamic DNS account and then do:
913 917
 </p>
@@ -922,9 +926,9 @@ Select <i>Administrator controls</i> then <b>Security settings</b> then <b>Creat
922 926
 </p>
923 927
 </div>
924 928
 </div>
925
-<div id="outline-container-org48853b7" class="outline-2">
926
-<h2 id="org48853b7">Why use self-signed certificates?</h2>
927
-<div class="outline-text-2" id="text-org48853b7">
929
+<div id="outline-container-orgb58e7a0" class="outline-2">
930
+<h2 id="orgb58e7a0">Why use self-signed certificates?</h2>
931
+<div class="outline-text-2" id="text-orgb58e7a0">
928 932
 <p>
929 933
 Almost everywhere on the web you will read that self-signed certificates are worthless. They bring up <i>scary-scary looking</i> 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>. They probably will protect the content of your communications from passive bulk interception - such as the tapping of under-sea cables.
930 934
 </p>
@@ -939,17 +943,17 @@ You might say, <i>"but surely LetsEncrypt is a single point of failure!"</i>, an
939 943
 </div>
940 944
 </div>
941 945
 
942
-<div id="outline-container-org39dbf05" class="outline-2">
943
-<h2 id="org39dbf05">Why not use the services of $company instead? They took the Seppuku pledge</h2>
944
-<div class="outline-text-2" id="text-org39dbf05">
946
+<div id="outline-container-org4e8813a" class="outline-2">
947
+<h2 id="org4e8813a">Why not use the services of $company instead? They took the Seppuku pledge</h2>
948
+<div class="outline-text-2" id="text-org4e8813a">
945 949
 <p>
946 950
 <a href="https://cryptostorm.org/viewtopic.php?f=63&amp;t=2954&amp;sid=7de2d1e699cfde2f574e6a7f6ea5a173">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.
947 951
 </p>
948 952
 </div>
949 953
 </div>
950
-<div id="outline-container-org6ec6280" class="outline-2">
951
-<h2 id="org6ec6280">Why does my email keep getting rejected as spam by Gmail/etc?</h2>
952
-<div class="outline-text-2" id="text-org6ec6280">
954
+<div id="outline-container-org13b758c" class="outline-2">
955
+<h2 id="org13b758c">Why does my email keep getting rejected as spam by Gmail/etc?</h2>
956
+<div class="outline-text-2" id="text-org13b758c">
953 957
 <p>
954 958
 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 you may not be able to do much unless you can find an email proxy server which is trusted by the receiving server.
955 959
 </p>
@@ -984,6 +988,35 @@ Return to the <a href="index.html">home page</a>
984 988
 </center>
985 989
 </div>
986 990
 </div>
991
+
992
+<div id="outline-container-org58edcf0" class="outline-2">
993
+<h2 id="org58edcf0">Tor is censored/blocked in my area. What can I do?</h2>
994
+<div class="outline-text-2" id="text-org58edcf0">
995
+<p>
996
+If you can find some details for an obfs4 Tor bridge (its IP address, port number and key or nickname) then you can set up the system to use it to connect to the Tor network. Unlike relay nodes the IP addresses for bridges are not public information and so can't be easily known and added to block lists by authoritarian regimes or over-zealous ISPs.
997
+</p>
998
+
999
+<p>
1000
+ssh into your Freedombone system, go to the <b>administrator control panel</b>, select <b>security settings</b> then <b>Tor Bridges</b> and <b>Add a bridge</b>. You can then enter the details.
1001
+</p>
1002
+
1003
+<div class="org-center">
1004
+
1005
+<div class="figure">
1006
+<p><img src="images/controlpanel/control_panel_bridges.jpg" alt="control_panel_bridges.jpg" />
1007
+</p>
1008
+</div>
1009
+</div>
1010
+
1011
+<p>
1012
+Any bridges that you add will also show up on the About screen of the administrator control panel.
1013
+</p>
1014
+
1015
+<p>
1016
+You can also set your system to act as a Tor bridge, although this is not recommended since in most cases you will have a dynamic external IP address. If you need to help someone get around local censorship temporarily though this could be an option.
1017
+</p>
1018
+</div>
1019
+</div>
987 1020
 </div>
988 1021
 <div id="postamble" class="status">
989 1022