Browse Source

Separate document for syncthing

Bob Mottram 8 years ago
parent
commit
b214aaab10
7 changed files with 703 additions and 378 deletions
  1. 78
    0
      doc/EN/app_syncthing.org
  2. 1
    0
      doc/EN/apps.org
  3. 1
    49
      doc/EN/usage.org
  4. BIN
      img/syncthing_browser.jpg
  5. 391
    0
      website/EN/app_syncthing.html
  6. 71
    68
      website/EN/apps.html
  7. 161
    261
      website/EN/usage.html

+ 78
- 0
doc/EN/app_syncthing.org View File

1
+#+TITLE:
2
+#+AUTHOR: Bob Mottram
3
+#+EMAIL: bob@freedombone.net
4
+#+KEYWORDS: freedombone, file sync
5
+#+DESCRIPTION: How to use Syncthing
6
+#+OPTIONS: ^:nil toc:nil
7
+#+HTML_HEAD: <link rel="stylesheet" type="text/css" href="freedombone.css" />
8
+
9
+#+BEGIN_CENTER
10
+[[file:images/logo.png]]
11
+#+END_CENTER
12
+
13
+#+BEGIN_EXPORT html
14
+<center>
15
+<h1>Syncthing</h1>
16
+</center>
17
+#+END_EXPORT
18
+
19
+Syncthing provides a similar capability to proprietary systems such as Dropbox, and also is well suited for use with low power single board computers. You can have one or more directories which are synchronized across your various laptops/desktops/devices, and this makes it hard for you to ever lose important files. The manner in which the synchronization is done is pretty secure, such that it would be difficult for passive adversaries (mass surveillance, "/men in the middle/", etc) to know what files you're sharing. Of course, you don't necessarily need to be running a server in order to use Syncthing, but if you do have a server which is always running then there's always at least one place to synchronize your files to or from.
20
+
21
+Freedombone provides Syncthing shared directories for each user on the system, plus a single shared directory for all users. The expected most common scenario here is that of a family in which members may not want to share /all of their files/ with each other, but might want to share some in a common pool (eg. birthday photos). You can also easily share between different servers.
22
+
23
+* On a laptop
24
+Install syncthing on a Debian based distro:
25
+
26
+#+BEGIN_SRC bash
27
+curl -s https://syncthing.net/release-key.txt | sudo apt-key add -
28
+echo "deb http://apt.syncthing.net/ syncthing release" | sudo tee /etc/apt/sources.list.d/syncthing.list
29
+sudo apt-get update
30
+sudo apt-get install syncthing
31
+#+END_SRC
32
+
33
+Or on Arch/Parabola:
34
+
35
+#+begin_src bash
36
+sudo pacman -S syncthing
37
+#+end_src
38
+
39
+Add syncthing to your startup applications, so that it begins running when your system starts. Then either restart your system or run the command "syncthing" from a terminal.
40
+
41
+In another terminal log into Freedombone:
42
+
43
+#+BEGIN_SRC bash
44
+ssh username@domainname -p 2222
45
+#+END_SRC
46
+
47
+Then select *File Synchronization*.
48
+
49
+#+BEGIN_CENTER
50
+[[file:images/controlpanel/control_panel_file_sync.jpg]]
51
+#+END_CENTER
52
+
53
+Select *Show device ID* and copy the long string of letters and numbers shown, using the shift key then select the text followed by right click then select copy.
54
+
55
+Open a non-Tor browser and enter  *http://127.0.0.1:8384* as the URL. You should now see the minimalistic user interface. Under *Remote Devices* select *Add Remote Device*. In the *Device ID* field paste the string you just copied (CTRL+v). The Device name can be anything. Under *Share Folders with Device* check *default* (or whatever folder you created on your local machine), then save.
56
+
57
+#+BEGIN_CENTER
58
+[[file:images/syncthing_browser.jpg]]
59
+#+END_CENTER
60
+
61
+From the top menu select *Actions* and then *Show ID*, then copy the ID string (usually select then CTRL+c). Go back to the terminal control panel menu and select *Add an ID* then paste what you just copied (CTRL+v). Optionally you can also provide a description so that you later can know what that string corresponds to.
62
+
63
+Now wait for a few minutes. Eventually you will see two messages appear within the browser asking if you want to add two new folders from the Freedombone server. Say yes to both, and specify *~/Sync* as the directory with your username and *~/SyncShared* as the shared directory. You can now copy files into your *~/Sync* directory and they will automatically be synced to the server. Those will be files which only you can access. If you copy files into *~/SyncShared* then they will also be available to any other users on the system.
64
+
65
+* On Android
66
+Install Syncthing and Connectbot from F-droid.
67
+
68
+Set up Connectbot to log into Freedombone.
69
+
70
+Select *File Synchronization*.
71
+
72
+Select *Show device ID* and copy the long string of letters by pressing anywhere on the screen, selecting the *menu* then *copy* and then selecting the ID string. This is very tricky on a small screen, so expect to fail multiple times before you succeed in copying the text.
73
+
74
+Open Syncthing and select the devices tab. Press on *+* and then paste the device ID with a long press followed by *Paste*. You may need to remove any stray characters which were copied during the previous haphazard selection process. Add a name, which can be anything.
75
+
76
+Now select the menu (top left or menu button) and then press on *Device ID*. It will be copied to the clipboard. Go back to Connectbot and from the control panel select *File Synchronization* followed by *Add an ID*. You can then paste in the ID with a long press, and optionally add a description for the device. When that's done you can disconnect from Connectbot.
77
+
78
+Now wait for a few minutes or more. Eventually you should receive two notifications (swipe down from the top to see them) which will allow you to confirm the connection to the server. Say yes to both, and specify appropriate directories for your files and the shared files. To reduce battery and data usage via the settings you can also set Syncthing to only sync while it's charging and only while it's connected to wifi.

+ 1
- 0
doc/EN/apps.org View File

77
 * Syncthing
77
 * Syncthing
78
 Possibly the best way to synchronise files across all of your devices. Once it has been set up it "just works" with no user intervention needed.
78
 Possibly the best way to synchronise files across all of your devices. Once it has been set up it "just works" with no user intervention needed.
79
 
79
 
80
+[[./app_syncthing.html][How to use it]]
80
 * Tox
81
 * Tox
81
 Client and bootstrap node for the Tox chat/VoIP system.
82
 Client and bootstrap node for the Tox chat/VoIP system.
82
 
83
 

+ 1
- 49
doc/EN/usage.org View File

21
 | [[Administrating the system via an onion address (Tor)]] |
21
 | [[Administrating the system via an onion address (Tor)]] |
22
 | [[./mobile.html][Mobile advice]]                                        |
22
 | [[./mobile.html][Mobile advice]]                                        |
23
 | [[./usage_email.html][Using Email]]                                          |
23
 | [[./usage_email.html][Using Email]]                                          |
24
-| [[Syncing to the Cloud]]                                 |
24
+| [[./app_syncthing.html][Syncing to the Cloud]]                                 |
25
 | [[Play Music]]                                           |
25
 | [[Play Music]]                                           |
26
 | [[Microblogging (GNU Social)]]                           |
26
 | [[Microblogging (GNU Social)]]                           |
27
 | [[Sharing things]]                                       |
27
 | [[Sharing things]]                                       |
98
 #+END_SRC
98
 #+END_SRC
99
 
99
 
100
 Subsequently even if dynamic DNS isn't working you may still be able to administer your system. Using the onion address also gives you some degree of protection against corporate or government metadata analysis, since it becomes more difficult to passively detect which systems are communicating.
100
 Subsequently even if dynamic DNS isn't working you may still be able to administer your system. Using the onion address also gives you some degree of protection against corporate or government metadata analysis, since it becomes more difficult to passively detect which systems are communicating.
101
-* Syncing to the Cloud
102
-[[https://syncthing.net][Syncthing]] provides a similar capability to proprietary systems such as Dropbox, and also is well suited for use with low power single board computers. You can have one or more directories which are synchronized across your various laptops/desktops/devices, and this makes it hard for you to ever lose important files. The manner in which the synchronization is done is pretty secure, such that it would be difficult for passive adversaries (mass surveillance, "/men in the middle/", etc) to know what files you're sharing. Of course, you don't necessarily need to be running a server in order to use Syncthing, but if you do have a server which is always running then there's always at least one place to synchronize your files to or from.
103
-
104
-Freedombone provides Syncthing shared directories for each user on the system, plus a single shared directory for all users. The expected most common scenario here is that of a family in which members may not want to share /all of their files/ with each other, but might want to share some in a common pool (eg. birthday photos). You can also easily share between different servers.
105
-
106
-** On a laptop
107
-Install syncthing:
108
-
109
-#+BEGIN_SRC bash
110
-curl -s https://syncthing.net/release-key.txt | sudo apt-key add -
111
-echo "deb http://apt.syncthing.net/ syncthing release" | sudo tee /etc/apt/sources.list.d/syncthing.list
112
-sudo apt-get update
113
-sudo apt-get install syncthing
114
-#+END_SRC
115
-
116
-Add syncthing to your startup applications, so that it begins running when your system starts. Then either restart your system or run the command "syncthing" from a terminal.
117
-
118
-In another terminal log into Freedombone:
119
-
120
-#+BEGIN_SRC bash
121
-ssh username@domainname -p 2222
122
-#+END_SRC
123
-
124
-Then select *File Synchronization*.
125
-
126
-[[file:images/controlpanel/control_panel_file_sync.jpg]]
127
-
128
-Select *Show device ID* and copy the long string of letters and numbers shown, using the shift key then select the text followed by right click then select copy.
129
-
130
-Open a non-Tor browser and enter  *http://127.0.0.1:8384* as the URL. You should now see the minimalistic user interface. Under *Remote Devices* select *Add Remote Device*. In the *Device ID* field paste the string you just copied (CTRL+v). The Device name can be anything. Under *Share Folders with Device* check *default* (or whatever folder you created on your local machine), then save.
131
-
132
-From the top menu select *Actions* and then *Show ID*, then copy the ID string (usually select then CTRL+c). Go back to the terminal control panel menu and select *Add an ID* then paste what you just copied (CTRL+v). Optionally you can also provide a description so that you later can know what that string corresponds to.
133
-
134
-Now wait for a few minutes. Eventually you will see two messages appear within the browser asking if you want to add two new folders from the Freedombone server. Say yes to both, and specify *~/Sync* as the directory with your username and *~/SyncShared* as the shared directory. You can now copy files into your *~/Sync* directory and they will automatically be synced to the server. Those will be files which only you can access. If you copy files into *~/SyncShared* then they will also be available to any other users on the system.
135
-** On Android
136
-Install Syncthing and Connectbot from F-droid.
137
-
138
-Set up Connectbot to log into Freedombone.
139
-
140
-Select *File Synchronization*.
141
-
142
-Select *Show device ID* and copy the long string of letters by pressing anywhere on the screen, selecting the *menu* then *copy* and then selecting the ID string. This is very tricky on a small screen, so expect to fail multiple times before you succeed in copying the text.
143
-
144
-Open Syncthing and select the devices tab. Press on *+* and then paste the device ID with a long press followed by *Paste*. You may need to remove any stray characters which were copied during the previous haphazard selection process. Add a name, which can be anything.
145
-
146
-Now select the menu (top left or menu button) and then press on *Device ID*. It will be copied to the clipboard. Go back to Connectbot and from the control panel select *File Synchronization* followed by *Add an ID*. You can then paste in the ID with a long press, and optionally add a description for the device. When that's done you can disconnect from Connectbot.
147
-
148
-Now wait for a few minutes or more. Eventually you should receive two notifications (swipe down from the top to see them) which will allow you to confirm the connection to the server. Say yes to both, and specify appropriate directories for your files and the shared files. To reduce battery and data usage via the settings you can also set Syncthing to only sync while it's charging and only while it's connected to wifi.
149
 * Play Music
101
 * Play Music
150
 ** With the DLNA service
102
 ** With the DLNA service
151
 An easy way to play music on any mobile device in your home is to use the DLNA service. Copy your music into a directory called "/Music/" on a USB thumb drive and then insert it into from socket on the Beaglebone.
103
 An easy way to play music on any mobile device in your home is to use the DLNA service. Copy your music into a directory called "/Music/" on a USB thumb drive and then insert it into from socket on the Beaglebone.

BIN
img/syncthing_browser.jpg View File


+ 391
- 0
website/EN/app_syncthing.html View File

1
+<?xml version="1.0" encoding="utf-8"?>
2
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
3
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5
+<head>
6
+<!-- 2016-11-12 Sat 17:55 -->
7
+<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
8
+<meta name="viewport" content="width=device-width, initial-scale=1" />
9
+<title></title>
10
+<meta name="generator" content="Org mode" />
11
+<meta name="author" content="Bob Mottram" />
12
+<meta name="description" content="How to use Syncthing"
13
+ />
14
+<meta name="keywords" content="freedombone, file sync" />
15
+<style type="text/css">
16
+ <!--/*--><![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; }
23
+  .todo   { font-family: monospace; color: red; }
24
+  .done   { font-family: monospace; color: green; }
25
+  .priority { font-family: monospace; color: orange; }
26
+  .tag    { background-color: #eee; font-family: monospace;
27
+            padding: 2px; font-size: 80%; font-weight: normal; }
28
+  .timestamp { color: #bebebe; }
29
+  .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; }
33
+  .underline { text-decoration: underline; }
34
+  #postamble p, #preamble p { font-size: 90%; margin: .2em; }
35
+  p.verse { margin-left: 3%; }
36
+  pre {
37
+    border: 1px solid #ccc;
38
+    box-shadow: 3px 3px 3px #eee;
39
+    padding: 8pt;
40
+    font-family: monospace;
41
+    overflow: auto;
42
+    margin: 1.2em;
43
+  }
44
+  pre.src {
45
+    position: relative;
46
+    overflow: visible;
47
+    padding-top: 1.2em;
48
+  }
49
+  pre.src:before {
50
+    display: none;
51
+    position: absolute;
52
+    background-color: white;
53
+    top: -10px;
54
+    right: 10px;
55
+    padding: 3px;
56
+    border: 1px solid black;
57
+  }
58
+  pre.src:hover:before { display: inline;}
59
+  /* Languages per Org manual */
60
+  pre.src-asymptote:before { content: 'Asymptote'; }
61
+  pre.src-awk:before { content: 'Awk'; }
62
+  pre.src-C:before { content: 'C'; }
63
+  /* pre.src-C++ doesn't work in CSS */
64
+  pre.src-clojure:before { content: 'Clojure'; }
65
+  pre.src-css:before { content: 'CSS'; }
66
+  pre.src-D:before { content: 'D'; }
67
+  pre.src-ditaa:before { content: 'ditaa'; }
68
+  pre.src-dot:before { content: 'Graphviz'; }
69
+  pre.src-calc:before { content: 'Emacs Calc'; }
70
+  pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
71
+  pre.src-fortran:before { content: 'Fortran'; }
72
+  pre.src-gnuplot:before { content: 'gnuplot'; }
73
+  pre.src-haskell:before { content: 'Haskell'; }
74
+  pre.src-java:before { content: 'Java'; }
75
+  pre.src-js:before { content: 'Javascript'; }
76
+  pre.src-latex:before { content: 'LaTeX'; }
77
+  pre.src-ledger:before { content: 'Ledger'; }
78
+  pre.src-lisp:before { content: 'Lisp'; }
79
+  pre.src-lilypond:before { content: 'Lilypond'; }
80
+  pre.src-lua:before { content: 'Lua'; }
81
+  pre.src-matlab:before { content: 'MATLAB'; }
82
+  pre.src-mscgen:before { content: 'Mscgen'; }
83
+  pre.src-ocaml:before { content: 'Objective Caml'; }
84
+  pre.src-octave:before { content: 'Octave'; }
85
+  pre.src-org:before { content: 'Org mode'; }
86
+  pre.src-oz:before { content: 'OZ'; }
87
+  pre.src-plantuml:before { content: 'Plantuml'; }
88
+  pre.src-processing:before { content: 'Processing.js'; }
89
+  pre.src-python:before { content: 'Python'; }
90
+  pre.src-R:before { content: 'R'; }
91
+  pre.src-ruby:before { content: 'Ruby'; }
92
+  pre.src-sass:before { content: 'Sass'; }
93
+  pre.src-scheme:before { content: 'Scheme'; }
94
+  pre.src-screen:before { content: 'Gnu Screen'; }
95
+  pre.src-sed:before { content: 'Sed'; }
96
+  pre.src-sh:before { content: 'shell'; }
97
+  pre.src-sql:before { content: 'SQL'; }
98
+  pre.src-sqlite:before { content: 'SQLite'; }
99
+  /* additional languages in org.el's org-babel-load-languages alist */
100
+  pre.src-forth:before { content: 'Forth'; }
101
+  pre.src-io:before { content: 'IO'; }
102
+  pre.src-J:before { content: 'J'; }
103
+  pre.src-makefile:before { content: 'Makefile'; }
104
+  pre.src-maxima:before { content: 'Maxima'; }
105
+  pre.src-perl:before { content: 'Perl'; }
106
+  pre.src-picolisp:before { content: 'Pico Lisp'; }
107
+  pre.src-scala:before { content: 'Scala'; }
108
+  pre.src-shell:before { content: 'Shell Script'; }
109
+  pre.src-ebnf2ps:before { content: 'ebfn2ps'; }
110
+  /* additional language identifiers per "defun org-babel-execute"
111
+       in ob-*.el */
112
+  pre.src-cpp:before  { content: 'C++'; }
113
+  pre.src-abc:before  { content: 'ABC'; }
114
+  pre.src-coq:before  { content: 'Coq'; }
115
+  pre.src-groovy:before  { content: 'Groovy'; }
116
+  /* additional language identifiers from org-babel-shell-names in
117
+     ob-shell.el: ob-shell is the only babel language using a lambda to put
118
+     the execution function name together. */
119
+  pre.src-bash:before  { content: 'bash'; }
120
+  pre.src-csh:before  { content: 'csh'; }
121
+  pre.src-ash:before  { content: 'ash'; }
122
+  pre.src-dash:before  { content: 'dash'; }
123
+  pre.src-ksh:before  { content: 'ksh'; }
124
+  pre.src-mksh:before  { content: 'mksh'; }
125
+  pre.src-posh:before  { content: 'posh'; }
126
+  /* Additional Emacs modes also supported by the LaTeX listings package */
127
+  pre.src-ada:before { content: 'Ada'; }
128
+  pre.src-asm:before { content: 'Assembler'; }
129
+  pre.src-caml:before { content: 'Caml'; }
130
+  pre.src-delphi:before { content: 'Delphi'; }
131
+  pre.src-html:before { content: 'HTML'; }
132
+  pre.src-idl:before { content: 'IDL'; }
133
+  pre.src-mercury:before { content: 'Mercury'; }
134
+  pre.src-metapost:before { content: 'MetaPost'; }
135
+  pre.src-modula-2:before { content: 'Modula-2'; }
136
+  pre.src-pascal:before { content: 'Pascal'; }
137
+  pre.src-ps:before { content: 'PostScript'; }
138
+  pre.src-prolog:before { content: 'Prolog'; }
139
+  pre.src-simula:before { content: 'Simula'; }
140
+  pre.src-tcl:before { content: 'tcl'; }
141
+  pre.src-tex:before { content: 'TeX'; }
142
+  pre.src-plain-tex:before { content: 'Plain TeX'; }
143
+  pre.src-verilog:before { content: 'Verilog'; }
144
+  pre.src-vhdl:before { content: 'VHDL'; }
145
+  pre.src-xml:before { content: 'XML'; }
146
+  pre.src-nxml:before { content: 'XML'; }
147
+  /* add a generic configuration mode; LaTeX export needs an additional
148
+     (add-to-list 'org-latex-listings-langs '(conf " ")) in .emacs */
149
+  pre.src-conf:before { content: 'Configuration File'; }
150
+
151
+  table { border-collapse:collapse; }
152
+  caption.t-above { caption-side: top; }
153
+  caption.t-bottom { caption-side: bottom; }
154
+  td, th { vertical-align:top;  }
155
+  th.org-right  { text-align: center;  }
156
+  th.org-left   { text-align: center;   }
157
+  th.org-center { text-align: center; }
158
+  td.org-right  { text-align: right;  }
159
+  td.org-left   { text-align: left;   }
160
+  td.org-center { text-align: center; }
161
+  dt { font-weight: bold; }
162
+  .footpara { display: inline; }
163
+  .footdef  { margin-bottom: 1em; }
164
+  .figure { padding: 1em; }
165
+  .figure p { text-align: center; }
166
+  .inlinetask {
167
+    padding: 10px;
168
+    border: 2px solid gray;
169
+    margin: 10px;
170
+    background: #ffffcc;
171
+  }
172
+  #org-div-home-and-up
173
+   { text-align: right; font-size: 70%; white-space: nowrap; }
174
+  textarea { overflow-x: auto; }
175
+  .linenr { font-size: smaller }
176
+  .code-highlighted { background-color: #ffff00; }
177
+  .org-info-js_info-navigation { border-style: none; }
178
+  #org-info-js_console-label
179
+    { font-size: 10px; font-weight: bold; white-space: nowrap; }
180
+  .org-info-js_search-highlight
181
+    { background-color: #ffff00; color: #000000; font-weight: bold; }
182
+  .org-svg { width: 90%; }
183
+  /*]]>*/-->
184
+</style>
185
+<link rel="stylesheet" type="text/css" href="freedombone.css" />
186
+<script type="text/javascript">
187
+/*
188
+@licstart  The following is the entire license notice for the
189
+JavaScript code in this tag.
190
+
191
+Copyright (C) 2012-2013 Free Software Foundation, Inc.
192
+
193
+The JavaScript code in this tag is free software: you can
194
+redistribute it and/or modify it under the terms of the GNU
195
+General Public License (GNU GPL) as published by the Free Software
196
+Foundation, either version 3 of the License, or (at your option)
197
+any later version.  The code is distributed WITHOUT ANY WARRANTY;
198
+without even the implied warranty of MERCHANTABILITY or FITNESS
199
+FOR A PARTICULAR PURPOSE.  See the GNU GPL for more details.
200
+
201
+As additional permission under GNU GPL version 3 section 7, you
202
+may distribute non-source (e.g., minimized or compacted) forms of
203
+that code without the copy of the GNU GPL normally required by
204
+section 4, provided you include this license notice and a URL
205
+through which recipients can access the Corresponding Source.
206
+
207
+
208
+@licend  The above is the entire license notice
209
+for the JavaScript code in this tag.
210
+*/
211
+<!--/*--><![CDATA[/*><!--*/
212
+ function CodeHighlightOn(elem, id)
213
+ {
214
+   var target = document.getElementById(id);
215
+   if(null != target) {
216
+     elem.cacheClassElem = elem.className;
217
+     elem.cacheClassTarget = target.className;
218
+     target.className = "code-highlighted";
219
+     elem.className   = "code-highlighted";
220
+   }
221
+ }
222
+ function CodeHighlightOff(elem, id)
223
+ {
224
+   var target = document.getElementById(id);
225
+   if(elem.cacheClassElem)
226
+     elem.className = elem.cacheClassElem;
227
+   if(elem.cacheClassTarget)
228
+     target.className = elem.cacheClassTarget;
229
+ }
230
+/*]]>*///-->
231
+</script>
232
+</head>
233
+<body>
234
+<div id="preamble" class="status">
235
+<a name="top" id="top"></a>
236
+</div>
237
+<div id="content">
238
+<div class="org-center">
239
+
240
+<div class="figure">
241
+<p><img src="images/logo.png" alt="logo.png" />
242
+</p>
243
+</div>
244
+</div>
245
+
246
+<center>
247
+<h1>Syncthing</h1>
248
+</center>
249
+
250
+<p>
251
+Syncthing provides a similar capability to proprietary systems such as Dropbox, and also is well suited for use with low power single board computers. You can have one or more directories which are synchronized across your various laptops/desktops/devices, and this makes it hard for you to ever lose important files. The manner in which the synchronization is done is pretty secure, such that it would be difficult for passive adversaries (mass surveillance, "<i>men in the middle</i>", etc) to know what files you're sharing. Of course, you don't necessarily need to be running a server in order to use Syncthing, but if you do have a server which is always running then there's always at least one place to synchronize your files to or from.
252
+</p>
253
+
254
+<p>
255
+Freedombone provides Syncthing shared directories for each user on the system, plus a single shared directory for all users. The expected most common scenario here is that of a family in which members may not want to share <i>all of their files</i> with each other, but might want to share some in a common pool (eg. birthday photos). You can also easily share between different servers.
256
+</p>
257
+
258
+<div id="outline-container-org7c7b02f" class="outline-2">
259
+<h2 id="org7c7b02f">On a laptop</h2>
260
+<div class="outline-text-2" id="text-org7c7b02f">
261
+<p>
262
+Install syncthing on a Debian based distro:
263
+</p>
264
+
265
+<div class="org-src-container">
266
+<pre class="src src-bash">curl -s https://syncthing.net/release-key.txt | sudo apt-key add -
267
+<span class="org-builtin">echo</span> <span class="org-string">"deb http://apt.syncthing.net/ syncthing release"</span> | sudo tee /etc/apt/sources.list.d/syncthing.list
268
+sudo apt-get update
269
+sudo apt-get install syncthing
270
+</pre>
271
+</div>
272
+
273
+<p>
274
+Or on Arch/Parabola:
275
+</p>
276
+
277
+<div class="org-src-container">
278
+<pre class="src src-bash">sudo pacman -S syncthing
279
+</pre>
280
+</div>
281
+
282
+<p>
283
+Add syncthing to your startup applications, so that it begins running when your system starts. Then either restart your system or run the command "syncthing" from a terminal.
284
+</p>
285
+
286
+<p>
287
+In another terminal log into Freedombone:
288
+</p>
289
+
290
+<div class="org-src-container">
291
+<pre class="src src-bash">ssh username@domainname -p 2222
292
+</pre>
293
+</div>
294
+
295
+<p>
296
+Then select <b>File Synchronization</b>.
297
+</p>
298
+
299
+<div class="org-center">
300
+
301
+<div class="figure">
302
+<p><img src="images/controlpanel/control_panel_file_sync.jpg" alt="control_panel_file_sync.jpg" />
303
+</p>
304
+</div>
305
+</div>
306
+
307
+<p>
308
+Select <b>Show device ID</b> and copy the long string of letters and numbers shown, using the shift key then select the text followed by right click then select copy.
309
+</p>
310
+
311
+<p>
312
+Open a non-Tor browser and enter  <b><a href="http://127.0.0.1:8384">http://127.0.0.1:8384</a></b> as the URL. You should now see the minimalistic user interface. Under <b>Remote Devices</b> select <b>Add Remote Device</b>. In the <b>Device ID</b> field paste the string you just copied (CTRL+v). The Device name can be anything. Under <b>Share Folders with Device</b> check <b>default</b> (or whatever folder you created on your local machine), then save.
313
+</p>
314
+
315
+<div class="org-center">
316
+
317
+<div class="figure">
318
+<p><img src="images/syncthing_browser.jpg" alt="syncthing_browser.jpg" />
319
+</p>
320
+</div>
321
+</div>
322
+
323
+<p>
324
+From the top menu select <b>Actions</b> and then <b>Show ID</b>, then copy the ID string (usually select then CTRL+c). Go back to the terminal control panel menu and select <b>Add an ID</b> then paste what you just copied (CTRL+v). Optionally you can also provide a description so that you later can know what that string corresponds to.
325
+</p>
326
+
327
+<p>
328
+Now wait for a few minutes. Eventually you will see two messages appear within the browser asking if you want to add two new folders from the Freedombone server. Say yes to both, and specify <b>~/Sync</b> as the directory with your username and <b>~/SyncShared</b> as the shared directory. You can now copy files into your <b>~/Sync</b> directory and they will automatically be synced to the server. Those will be files which only you can access. If you copy files into <b>~/SyncShared</b> then they will also be available to any other users on the system.
329
+</p>
330
+</div>
331
+</div>
332
+
333
+<div id="outline-container-org10a2929" class="outline-2">
334
+<h2 id="org10a2929">On Android</h2>
335
+<div class="outline-text-2" id="text-org10a2929">
336
+<p>
337
+Install Syncthing and Connectbot from F-droid.
338
+</p>
339
+
340
+<p>
341
+Set up Connectbot to log into Freedombone.
342
+</p>
343
+
344
+<p>
345
+Select <b>File Synchronization</b>.
346
+</p>
347
+
348
+<p>
349
+Select <b>Show device ID</b> and copy the long string of letters by pressing anywhere on the screen, selecting the <b>menu</b> then <b>copy</b> and then selecting the ID string. This is very tricky on a small screen, so expect to fail multiple times before you succeed in copying the text.
350
+</p>
351
+
352
+<p>
353
+Open Syncthing and select the devices tab. Press on <b>+</b> and then paste the device ID with a long press followed by <b>Paste</b>. You may need to remove any stray characters which were copied during the previous haphazard selection process. Add a name, which can be anything.
354
+</p>
355
+
356
+<p>
357
+Now select the menu (top left or menu button) and then press on <b>Device ID</b>. It will be copied to the clipboard. Go back to Connectbot and from the control panel select <b>File Synchronization</b> followed by <b>Add an ID</b>. You can then paste in the ID with a long press, and optionally add a description for the device. When that's done you can disconnect from Connectbot.
358
+</p>
359
+
360
+<p>
361
+Now wait for a few minutes or more. Eventually you should receive two notifications (swipe down from the top to see them) which will allow you to confirm the connection to the server. Say yes to both, and specify appropriate directories for your files and the shared files. To reduce battery and data usage via the settings you can also set Syncthing to only sync while it's charging and only while it's connected to wifi.
362
+</p>
363
+</div>
364
+</div>
365
+</div>
366
+<div id="postamble" class="status">
367
+
368
+<style type="text/css">
369
+.back-to-top {
370
+    position: fixed;
371
+    bottom: 2em;
372
+    right: 0px;
373
+    text-decoration: none;
374
+    color: #000000;
375
+    background-color: rgba(235, 235, 235, 0.80);
376
+    font-size: 12px;
377
+    padding: 1em;
378
+    display: none;
379
+}
380
+
381
+.back-to-top:hover {
382
+    background-color: rgba(135, 135, 135, 0.50);
383
+}
384
+</style>
385
+
386
+<div class="back-to-top">
387
+<a href="#top">Back to top</a> | <a href="mailto:bob@freedombone.net">E-mail me</a>
388
+</div>
389
+</div>
390
+</body>
391
+</html>

+ 71
- 68
website/EN/apps.html View File

3
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5
 <head>
5
 <head>
6
-<!-- 2016-11-12 Sat 14:11 -->
6
+<!-- 2016-11-12 Sat 17:58 -->
7
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
7
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
8
 <meta name="viewport" content="width=device-width, initial-scale=1" />
8
 <meta name="viewport" content="width=device-width, initial-scale=1" />
9
 <title></title>
9
 <title></title>
257
 </div>
257
 </div>
258
 </div>
258
 </div>
259
 
259
 
260
-<div id="outline-container-org5001e42" class="outline-2">
261
-<h2 id="org5001e42">DLNA</h2>
262
-<div class="outline-text-2" id="text-org5001e42">
260
+<div id="outline-container-org63ad202" class="outline-2">
261
+<h2 id="org63ad202">DLNA</h2>
262
+<div class="outline-text-2" id="text-org63ad202">
263
 <p>
263
 <p>
264
 Enables you to use the system as a music server which any DLNA compatible devices can connect to within your home network.
264
 Enables you to use the system as a music server which any DLNA compatible devices can connect to within your home network.
265
 </p>
265
 </p>
266
 </div>
266
 </div>
267
 </div>
267
 </div>
268
 
268
 
269
-<div id="outline-container-org9512a00" class="outline-2">
270
-<h2 id="org9512a00">Dokuwiki</h2>
271
-<div class="outline-text-2" id="text-org9512a00">
269
+<div id="outline-container-orgfe64f77" class="outline-2">
270
+<h2 id="orgfe64f77">Dokuwiki</h2>
271
+<div class="outline-text-2" id="text-orgfe64f77">
272
 <p>
272
 <p>
273
 A databaseless wiki system.
273
 A databaseless wiki system.
274
 </p>
274
 </p>
275
 </div>
275
 </div>
276
 </div>
276
 </div>
277
 
277
 
278
-<div id="outline-container-org56df031" class="outline-2">
279
-<h2 id="org56df031">Emacs</h2>
280
-<div class="outline-text-2" id="text-org56df031">
278
+<div id="outline-container-org261e788" class="outline-2">
279
+<h2 id="org261e788">Emacs</h2>
280
+<div class="outline-text-2" id="text-org261e788">
281
 <p>
281
 <p>
282
 If you use the Mutt client to read your email then this will set it up to use emacs for composing new mail.
282
 If you use the Mutt client to read your email then this will set it up to use emacs for composing new mail.
283
 </p>
283
 </p>
284
 </div>
284
 </div>
285
 </div>
285
 </div>
286
 
286
 
287
-<div id="outline-container-org528b01f" class="outline-2">
288
-<h2 id="org528b01f">Etherpad</h2>
289
-<div class="outline-text-2" id="text-org528b01f">
287
+<div id="outline-container-org8ddfb19" class="outline-2">
288
+<h2 id="org8ddfb19">Etherpad</h2>
289
+<div class="outline-text-2" id="text-org8ddfb19">
290
 <p>
290
 <p>
291
 Collaborate on creating documents in real time. Maybe you're planning a holiday with other family members or creating documentation for a Free Software project along with other volunteers. Etherpad is hard to beat for simplicity and speed. Only users of the system will be able to access it.
291
 Collaborate on creating documents in real time. Maybe you're planning a holiday with other family members or creating documentation for a Free Software project along with other volunteers. Etherpad is hard to beat for simplicity and speed. Only users of the system will be able to access it.
292
 </p>
292
 </p>
293
 </div>
293
 </div>
294
 </div>
294
 </div>
295
 
295
 
296
-<div id="outline-container-org78ef71f" class="outline-2">
297
-<h2 id="org78ef71f">Ghost</h2>
298
-<div class="outline-text-2" id="text-org78ef71f">
296
+<div id="outline-container-orgacd7dc6" class="outline-2">
297
+<h2 id="orgacd7dc6">Ghost</h2>
298
+<div class="outline-text-2" id="text-orgacd7dc6">
299
 <p>
299
 <p>
300
 Modern looking blogging system.
300
 Modern looking blogging system.
301
 </p>
301
 </p>
302
 </div>
302
 </div>
303
 </div>
303
 </div>
304
 
304
 
305
-<div id="outline-container-org7fd7a68" class="outline-2">
306
-<h2 id="org7fd7a68">GNU Social</h2>
307
-<div class="outline-text-2" id="text-org7fd7a68">
305
+<div id="outline-container-org8d1cb63" class="outline-2">
306
+<h2 id="org8d1cb63">GNU Social</h2>
307
+<div class="outline-text-2" id="text-org8d1cb63">
308
 <p>
308
 <p>
309
 Federated social network. You can "<i>remote follow</i>" other users within the GNU Social federation.
309
 Federated social network. You can "<i>remote follow</i>" other users within the GNU Social federation.
310
 </p>
310
 </p>
311
 </div>
311
 </div>
312
 </div>
312
 </div>
313
 
313
 
314
-<div id="outline-container-org3773546" class="outline-2">
315
-<h2 id="org3773546">Gogs</h2>
316
-<div class="outline-text-2" id="text-org3773546">
314
+<div id="outline-container-orgb520ae3" class="outline-2">
315
+<h2 id="orgb520ae3">Gogs</h2>
316
+<div class="outline-text-2" id="text-orgb520ae3">
317
 <p>
317
 <p>
318
 Lightweight git project hosting system. You can mirror projects from Github, or if Github turns evil then just host your own projects while retaining the familiar <i>fork-and-pull</i> workflow. If you can use Github then you can also use Gogs.
318
 Lightweight git project hosting system. You can mirror projects from Github, or if Github turns evil then just host your own projects while retaining the familiar <i>fork-and-pull</i> workflow. If you can use Github then you can also use Gogs.
319
 </p>
319
 </p>
320
 </div>
320
 </div>
321
 </div>
321
 </div>
322
 
322
 
323
-<div id="outline-container-orgca0c976" class="outline-2">
324
-<h2 id="orgca0c976">HTMLy</h2>
325
-<div class="outline-text-2" id="text-orgca0c976">
323
+<div id="outline-container-orgcf2d864" class="outline-2">
324
+<h2 id="orgcf2d864">HTMLy</h2>
325
+<div class="outline-text-2" id="text-orgcf2d864">
326
 <p>
326
 <p>
327
 Databaseless blogging system. Quite simple and with a markdown-like format.
327
 Databaseless blogging system. Quite simple and with a markdown-like format.
328
 </p>
328
 </p>
329
 </div>
329
 </div>
330
 </div>
330
 </div>
331
 
331
 
332
-<div id="outline-container-org579a4ea" class="outline-2">
333
-<h2 id="org579a4ea">Hubzilla</h2>
334
-<div class="outline-text-2" id="text-org579a4ea">
332
+<div id="outline-container-org8301047" class="outline-2">
333
+<h2 id="org8301047">Hubzilla</h2>
334
+<div class="outline-text-2" id="text-org8301047">
335
 <p>
335
 <p>
336
 Web publishing platform with social network like features and good privacy controls so that it's possible to specify who can see which content. Includes photo albums, calendar, wiki and file storage.
336
 Web publishing platform with social network like features and good privacy controls so that it's possible to specify who can see which content. Includes photo albums, calendar, wiki and file storage.
337
 </p>
337
 </p>
338
 </div>
338
 </div>
339
 </div>
339
 </div>
340
 
340
 
341
-<div id="outline-container-orgd2c09e5" class="outline-2">
342
-<h2 id="orgd2c09e5">IRC Server (ngirc)</h2>
343
-<div class="outline-text-2" id="text-orgd2c09e5">
341
+<div id="outline-container-org602d5a8" class="outline-2">
342
+<h2 id="org602d5a8">IRC Server (ngirc)</h2>
343
+<div class="outline-text-2" id="text-org602d5a8">
344
 <p>
344
 <p>
345
 Run your own IRC chat channel which can be secured with a password and accessible via an onion address. A bouncer is included so that you can receive messages sent while you were offline. Works with Hexchat and other popular clients.
345
 Run your own IRC chat channel which can be secured with a password and accessible via an onion address. A bouncer is included so that you can receive messages sent while you were offline. Works with Hexchat and other popular clients.
346
 </p>
346
 </p>
347
 </div>
347
 </div>
348
 </div>
348
 </div>
349
 
349
 
350
-<div id="outline-container-orgd937d46" class="outline-2">
351
-<h2 id="orgd937d46">Jitsi Meet</h2>
352
-<div class="outline-text-2" id="text-orgd937d46">
350
+<div id="outline-container-orgf40102e" class="outline-2">
351
+<h2 id="orgf40102e">Jitsi Meet</h2>
352
+<div class="outline-text-2" id="text-orgf40102e">
353
 <p>
353
 <p>
354
 Experimental WebRTC video conferencing system, similar to Google Hangouts. This may not be fully functional, but is hoped to be in the near future.
354
 Experimental WebRTC video conferencing system, similar to Google Hangouts. This may not be fully functional, but is hoped to be in the near future.
355
 </p>
355
 </p>
356
 </div>
356
 </div>
357
 </div>
357
 </div>
358
 
358
 
359
-<div id="outline-container-orgb42ef84" class="outline-2">
360
-<h2 id="orgb42ef84">Lychee</h2>
361
-<div class="outline-text-2" id="text-orgb42ef84">
359
+<div id="outline-container-org04c6a4a" class="outline-2">
360
+<h2 id="org04c6a4a">Lychee</h2>
361
+<div class="outline-text-2" id="text-org04c6a4a">
362
 <p>
362
 <p>
363
 Make your photo albums available on the web.
363
 Make your photo albums available on the web.
364
 </p>
364
 </p>
365
 </div>
365
 </div>
366
 </div>
366
 </div>
367
 
367
 
368
-<div id="outline-container-org737178c" class="outline-2">
369
-<h2 id="org737178c">Mailpile</h2>
370
-<div class="outline-text-2" id="text-org737178c">
368
+<div id="outline-container-org38f7832" class="outline-2">
369
+<h2 id="org38f7832">Mailpile</h2>
370
+<div class="outline-text-2" id="text-org38f7832">
371
 <p>
371
 <p>
372
 Modern email client which supports GPG encryption.
372
 Modern email client which supports GPG encryption.
373
 </p>
373
 </p>
374
 </div>
374
 </div>
375
 </div>
375
 </div>
376
 
376
 
377
-<div id="outline-container-org3ff5ec9" class="outline-2">
378
-<h2 id="org3ff5ec9">Mumble</h2>
379
-<div class="outline-text-2" id="text-org3ff5ec9">
377
+<div id="outline-container-orgb083746" class="outline-2">
378
+<h2 id="orgb083746">Mumble</h2>
379
+<div class="outline-text-2" id="text-orgb083746">
380
 <p>
380
 <p>
381
 The popular VoIP and text chat system. Say goodbye to old-fashioned telephony conferences with silly dial codes. Also works well on mobile.
381
 The popular VoIP and text chat system. Say goodbye to old-fashioned telephony conferences with silly dial codes. Also works well on mobile.
382
 </p>
382
 </p>
383
 </div>
383
 </div>
384
 </div>
384
 </div>
385
 
385
 
386
-<div id="outline-container-org3a963c5" class="outline-2">
387
-<h2 id="org3a963c5">PI-Hole</h2>
388
-<div class="outline-text-2" id="text-org3a963c5">
386
+<div id="outline-container-org8894411" class="outline-2">
387
+<h2 id="org8894411">PI-Hole</h2>
388
+<div class="outline-text-2" id="text-org8894411">
389
 <p>
389
 <p>
390
 The black hole for web adverts. Block adverts at the domain name level within your local network. It can significantly reduce bandwidth, speed up page load times and protect your systems from being tracked by spyware.
390
 The black hole for web adverts. Block adverts at the domain name level within your local network. It can significantly reduce bandwidth, speed up page load times and protect your systems from being tracked by spyware.
391
 </p>
391
 </p>
392
 </div>
392
 </div>
393
 </div>
393
 </div>
394
 
394
 
395
-<div id="outline-container-org028db52" class="outline-2">
396
-<h2 id="org028db52">PostActiv</h2>
397
-<div class="outline-text-2" id="text-org028db52">
395
+<div id="outline-container-orgf2c362c" class="outline-2">
396
+<h2 id="orgf2c362c">PostActiv</h2>
397
+<div class="outline-text-2" id="text-orgf2c362c">
398
 <p>
398
 <p>
399
 An alternative federated social networking system compatible with GNU Social. It includes some optimisations and fixes currently not available within the main GNU Social project.
399
 An alternative federated social networking system compatible with GNU Social. It includes some optimisations and fixes currently not available within the main GNU Social project.
400
 </p>
400
 </p>
401
 </div>
401
 </div>
402
 </div>
402
 </div>
403
 
403
 
404
-<div id="outline-container-orgfa34cf8" class="outline-2">
405
-<h2 id="orgfa34cf8">Radicale</h2>
406
-<div class="outline-text-2" id="text-orgfa34cf8">
404
+<div id="outline-container-org40c94f8" class="outline-2">
405
+<h2 id="org40c94f8">Radicale</h2>
406
+<div class="outline-text-2" id="text-org40c94f8">
407
 <p>
407
 <p>
408
 Calendar system compatible with CalDAV and CardDAV. Manage your calendar events easily across all your devices.
408
 Calendar system compatible with CalDAV and CardDAV. Manage your calendar events easily across all your devices.
409
 </p>
409
 </p>
410
 </div>
410
 </div>
411
 </div>
411
 </div>
412
 
412
 
413
-<div id="outline-container-orgc1784dc" class="outline-2">
414
-<h2 id="orgc1784dc">tt-rss</h2>
415
-<div class="outline-text-2" id="text-orgc1784dc">
413
+<div id="outline-container-orgaf305f3" class="outline-2">
414
+<h2 id="orgaf305f3">tt-rss</h2>
415
+<div class="outline-text-2" id="text-orgaf305f3">
416
 <p>
416
 <p>
417
 Private RSS reader. Pulls in RSS/Atom feeds via Tor and is only accessible via an onion address. Have "<i>the right to read</i>" without the Surveillance State knowing what you're reading. Also available with a user interface suitable for viewing on mobile devices via a browser such as OrFox.
417
 Private RSS reader. Pulls in RSS/Atom feeds via Tor and is only accessible via an onion address. Have "<i>the right to read</i>" without the Surveillance State knowing what you're reading. Also available with a user interface suitable for viewing on mobile devices via a browser such as OrFox.
418
 </p>
418
 </p>
419
 </div>
419
 </div>
420
 </div>
420
 </div>
421
 
421
 
422
-<div id="outline-container-org39a203f" class="outline-2">
423
-<h2 id="org39a203f">Syncthing</h2>
424
-<div class="outline-text-2" id="text-org39a203f">
422
+<div id="outline-container-orgb6c4796" class="outline-2">
423
+<h2 id="orgb6c4796">Syncthing</h2>
424
+<div class="outline-text-2" id="text-orgb6c4796">
425
 <p>
425
 <p>
426
 Possibly the best way to synchronise files across all of your devices. Once it has been set up it "just works" with no user intervention needed.
426
 Possibly the best way to synchronise files across all of your devices. Once it has been set up it "just works" with no user intervention needed.
427
 </p>
427
 </p>
428
+
429
+<p>
430
+<a href="./app_syncthing.html">How to use it</a>
431
+</p>
428
 </div>
432
 </div>
429
 </div>
433
 </div>
430
-
431
-<div id="outline-container-org2aa00f5" class="outline-2">
432
-<h2 id="org2aa00f5">Tox</h2>
433
-<div class="outline-text-2" id="text-org2aa00f5">
434
+<div id="outline-container-org7783a5a" class="outline-2">
435
+<h2 id="org7783a5a">Tox</h2>
436
+<div class="outline-text-2" id="text-org7783a5a">
434
 <p>
437
 <p>
435
 Client and bootstrap node for the Tox chat/VoIP system.
438
 Client and bootstrap node for the Tox chat/VoIP system.
436
 </p>
439
 </p>
437
 </div>
440
 </div>
438
 </div>
441
 </div>
439
 
442
 
440
-<div id="outline-container-org497c15e" class="outline-2">
441
-<h2 id="org497c15e">Vim</h2>
442
-<div class="outline-text-2" id="text-org497c15e">
443
+<div id="outline-container-orgbb00daf" class="outline-2">
444
+<h2 id="orgbb00daf">Vim</h2>
445
+<div class="outline-text-2" id="text-orgbb00daf">
443
 <p>
446
 <p>
444
 If you use the Mutt client to read your email then this will set it up to use vim for composing new mail.
447
 If you use the Mutt client to read your email then this will set it up to use vim for composing new mail.
445
 </p>
448
 </p>
446
 </div>
449
 </div>
447
 </div>
450
 </div>
448
 
451
 
449
-<div id="outline-container-org4f9fe95" class="outline-2">
450
-<h2 id="org4f9fe95">XMPP</h2>
451
-<div class="outline-text-2" id="text-org4f9fe95">
452
+<div id="outline-container-org2d46f0c" class="outline-2">
453
+<h2 id="org2d46f0c">XMPP</h2>
454
+<div class="outline-text-2" id="text-org2d46f0c">
452
 <p>
455
 <p>
453
 Chat server which can be used together with client such as Gajim or Conversations to provide end-to-end content security and also onion routed metadata security. Includes advanced features such as <i>client state notification</i> to save battery power on your mobile devices, support for seamless roaming between networks and <i>message carbons</i> so that you can receive the same messages while being simultaneously logged in to your account on more than one device.
456
 Chat server which can be used together with client such as Gajim or Conversations to provide end-to-end content security and also onion routed metadata security. Includes advanced features such as <i>client state notification</i> to save battery power on your mobile devices, support for seamless roaming between networks and <i>message carbons</i> so that you can receive the same messages while being simultaneously logged in to your account on more than one device.
454
 </p>
457
 </p>

+ 161
- 261
website/EN/usage.html View File

3
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5
 <head>
5
 <head>
6
-<!-- 2016-11-02 Wed 21:32 -->
6
+<!-- 2016-11-12 Sat 17:59 -->
7
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
7
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
8
 <meta name="viewport" content="width=device-width, initial-scale=1" />
8
 <meta name="viewport" content="width=device-width, initial-scale=1" />
9
 <title></title>
9
 <title></title>
255
 </colgroup>
255
 </colgroup>
256
 <tbody>
256
 <tbody>
257
 <tr>
257
 <tr>
258
-<td class="org-left"><a href="#org9936ac7">Readme</a></td>
258
+<td class="org-left"><a href="#org8f26a4a">Readme</a></td>
259
 </tr>
259
 </tr>
260
 
260
 
261
 <tr>
261
 <tr>
262
-<td class="org-left"><a href="#org1be5b19">Improving ssh security</a></td>
262
+<td class="org-left"><a href="#orgb27cb32">Improving ssh security</a></td>
263
 </tr>
263
 </tr>
264
 
264
 
265
 <tr>
265
 <tr>
266
-<td class="org-left"><a href="#org1887899">Administrating the system via an onion address (Tor)</a></td>
266
+<td class="org-left"><a href="#org28dd407">Administrating the system via an onion address (Tor)</a></td>
267
 </tr>
267
 </tr>
268
 
268
 
269
 <tr>
269
 <tr>
275
 </tr>
275
 </tr>
276
 
276
 
277
 <tr>
277
 <tr>
278
-<td class="org-left"><a href="#org5df7a45">Syncing to the Cloud</a></td>
278
+<td class="org-left"><a href="./app_syncthing.html">Syncing to the Cloud</a></td>
279
 </tr>
279
 </tr>
280
 
280
 
281
 <tr>
281
 <tr>
282
-<td class="org-left"><a href="#orgabfedc7">Play Music</a></td>
282
+<td class="org-left"><a href="#org155fabc">Play Music</a></td>
283
 </tr>
283
 </tr>
284
 
284
 
285
 <tr>
285
 <tr>
286
-<td class="org-left"><a href="#orge846bd9">Microblogging (GNU Social)</a></td>
286
+<td class="org-left"><a href="#org61a8cd6">Microblogging (GNU Social)</a></td>
287
 </tr>
287
 </tr>
288
 
288
 
289
 <tr>
289
 <tr>
290
-<td class="org-left"><a href="#org7aedc1c">Sharing things</a></td>
290
+<td class="org-left"><a href="#org0e52735">Sharing things</a></td>
291
 </tr>
291
 </tr>
292
 
292
 
293
 <tr>
293
 <tr>
294
-<td class="org-left"><a href="#orgfbce202">Social Network</a></td>
294
+<td class="org-left"><a href="#org6aabd2f">Social Network</a></td>
295
 </tr>
295
 </tr>
296
 
296
 
297
 <tr>
297
 <tr>
298
-<td class="org-left"><a href="#org94d3f4d">Chat Services</a></td>
298
+<td class="org-left"><a href="#orgcdd49c0">Chat Services</a></td>
299
 </tr>
299
 </tr>
300
 
300
 
301
 <tr>
301
 <tr>
302
-<td class="org-left"><a href="#org9966fa0">RSS Reader</a></td>
302
+<td class="org-left"><a href="#org4da85a9">RSS Reader</a></td>
303
 </tr>
303
 </tr>
304
 
304
 
305
 <tr>
305
 <tr>
306
-<td class="org-left"><a href="#org64324e4">Git Projects</a></td>
306
+<td class="org-left"><a href="#orgd680579">Git Projects</a></td>
307
 </tr>
307
 </tr>
308
 
308
 
309
 <tr>
309
 <tr>
310
-<td class="org-left"><a href="#org1aff88d">Adding or removing users</a></td>
310
+<td class="org-left"><a href="#orgdaac5cc">Adding or removing users</a></td>
311
 </tr>
311
 </tr>
312
 
312
 
313
 <tr>
313
 <tr>
314
-<td class="org-left"><a href="#orgc499586">Blocking Ads</a></td>
314
+<td class="org-left"><a href="#org4347af5">Blocking Ads</a></td>
315
 </tr>
315
 </tr>
316
 </tbody>
316
 </tbody>
317
 </table>
317
 </table>
318
 
318
 
319
-<div id="outline-container-org9936ac7" class="outline-2">
320
-<h2 id="org9936ac7">Readme</h2>
321
-<div class="outline-text-2" id="text-org9936ac7">
319
+<div id="outline-container-org8f26a4a" class="outline-2">
320
+<h2 id="org8f26a4a">Readme</h2>
321
+<div class="outline-text-2" id="text-org8f26a4a">
322
 <p>
322
 <p>
323
 After the system has installed a README file will be generated which contains passwords and some brief advice on using the installed systems. You can read this with the following commands:
323
 After the system has installed a README file will be generated which contains passwords and some brief advice on using the installed systems. You can read this with the following commands:
324
 </p>
324
 </p>
338
 </p>
338
 </p>
339
 </div>
339
 </div>
340
 </div>
340
 </div>
341
-<div id="outline-container-org1be5b19" class="outline-2">
342
-<h2 id="org1be5b19">Improving ssh security</h2>
343
-<div class="outline-text-2" id="text-org1be5b19">
341
+<div id="outline-container-orgb27cb32" class="outline-2">
342
+<h2 id="orgb27cb32">Improving ssh security</h2>
343
+<div class="outline-text-2" id="text-orgb27cb32">
344
 <p>
344
 <p>
345
 To improve ssh security you can generate an ssh key pair on your system and then upload the public key to the Freedombone.
345
 To improve ssh security you can generate an ssh key pair on your system and then upload the public key to the Freedombone.
346
 </p>
346
 </p>
390
 </div>
390
 </div>
391
 </div>
391
 </div>
392
 
392
 
393
-<div id="outline-container-org1887899" class="outline-2">
394
-<h2 id="org1887899">Administrating the system via an onion address (Tor)</h2>
395
-<div class="outline-text-2" id="text-org1887899">
393
+<div id="outline-container-org28dd407" class="outline-2">
394
+<h2 id="org28dd407">Administrating the system via an onion address (Tor)</h2>
395
+<div class="outline-text-2" id="text-org28dd407">
396
 <p>
396
 <p>
397
 You can also access your system via the Tor system using an onion address. To find out what the onion address for ssh access is you can do the following:
397
 You can also access your system via the Tor system using an onion address. To find out what the onion address for ssh access is you can do the following:
398
 </p>
398
 </p>
434
 </p>
434
 </p>
435
 </div>
435
 </div>
436
 </div>
436
 </div>
437
-<div id="outline-container-org5df7a45" class="outline-2">
438
-<h2 id="org5df7a45">Syncing to the Cloud</h2>
439
-<div class="outline-text-2" id="text-org5df7a45">
440
-<p>
441
-<a href="https://syncthing.net">Syncthing</a> provides a similar capability to proprietary systems such as Dropbox, and also is well suited for use with low power single board computers. You can have one or more directories which are synchronized across your various laptops/desktops/devices, and this makes it hard for you to ever lose important files. The manner in which the synchronization is done is pretty secure, such that it would be difficult for passive adversaries (mass surveillance, "<i>men in the middle</i>", etc) to know what files you're sharing. Of course, you don't necessarily need to be running a server in order to use Syncthing, but if you do have a server which is always running then there's always at least one place to synchronize your files to or from.
442
-</p>
443
-
444
-<p>
445
-Freedombone provides Syncthing shared directories for each user on the system, plus a single shared directory for all users. The expected most common scenario here is that of a family in which members may not want to share <i>all of their files</i> with each other, but might want to share some in a common pool (eg. birthday photos). You can also easily share between different servers.
446
-</p>
447
-</div>
448
-
449
-<div id="outline-container-org19bebc8" class="outline-3">
450
-<h3 id="org19bebc8">On a laptop</h3>
451
-<div class="outline-text-3" id="text-org19bebc8">
452
-<p>
453
-Install syncthing:
454
-</p>
455
-
456
-<div class="org-src-container">
457
-<pre class="src src-bash">curl -s https://syncthing.net/release-key.txt | sudo apt-key add -
458
-<span class="org-builtin">echo</span> <span class="org-string">"deb http://apt.syncthing.net/ syncthing release"</span> | sudo tee /etc/apt/sources.list.d/syncthing.list
459
-sudo apt-get update
460
-sudo apt-get install syncthing
461
-</pre>
462
-</div>
463
-
464
-<p>
465
-Add syncthing to your startup applications, so that it begins running when your system starts. Then either restart your system or run the command "syncthing" from a terminal.
466
-</p>
467
-
468
-<p>
469
-In another terminal log into Freedombone:
470
-</p>
471
-
472
-<div class="org-src-container">
473
-<pre class="src src-bash">ssh username@domainname -p 2222
474
-</pre>
475
-</div>
476
-
477
-<p>
478
-Then select <b>File Synchronization</b>.
479
-</p>
480
-
481
-
482
-<div class="figure">
483
-<p><img src="images/controlpanel/control_panel_file_sync.jpg" alt="control_panel_file_sync.jpg" />
484
-</p>
485
-</div>
486
-
487
-<p>
488
-Select <b>Show device ID</b> and copy the long string of letters and numbers shown, using the shift key then select the text followed by right click then select copy.
489
-</p>
490
-
491
-<p>
492
-Open a non-Tor browser and enter  <b><a href="http://127.0.0.1:8384">http://127.0.0.1:8384</a></b> as the URL. You should now see the minimalistic user interface. Under <b>Remote Devices</b> select <b>Add Remote Device</b>. In the <b>Device ID</b> field paste the string you just copied (CTRL+v). The Device name can be anything. Under <b>Share Folders with Device</b> check <b>default</b> (or whatever folder you created on your local machine), then save.
493
-</p>
494
-
495
-<p>
496
-From the top menu select <b>Actions</b> and then <b>Show ID</b>, then copy the ID string (usually select then CTRL+c). Go back to the terminal control panel menu and select <b>Add an ID</b> then paste what you just copied (CTRL+v). Optionally you can also provide a description so that you later can know what that string corresponds to.
497
-</p>
498
-
499
-<p>
500
-Now wait for a few minutes. Eventually you will see two messages appear within the browser asking if you want to add two new folders from the Freedombone server. Say yes to both, and specify <b>~/Sync</b> as the directory with your username and <b>~/SyncShared</b> as the shared directory. You can now copy files into your <b>~/Sync</b> directory and they will automatically be synced to the server. Those will be files which only you can access. If you copy files into <b>~/SyncShared</b> then they will also be available to any other users on the system.
501
-</p>
502
-</div>
503
-</div>
504
-<div id="outline-container-orgbc229a3" class="outline-3">
505
-<h3 id="orgbc229a3">On Android</h3>
506
-<div class="outline-text-3" id="text-orgbc229a3">
507
-<p>
508
-Install Syncthing and Connectbot from F-droid.
509
-</p>
510
-
511
-<p>
512
-Set up Connectbot to log into Freedombone.
513
-</p>
514
-
515
-<p>
516
-Select <b>File Synchronization</b>.
517
-</p>
518
-
519
-<p>
520
-Select <b>Show device ID</b> and copy the long string of letters by pressing anywhere on the screen, selecting the <b>menu</b> then <b>copy</b> and then selecting the ID string. This is very tricky on a small screen, so expect to fail multiple times before you succeed in copying the text.
521
-</p>
522
-
523
-<p>
524
-Open Syncthing and select the devices tab. Press on <b>+</b> and then paste the device ID with a long press followed by <b>Paste</b>. You may need to remove any stray characters which were copied during the previous haphazard selection process. Add a name, which can be anything.
525
-</p>
526
-
527
-<p>
528
-Now select the menu (top left or menu button) and then press on <b>Device ID</b>. It will be copied to the clipboard. Go back to Connectbot and from the control panel select <b>File Synchronization</b> followed by <b>Add an ID</b>. You can then paste in the ID with a long press, and optionally add a description for the device. When that's done you can disconnect from Connectbot.
529
-</p>
530
-
531
-<p>
532
-Now wait for a few minutes or more. Eventually you should receive two notifications (swipe down from the top to see them) which will allow you to confirm the connection to the server. Say yes to both, and specify appropriate directories for your files and the shared files. To reduce battery and data usage via the settings you can also set Syncthing to only sync while it's charging and only while it's connected to wifi.
533
-</p>
534
-</div>
535
-</div>
536
-</div>
537
-<div id="outline-container-orgabfedc7" class="outline-2">
538
-<h2 id="orgabfedc7">Play Music</h2>
539
-<div class="outline-text-2" id="text-orgabfedc7">
540
-</div><div id="outline-container-orgcfbb879" class="outline-3">
541
-<h3 id="orgcfbb879">With the DLNA service</h3>
542
-<div class="outline-text-3" id="text-orgcfbb879">
437
+<div id="outline-container-org155fabc" class="outline-2">
438
+<h2 id="org155fabc">Play Music</h2>
439
+<div class="outline-text-2" id="text-org155fabc">
440
+</div><div id="outline-container-org0b87a9e" class="outline-3">
441
+<h3 id="org0b87a9e">With the DLNA service</h3>
442
+<div class="outline-text-3" id="text-org0b87a9e">
543
 <p>
443
 <p>
544
 An easy way to play music on any mobile device in your home is to use the DLNA service. Copy your music into a directory called "<i>Music</i>" on a USB thumb drive and then insert it into from socket on the Beaglebone.
444
 An easy way to play music on any mobile device in your home is to use the DLNA service. Copy your music into a directory called "<i>Music</i>" on a USB thumb drive and then insert it into from socket on the Beaglebone.
545
 </p>
445
 </p>
578
 </div>
478
 </div>
579
 </div>
479
 </div>
580
 
480
 
581
-<div id="outline-container-orge846bd9" class="outline-2">
582
-<h2 id="orge846bd9">Microblogging (GNU Social)</h2>
583
-<div class="outline-text-2" id="text-orge846bd9">
584
-</div><div id="outline-container-org0cf79d4" class="outline-3">
585
-<h3 id="org0cf79d4">Initial setup</h3>
586
-<div class="outline-text-3" id="text-org0cf79d4">
481
+<div id="outline-container-org61a8cd6" class="outline-2">
482
+<h2 id="org61a8cd6">Microblogging (GNU Social)</h2>
483
+<div class="outline-text-2" id="text-org61a8cd6">
484
+</div><div id="outline-container-org032847f" class="outline-3">
485
+<h3 id="org032847f">Initial setup</h3>
486
+<div class="outline-text-3" id="text-org032847f">
587
 <p>
487
 <p>
588
 To log into your GNU Social site first obtain your username and password from the "microblogging" section of the readme file.
488
 To log into your GNU Social site first obtain your username and password from the "microblogging" section of the readme file.
589
 </p>
489
 </p>
611
 </div>
511
 </div>
612
 </div>
512
 </div>
613
 
513
 
614
-<div id="outline-container-org78c846b" class="outline-3">
615
-<h3 id="org78c846b">Direct Messages (DMs) and privacy</h3>
616
-<div class="outline-text-3" id="text-org78c846b">
514
+<div id="outline-container-orgbcbd947" class="outline-3">
515
+<h3 id="orgbcbd947">Direct Messages (DMs) and privacy</h3>
516
+<div class="outline-text-3" id="text-orgbcbd947">
617
 <p>
517
 <p>
618
 One important point about GNU Social is that although direct messages (DMs) are treated as being private their security is quite poor. If you want real communications privacy then use other systems such as XMPP+OMEMO/OTR, Tox or email with GPG. GNU Social is primarily about <i>fully public communications</i>.
518
 One important point about GNU Social is that although direct messages (DMs) are treated as being private their security is quite poor. If you want real communications privacy then use other systems such as XMPP+OMEMO/OTR, Tox or email with GPG. GNU Social is primarily about <i>fully public communications</i>.
619
 </p>
519
 </p>
620
 </div>
520
 </div>
621
 </div>
521
 </div>
622
-<div id="outline-container-org15ccd6e" class="outline-3">
623
-<h3 id="org15ccd6e">Using with Emacs</h3>
624
-<div class="outline-text-3" id="text-org15ccd6e">
522
+<div id="outline-container-orgd456430" class="outline-3">
523
+<h3 id="orgd456430">Using with Emacs</h3>
524
+<div class="outline-text-3" id="text-orgd456430">
625
 <p>
525
 <p>
626
 If you are an Emacs user it's also possible to set up GNU Social mode as follows:
526
 If you are an Emacs user it's also possible to set up GNU Social mode as follows:
627
 </p>
527
 </p>
705
 </div>
605
 </div>
706
 </div>
606
 </div>
707
 
607
 
708
-<div id="outline-container-org7aedc1c" class="outline-2">
709
-<h2 id="org7aedc1c">Sharing things</h2>
710
-<div class="outline-text-2" id="text-org7aedc1c">
608
+<div id="outline-container-org0e52735" class="outline-2">
609
+<h2 id="org0e52735">Sharing things</h2>
610
+<div class="outline-text-2" id="text-org0e52735">
711
 <p>
611
 <p>
712
 If you have the GNU Social microblogging system installed then it's also possible to share things or services between groups or with particular users. This can be useful for sharing items within a family, club or in a local sharing economy. Sharing things freely, without money, reveals the social basis at the root of all economics which money normally conceals or obscures.
612
 If you have the GNU Social microblogging system installed then it's also possible to share things or services between groups or with particular users. This can be useful for sharing items within a family, club or in a local sharing economy. Sharing things freely, without money, reveals the social basis at the root of all economics which money normally conceals or obscures.
713
 </p>
613
 </p>
734
 </div>
634
 </div>
735
 </div>
635
 </div>
736
 
636
 
737
-<div id="outline-container-orgfbce202" class="outline-2">
738
-<h2 id="orgfbce202">Social Network</h2>
739
-<div class="outline-text-2" id="text-orgfbce202">
740
-</div><div id="outline-container-org5ab439d" class="outline-3">
741
-<h3 id="org5ab439d">Domains</h3>
742
-<div class="outline-text-3" id="text-org5ab439d">
637
+<div id="outline-container-org6aabd2f" class="outline-2">
638
+<h2 id="org6aabd2f">Social Network</h2>
639
+<div class="outline-text-2" id="text-org6aabd2f">
640
+</div><div id="outline-container-org5c4d7d0" class="outline-3">
641
+<h3 id="org5c4d7d0">Domains</h3>
642
+<div class="outline-text-3" id="text-org5c4d7d0">
743
 <p>
643
 <p>
744
 Both Hubzilla and GNU Social try to obtain certificates automatically at the time of installation via Let's Encrypt. This will likely mean that in order for this to work you'll need to have obtained at least one "official" domain via a domain selling service, since Let's Encrypt mostly doesn't seem to work with free subdomains from sites such as freeDNS.
644
 Both Hubzilla and GNU Social try to obtain certificates automatically at the time of installation via Let's Encrypt. This will likely mean that in order for this to work you'll need to have obtained at least one "official" domain via a domain selling service, since Let's Encrypt mostly doesn't seem to work with free subdomains from sites such as freeDNS.
745
 </p>
645
 </p>
746
 </div>
646
 </div>
747
 </div>
647
 </div>
748
-<div id="outline-container-orgecbd03f" class="outline-3">
749
-<h3 id="orgecbd03f">Initial install</h3>
750
-<div class="outline-text-3" id="text-orgecbd03f">
648
+<div id="outline-container-org275bceb" class="outline-3">
649
+<h3 id="org275bceb">Initial install</h3>
650
+<div class="outline-text-3" id="text-org275bceb">
751
 <p>
651
 <p>
752
 On first visiting your Hubzilla site you'll see the login screen. The first thing you need to do is <b>register</b> a new user. The first user on the system then becomes its administrator.
652
 On first visiting your Hubzilla site you'll see the login screen. The first thing you need to do is <b>register</b> a new user. The first user on the system then becomes its administrator.
753
 </p>
653
 </p>
761
 </div>
661
 </div>
762
 </div>
662
 </div>
763
 
663
 
764
-<div id="outline-container-org94d3f4d" class="outline-2">
765
-<h2 id="org94d3f4d">Chat Services</h2>
766
-<div class="outline-text-2" id="text-org94d3f4d">
767
-</div><div id="outline-container-org85c70b1" class="outline-3">
768
-<h3 id="org85c70b1">IRC</h3>
769
-<div class="outline-text-3" id="text-org85c70b1">
664
+<div id="outline-container-orgcdd49c0" class="outline-2">
665
+<h2 id="orgcdd49c0">Chat Services</h2>
666
+<div class="outline-text-2" id="text-orgcdd49c0">
667
+</div><div id="outline-container-org2e941c8" class="outline-3">
668
+<h3 id="org2e941c8">IRC</h3>
669
+<div class="outline-text-3" id="text-org2e941c8">
770
 <p>
670
 <p>
771
 IRC is useful for multi-user chat. The classic use case is for software development where many engineers might need to coordinate their activities, but it's also useful for meetings, parties and general socialising.
671
 IRC is useful for multi-user chat. The classic use case is for software development where many engineers might need to coordinate their activities, but it's also useful for meetings, parties and general socialising.
772
 </p>
672
 </p>
773
 </div>
673
 </div>
774
-<div id="outline-container-orgaef368e" class="outline-4">
775
-<h4 id="orgaef368e">Irssi</h4>
776
-<div class="outline-text-4" id="text-orgaef368e">
674
+<div id="outline-container-org4d790e3" class="outline-4">
675
+<h4 id="org4d790e3">Irssi</h4>
676
+<div class="outline-text-4" id="text-org4d790e3">
777
 <p>
677
 <p>
778
 The easiest way to use irssi is to connect to your system, like this:
678
 The easiest way to use irssi is to connect to your system, like this:
779
 </p>
679
 </p>
788
 </p>
688
 </p>
789
 </div>
689
 </div>
790
 </div>
690
 </div>
791
-<div id="outline-container-org7bc89f2" class="outline-4">
792
-<h4 id="org7bc89f2">HexChat</h4>
793
-<div class="outline-text-4" id="text-org7bc89f2">
691
+<div id="outline-container-orgd0403ac" class="outline-4">
692
+<h4 id="orgd0403ac">HexChat</h4>
693
+<div class="outline-text-4" id="text-orgd0403ac">
794
 <p>
694
 <p>
795
 HexChat (formerly XChat) is compatible with proxying via Tor and so provides the best security when connecting to your IRC server. It will allow you to connect to your IRC server's onion address.
695
 HexChat (formerly XChat) is compatible with proxying via Tor and so provides the best security when connecting to your IRC server. It will allow you to connect to your IRC server's onion address.
796
 </p>
696
 </p>
871
 </div>
771
 </div>
872
 </div>
772
 </div>
873
 
773
 
874
-<div id="outline-container-org2891aca" class="outline-4">
875
-<h4 id="org2891aca">Emacs</h4>
876
-<div class="outline-text-4" id="text-org2891aca">
774
+<div id="outline-container-org8874369" class="outline-4">
775
+<h4 id="org8874369">Emacs</h4>
776
+<div class="outline-text-4" id="text-org8874369">
877
 <p>
777
 <p>
878
 If you are an Emacs user then you can also connect to your IRC server via Emacs.
778
 If you are an Emacs user then you can also connect to your IRC server via Emacs.
879
 </p>
779
 </p>
904
 </div>
804
 </div>
905
 </div>
805
 </div>
906
 </div>
806
 </div>
907
-<div id="outline-container-org5e9c3bd" class="outline-4">
908
-<h4 id="org5e9c3bd">Changing or removing the IRC password</h4>
909
-<div class="outline-text-4" id="text-org5e9c3bd">
807
+<div id="outline-container-org0cb97f8" class="outline-4">
808
+<h4 id="org0cb97f8">Changing or removing the IRC password</h4>
809
+<div class="outline-text-4" id="text-org0cb97f8">
910
 <p>
810
 <p>
911
 By default the IRC server is set up to require a password for users to log in. The password is the same for all users. If you want to change or remove the password:
811
 By default the IRC server is set up to require a password for users to log in. The password is the same for all users. If you want to change or remove the password:
912
 </p>
812
 </p>
923
 </div>
823
 </div>
924
 </div>
824
 </div>
925
 
825
 
926
-<div id="outline-container-org6440024" class="outline-3">
927
-<h3 id="org6440024">XMPP/Jabber</h3>
928
-<div class="outline-text-3" id="text-org6440024">
929
-</div><div id="outline-container-orgeb8020e" class="outline-4">
930
-<h4 id="orgeb8020e">About XMPP</h4>
931
-<div class="outline-text-4" id="text-orgeb8020e">
826
+<div id="outline-container-orgc00d9cb" class="outline-3">
827
+<h3 id="orgc00d9cb">XMPP/Jabber</h3>
828
+<div class="outline-text-3" id="text-orgc00d9cb">
829
+</div><div id="outline-container-orgc428939" class="outline-4">
830
+<h4 id="orgc428939">About XMPP</h4>
831
+<div class="outline-text-4" id="text-orgc428939">
932
 <p>
832
 <p>
933
 A well written article on the state of XMPP and how it compares to other chat protocols <a href="https://gultsch.de/xmpp_2016.html">can be found here</a>.
833
 A well written article on the state of XMPP and how it compares to other chat protocols <a href="https://gultsch.de/xmpp_2016.html">can be found here</a>.
934
 </p>
834
 </p>
935
 </div>
835
 </div>
936
 </div>
836
 </div>
937
-<div id="outline-container-orge19dfac" class="outline-4">
938
-<h4 id="orge19dfac">Using with Gajim</h4>
939
-<div class="outline-text-4" id="text-orge19dfac">
837
+<div id="outline-container-org9c40bca" class="outline-4">
838
+<h4 id="org9c40bca">Using with Gajim</h4>
839
+<div class="outline-text-4" id="text-org9c40bca">
940
 <p>
840
 <p>
941
 In mid 2016 <a href="https://gajim.org/">Gajim</a> became the first desktop XMPP client to support the <a href="https://en.wikipedia.org/wiki/OMEMO">OMEMO end-to-end security standard</a>, which is superior to the more traditional <a href="https://en.wikipedia.org/wiki/Off-the-Record_Messaging">OTR</a> since it also includes multi-user chat and the ratcheting mechanism pioneered by Open Whisper Systems. To install it:
841
 In mid 2016 <a href="https://gajim.org/">Gajim</a> became the first desktop XMPP client to support the <a href="https://en.wikipedia.org/wiki/OMEMO">OMEMO end-to-end security standard</a>, which is superior to the more traditional <a href="https://en.wikipedia.org/wiki/Off-the-Record_Messaging">OTR</a> since it also includes multi-user chat and the ratcheting mechanism pioneered by Open Whisper Systems. To install it:
942
 </p>
842
 </p>
980
 </div>
880
 </div>
981
 </div>
881
 </div>
982
 
882
 
983
-<div id="outline-container-org0a0a7a2" class="outline-4">
984
-<h4 id="org0a0a7a2">Using with Profanity</h4>
985
-<div class="outline-text-4" id="text-org0a0a7a2">
883
+<div id="outline-container-orge5eb75d" class="outline-4">
884
+<h4 id="orge5eb75d">Using with Profanity</h4>
885
+<div class="outline-text-4" id="text-orge5eb75d">
986
 <p>
886
 <p>
987
 The <a href="https://profanity.im">Profanity</a> shell based user interface and is perhaps the simplest way to use XMPP from a laptop. It's also a good way to ensure that your OTR keys are the same even when logging in from different laptops or devices, and it also means that if those devices later become compomised then there are no locally stored OTR keys to be found.
887
 The <a href="https://profanity.im">Profanity</a> shell based user interface and is perhaps the simplest way to use XMPP from a laptop. It's also a good way to ensure that your OTR keys are the same even when logging in from different laptops or devices, and it also means that if those devices later become compomised then there are no locally stored OTR keys to be found.
988
 </p>
888
 </p>
1064
 </p>
964
 </p>
1065
 </div>
965
 </div>
1066
 </div>
966
 </div>
1067
-<div id="outline-container-org25db5f0" class="outline-4">
1068
-<h4 id="org25db5f0">Using with Jitsi</h4>
1069
-<div class="outline-text-4" id="text-org25db5f0">
967
+<div id="outline-container-orga01801d" class="outline-4">
968
+<h4 id="orga01801d">Using with Jitsi</h4>
969
+<div class="outline-text-4" id="text-orga01801d">
1070
 <p>
970
 <p>
1071
 Jitsi is the recommended communications client for desktop or laptop systems, since it includes the <i>off the record</i> (OTR) feature which provides some additional security beyond the usual SSL certificates.
971
 Jitsi is the recommended communications client for desktop or laptop systems, since it includes the <i>off the record</i> (OTR) feature which provides some additional security beyond the usual SSL certificates.
1072
 </p>
972
 </p>
1096
 </p>
996
 </p>
1097
 </div>
997
 </div>
1098
 </div>
998
 </div>
1099
-<div id="outline-container-org9ce1de0" class="outline-4">
1100
-<h4 id="org9ce1de0">Using with Ubuntu</h4>
1101
-<div class="outline-text-4" id="text-org9ce1de0">
999
+<div id="outline-container-org3657e2e" class="outline-4">
1000
+<h4 id="org3657e2e">Using with Ubuntu</h4>
1001
+<div class="outline-text-4" id="text-org3657e2e">
1102
 <p>
1002
 <p>
1103
 The default XMPP client in Ubuntu is Empathy.  Using Empathy isn't as secure as using Jitsi, since it doesn't include the <i>off the record</i> feature, but since it's the default it's what many users will have easy access to.
1003
 The default XMPP client in Ubuntu is Empathy.  Using Empathy isn't as secure as using Jitsi, since it doesn't include the <i>off the record</i> feature, but since it's the default it's what many users will have easy access to.
1104
 </p>
1004
 </p>
1116
 </p>
1016
 </p>
1117
 </div>
1017
 </div>
1118
 </div>
1018
 </div>
1119
-<div id="outline-container-orgb0c614f" class="outline-4">
1120
-<h4 id="orgb0c614f">Using Tor Messenger</h4>
1121
-<div class="outline-text-4" id="text-orgb0c614f">
1019
+<div id="outline-container-orga4c3fc9" class="outline-4">
1020
+<h4 id="orga4c3fc9">Using Tor Messenger</h4>
1021
+<div class="outline-text-4" id="text-orga4c3fc9">
1122
 <p>
1022
 <p>
1123
 Tor Messenger is a messaging client which supports XMPP, and its onion routing enables you to protect the metadata of chat interactions to some extent by making it difficult for an adversary to know which server is talking to which. You can download Tor Messenger from <a href="https://torproject.org">torproject.org</a> and the setup is pretty simple.
1023
 Tor Messenger is a messaging client which supports XMPP, and its onion routing enables you to protect the metadata of chat interactions to some extent by making it difficult for an adversary to know which server is talking to which. You can download Tor Messenger from <a href="https://torproject.org">torproject.org</a> and the setup is pretty simple.
1124
 </p>
1024
 </p>
1125
 </div>
1025
 </div>
1126
 </div>
1026
 </div>
1127
-<div id="outline-container-orgde2d4de" class="outline-4">
1128
-<h4 id="orgde2d4de">Using with Android/Conversations</h4>
1129
-<div class="outline-text-4" id="text-orgde2d4de">
1027
+<div id="outline-container-orgba505ef" class="outline-4">
1028
+<h4 id="orgba505ef">Using with Android/Conversations</h4>
1029
+<div class="outline-text-4" id="text-orgba505ef">
1130
 <p>
1030
 <p>
1131
 Install <a href="https://f-droid.org/">F-Droid</a>
1031
 Install <a href="https://f-droid.org/">F-Droid</a>
1132
 </p>
1032
 </p>
1161
 </div>
1061
 </div>
1162
 </div>
1062
 </div>
1163
 </div>
1063
 </div>
1164
-<div id="outline-container-org8575119" class="outline-3">
1165
-<h3 id="org8575119">Tox</h3>
1166
-<div class="outline-text-3" id="text-org8575119">
1064
+<div id="outline-container-org1f3c3e7" class="outline-3">
1065
+<h3 id="org1f3c3e7">Tox</h3>
1066
+<div class="outline-text-3" id="text-org1f3c3e7">
1167
 <p>
1067
 <p>
1168
 Tox is an encrypted peer-to-peer messaging system and so should work without Freedombone. It uses a system of nodes which act as a sort of directory service allowing users to find and connect to each other. The Tox node ID on the Freedombone can be found within the README within your home directory. If you have other users connect to your node then you will be able to continue chatting even when no other nodes are available.
1068
 Tox is an encrypted peer-to-peer messaging system and so should work without Freedombone. It uses a system of nodes which act as a sort of directory service allowing users to find and connect to each other. The Tox node ID on the Freedombone can be found within the README within your home directory. If you have other users connect to your node then you will be able to continue chatting even when no other nodes are available.
1169
 </p>
1069
 </p>
1170
 </div>
1070
 </div>
1171
-<div id="outline-container-org2becdd8" class="outline-4">
1172
-<h4 id="org2becdd8">Using the Toxic client</h4>
1173
-<div class="outline-text-4" id="text-org2becdd8">
1071
+<div id="outline-container-org22c6b6f" class="outline-4">
1072
+<h4 id="org22c6b6f">Using the Toxic client</h4>
1073
+<div class="outline-text-4" id="text-org22c6b6f">
1174
 <p>
1074
 <p>
1175
 Log into your system with:
1075
 Log into your system with:
1176
 </p>
1076
 </p>
1193
 </div>
1093
 </div>
1194
 </div>
1094
 </div>
1195
 
1095
 
1196
-<div id="outline-container-orgae98107" class="outline-3">
1197
-<h3 id="orgae98107">VoIP (Voice and text chat)</h3>
1198
-<div class="outline-text-3" id="text-orgae98107">
1199
-</div><div id="outline-container-orgbb17aff" class="outline-4">
1200
-<h4 id="orgbb17aff">Text chat</h4>
1201
-<div class="outline-text-4" id="text-orgbb17aff">
1096
+<div id="outline-container-org8afe5cb" class="outline-3">
1097
+<h3 id="org8afe5cb">VoIP (Voice and text chat)</h3>
1098
+<div class="outline-text-3" id="text-org8afe5cb">
1099
+</div><div id="outline-container-orga7a851f" class="outline-4">
1100
+<h4 id="orga7a851f">Text chat</h4>
1101
+<div class="outline-text-4" id="text-orga7a851f">
1202
 <p>
1102
 <p>
1203
 In addition to voice it is also possible to do text chat via mumble. The security of this is pretty good provided that you do it via Plumble and Orbot on mobile, but compared to other options such as XMPP/Conversations or Tox the security is not as good, since the mumble server currently doesn't support forward secrecy.
1103
 In addition to voice it is also possible to do text chat via mumble. The security of this is pretty good provided that you do it via Plumble and Orbot on mobile, but compared to other options such as XMPP/Conversations or Tox the security is not as good, since the mumble server currently doesn't support forward secrecy.
1204
 </p>
1104
 </p>
1205
 </div>
1105
 </div>
1206
 </div>
1106
 </div>
1207
-<div id="outline-container-orga7c1ba7" class="outline-4">
1208
-<h4 id="orga7c1ba7">Using with Ubuntu</h4>
1209
-<div class="outline-text-4" id="text-orga7c1ba7">
1107
+<div id="outline-container-org6cd381e" class="outline-4">
1108
+<h4 id="org6cd381e">Using with Ubuntu</h4>
1109
+<div class="outline-text-4" id="text-org6cd381e">
1210
 <p>
1110
 <p>
1211
 Within the software center search for "mumble" and install the client then run it. Skip through the audio setup wizard.
1111
 Within the software center search for "mumble" and install the client then run it. Skip through the audio setup wizard.
1212
 </p>
1112
 </p>
1216
 </p>
1116
 </p>
1217
 </div>
1117
 </div>
1218
 </div>
1118
 </div>
1219
-<div id="outline-container-org420666c" class="outline-4">
1220
-<h4 id="org420666c">Using with Android</h4>
1221
-<div class="outline-text-4" id="text-org420666c">
1119
+<div id="outline-container-org3fcb575" class="outline-4">
1120
+<h4 id="org3fcb575">Using with Android</h4>
1121
+<div class="outline-text-4" id="text-org3fcb575">
1222
 <p>
1122
 <p>
1223
 Install <a href="https://f-droid.org/">F-Droid</a>
1123
 Install <a href="https://f-droid.org/">F-Droid</a>
1224
 </p>
1124
 </p>
1253
 </div>
1153
 </div>
1254
 </div>
1154
 </div>
1255
 </div>
1155
 </div>
1256
-<div id="outline-container-orgbbd2d75" class="outline-3">
1257
-<h3 id="orgbbd2d75">SIP phones</h3>
1258
-<div class="outline-text-3" id="text-orgbbd2d75">
1156
+<div id="outline-container-org69c3a39" class="outline-3">
1157
+<h3 id="org69c3a39">SIP phones</h3>
1158
+<div class="outline-text-3" id="text-org69c3a39">
1259
 <p>
1159
 <p>
1260
 Freedombone also supports SIP phones The username and domain is the same as for your email address, and the SIP password and extension number will appear within the README file in your home directory. Various SIP client options are available, such as CSipSimple on Android and Jitsi on desktop or laptop machines. Ideally use clients which support ZRTP, which will provide the best level of security.
1160
 Freedombone also supports SIP phones The username and domain is the same as for your email address, and the SIP password and extension number will appear within the README file in your home directory. Various SIP client options are available, such as CSipSimple on Android and Jitsi on desktop or laptop machines. Ideally use clients which support ZRTP, which will provide the best level of security.
1261
 </p>
1161
 </p>
1262
 </div>
1162
 </div>
1263
-<div id="outline-container-org925dbec" class="outline-4">
1264
-<h4 id="org925dbec">About ZRTP</h4>
1265
-<div class="outline-text-4" id="text-org925dbec">
1163
+<div id="outline-container-orge7963d1" class="outline-4">
1164
+<h4 id="orge7963d1">About ZRTP</h4>
1165
+<div class="outline-text-4" id="text-orge7963d1">
1266
 <p>
1166
 <p>
1267
 <a href="https://jitsi.org/Documentation/ZrtpFAQ">ZRTP</a> appears to be the current best standard to end-to-end encrypted voice calls, combining good security with simplicity of use. When the initial cryptographic negotiation between phones is done at the start of a call a short authentication string (SAS) is calculated and displayed at both ends. To check that there isn't anyone intercepting the call and acting as a <i>man in the middle</i> - as <a href="https://en.wikipedia.org/wiki/Stingray_phone_tracker">stingray type devices</a> try to do - the short authentication string can be read out and verbally confirmed between the callers. If it's the same then you can be pretty confident that the call is secure.
1167
 <a href="https://jitsi.org/Documentation/ZrtpFAQ">ZRTP</a> appears to be the current best standard to end-to-end encrypted voice calls, combining good security with simplicity of use. When the initial cryptographic negotiation between phones is done at the start of a call a short authentication string (SAS) is calculated and displayed at both ends. To check that there isn't anyone intercepting the call and acting as a <i>man in the middle</i> - as <a href="https://en.wikipedia.org/wiki/Stingray_phone_tracker">stingray type devices</a> try to do - the short authentication string can be read out and verbally confirmed between the callers. If it's the same then you can be pretty confident that the call is secure.
1268
 </p>
1168
 </p>
1269
 </div>
1169
 </div>
1270
 </div>
1170
 </div>
1271
-<div id="outline-container-org6bc8f17" class="outline-4">
1272
-<h4 id="org6bc8f17">Using with CSIPSimple</h4>
1273
-<div class="outline-text-4" id="text-org6bc8f17">
1171
+<div id="outline-container-org89b01db" class="outline-4">
1172
+<h4 id="org89b01db">Using with CSIPSimple</h4>
1173
+<div class="outline-text-4" id="text-org89b01db">
1274
 <p>
1174
 <p>
1275
 Add an account. Under <b>General Wizards</b> choose <b>Expert</b> and enter the following details:
1175
 Add an account. Under <b>General Wizards</b> choose <b>Expert</b> and enter the following details:
1276
 </p>
1176
 </p>
1326
 </p>
1226
 </p>
1327
 </div>
1227
 </div>
1328
 </div>
1228
 </div>
1329
-<div id="outline-container-org06cff5b" class="outline-4">
1330
-<h4 id="org06cff5b">Using with Ring</h4>
1331
-<div class="outline-text-4" id="text-org06cff5b">
1229
+<div id="outline-container-org6ae15ee" class="outline-4">
1230
+<h4 id="org6ae15ee">Using with Ring</h4>
1231
+<div class="outline-text-4" id="text-org6ae15ee">
1332
 <p>
1232
 <p>
1333
 From the menu select <b>Manage accounts</b>.
1233
 From the menu select <b>Manage accounts</b>.
1334
 </p>
1234
 </p>
1381
 </div>
1281
 </div>
1382
 </div>
1282
 </div>
1383
 
1283
 
1384
-<div id="outline-container-org9966fa0" class="outline-2">
1385
-<h2 id="org9966fa0">RSS Reader</h2>
1386
-<div class="outline-text-2" id="text-org9966fa0">
1284
+<div id="outline-container-org4da85a9" class="outline-2">
1285
+<h2 id="org4da85a9">RSS Reader</h2>
1286
+<div class="outline-text-2" id="text-org4da85a9">
1387
 <p>
1287
 <p>
1388
 The way that RSS reading is set up on Freedombone gives you strong reading privacy. Not only is there onion routing between you and the server but also between the server and the source of the RSS feed. The only down side is that many RSS feeds are still http only, and so could be vulnerable to injection attacks, but it's expected that more of this will go to https in the foreseeable future due to a combination of growing recognition of security issues and systems like Let's Encrypt which make obtaining certificates much easier.
1288
 The way that RSS reading is set up on Freedombone gives you strong reading privacy. Not only is there onion routing between you and the server but also between the server and the source of the RSS feed. The only down side is that many RSS feeds are still http only, and so could be vulnerable to injection attacks, but it's expected that more of this will go to https in the foreseeable future due to a combination of growing recognition of security issues and systems like Let's Encrypt which make obtaining certificates much easier.
1389
 </p>
1289
 </p>
1395
 </div>
1295
 </div>
1396
 </div>
1296
 </div>
1397
 
1297
 
1398
-<div id="outline-container-orge60ecff" class="outline-3">
1399
-<h3 id="orge60ecff">Finding the onion address</h3>
1400
-<div class="outline-text-3" id="text-orge60ecff">
1298
+<div id="outline-container-org9813c49" class="outline-3">
1299
+<h3 id="org9813c49">Finding the onion address</h3>
1300
+<div class="outline-text-3" id="text-org9813c49">
1401
 <p>
1301
 <p>
1402
 See the control panel for the RSS reader onion address.
1302
 See the control panel for the RSS reader onion address.
1403
 </p>
1303
 </p>
1421
 </div>
1321
 </div>
1422
 </div>
1322
 </div>
1423
 
1323
 
1424
-<div id="outline-container-orgc79b741" class="outline-3">
1425
-<h3 id="orgc79b741">On mobile</h3>
1426
-<div class="outline-text-3" id="text-orgc79b741">
1324
+<div id="outline-container-org8125a0f" class="outline-3">
1325
+<h3 id="org8125a0f">On mobile</h3>
1326
+<div class="outline-text-3" id="text-org8125a0f">
1427
 <p>
1327
 <p>
1428
 To access the RSS reader from a mobile device you can install a Tor compatible browser such as OrFox. It will try to automatically change to the mobile version of the user interface. Remember to add the site to the NoScript whitelist, and you may also need to turn HTTPS Everywhere off.
1328
 To access the RSS reader from a mobile device you can install a Tor compatible browser such as OrFox. It will try to automatically change to the mobile version of the user interface. Remember to add the site to the NoScript whitelist, and you may also need to turn HTTPS Everywhere off.
1429
 </p>
1329
 </p>
1435
 </blockquote>
1335
 </blockquote>
1436
 </div>
1336
 </div>
1437
 </div>
1337
 </div>
1438
-<div id="outline-container-org4e73cf7" class="outline-3">
1439
-<h3 id="org4e73cf7">With Emacs</h3>
1440
-<div class="outline-text-3" id="text-org4e73cf7">
1338
+<div id="outline-container-orge8ec11b" class="outline-3">
1339
+<h3 id="orge8ec11b">With Emacs</h3>
1340
+<div class="outline-text-3" id="text-orge8ec11b">
1441
 <p>
1341
 <p>
1442
 If you are an Emacs user then you can also read your RSS feeds via the <a href="https://github.com/dk87/avandu">Avandu</a> mode.
1342
 If you are an Emacs user then you can also read your RSS feeds via the <a href="https://github.com/dk87/avandu">Avandu</a> mode.
1443
 </p>
1343
 </p>
1476
 </div>
1376
 </div>
1477
 </div>
1377
 </div>
1478
 </div>
1378
 </div>
1479
-<div id="outline-container-org64324e4" class="outline-2">
1480
-<h2 id="org64324e4">Git Projects</h2>
1481
-<div class="outline-text-2" id="text-org64324e4">
1379
+<div id="outline-container-orgd680579" class="outline-2">
1380
+<h2 id="orgd680579">Git Projects</h2>
1381
+<div class="outline-text-2" id="text-orgd680579">
1482
 <p>
1382
 <p>
1483
 Github is ok, but it's proprietary and funded by venture capital. If you been around on the internet for long enough then you know how this story eventually works itself out - i.e. badly for the users. It's really only a question of time. If you're a software developer or do things which involve the Git version control system then it's a good idea to become accustomed to hosting your own repositories, before the inevitable Github shitstorm happens.
1383
 Github is ok, but it's proprietary and funded by venture capital. If you been around on the internet for long enough then you know how this story eventually works itself out - i.e. badly for the users. It's really only a question of time. If you're a software developer or do things which involve the Git version control system then it's a good idea to become accustomed to hosting your own repositories, before the inevitable Github shitstorm happens.
1484
 </p>
1384
 </p>
1514
 </p>
1414
 </p>
1515
 </div>
1415
 </div>
1516
 </div>
1416
 </div>
1517
-<div id="outline-container-org1aff88d" class="outline-2">
1518
-<h2 id="org1aff88d">Adding or removing users</h2>
1519
-<div class="outline-text-2" id="text-org1aff88d">
1417
+<div id="outline-container-orgdaac5cc" class="outline-2">
1418
+<h2 id="orgdaac5cc">Adding or removing users</h2>
1419
+<div class="outline-text-2" id="text-orgdaac5cc">
1520
 <p>
1420
 <p>
1521
 Log into the system with:
1421
 Log into the system with:
1522
 </p>
1422
 </p>
1544
 </div>
1444
 </div>
1545
 </div>
1445
 </div>
1546
 
1446
 
1547
-<div id="outline-container-orgc499586" class="outline-2">
1548
-<h2 id="orgc499586">Blocking Ads</h2>
1549
-<div class="outline-text-2" id="text-orgc499586">
1447
+<div id="outline-container-org4347af5" class="outline-2">
1448
+<h2 id="org4347af5">Blocking Ads</h2>
1449
+<div class="outline-text-2" id="text-org4347af5">
1550
 <p>
1450
 <p>
1551
 Everyone except for advertisers hates adverts. Not only are they annoying, but they can consume a lot of bandwidth, be a privacy problem in terms of allowing companies to track your browsing habits and also any badly written scripts they contain may introduce exploitable security holes. Also if you're poor then adverts often make you want things that you can't have.
1451
 Everyone except for advertisers hates adverts. Not only are they annoying, but they can consume a lot of bandwidth, be a privacy problem in terms of allowing companies to track your browsing habits and also any badly written scripts they contain may introduce exploitable security holes. Also if you're poor then adverts often make you want things that you can't have.
1552
 </p>
1452
 </p>
1560
 </p>
1460
 </p>
1561
 </div>
1461
 </div>
1562
 
1462
 
1563
-<div id="outline-container-org8d3d6cd" class="outline-3">
1564
-<h3 id="org8d3d6cd">Set a static IP address</h3>
1565
-<div class="outline-text-3" id="text-org8d3d6cd">
1463
+<div id="outline-container-orgf720b80" class="outline-3">
1464
+<h3 id="orgf720b80">Set a static IP address</h3>
1465
+<div class="outline-text-3" id="text-orgf720b80">
1566
 <p>
1466
 <p>
1567
 Ensure that your system has a static local IP address (typically 192.168..) using the option on the control panel. You will also need to know the IP address of your internet router, which is usually <b>192.168.1.1</b> or <b>192.168.1.254</b>.
1467
 Ensure that your system has a static local IP address (typically 192.168..) using the option on the control panel. You will also need to know the IP address of your internet router, which is usually <b>192.168.1.1</b> or <b>192.168.1.254</b>.
1568
 </p>
1468
 </p>
1573
 </div>
1473
 </div>
1574
 </div>
1474
 </div>
1575
 
1475
 
1576
-<div id="outline-container-orgaad9911" class="outline-3">
1577
-<h3 id="orgaad9911">On each client system within your local network</h3>
1578
-<div class="outline-text-3" id="text-orgaad9911">
1476
+<div id="outline-container-org11b92f7" class="outline-3">
1477
+<h3 id="org11b92f7">On each client system within your local network</h3>
1478
+<div class="outline-text-3" id="text-org11b92f7">
1579
 <div class="org-src-container">
1479
 <div class="org-src-container">
1580
 <pre class="src src-bash">sudo chattr -i /etc/resolv.conf
1480
 <pre class="src src-bash">sudo chattr -i /etc/resolv.conf
1581
 sudo nano /etc/resolv.conf
1481
 sudo nano /etc/resolv.conf
1602
 </div>
1502
 </div>
1603
 </div>
1503
 </div>
1604
 
1504
 
1605
-<div id="outline-container-orgf9075fb" class="outline-3">
1606
-<h3 id="orgf9075fb">On your internet router</h3>
1607
-<div class="outline-text-3" id="text-orgf9075fb">
1505
+<div id="outline-container-org8fc2ddf" class="outline-3">
1506
+<h3 id="org8fc2ddf">On your internet router</h3>
1507
+<div class="outline-text-3" id="text-org8fc2ddf">
1608
 <p>
1508
 <p>
1609
 If you can access the settings on your local internet router then this is the simplest way to provide ad blocking for all devices which connect to it. Unfortunately some router models don't let you edit the DNS settings and if that's the case you might want to consider getting a different router.
1509
 If you can access the settings on your local internet router then this is the simplest way to provide ad blocking for all devices which connect to it. Unfortunately some router models don't let you edit the DNS settings and if that's the case you might want to consider getting a different router.
1610
 </p>
1510
 </p>
1614
 </p>
1514
 </p>
1615
 </div>
1515
 </div>
1616
 
1516
 
1617
-<div id="outline-container-org7a73a0d" class="outline-4">
1618
-<h4 id="org7a73a0d">LibreCMC</h4>
1619
-<div class="outline-text-4" id="text-org7a73a0d">
1517
+<div id="outline-container-orgecad7b2" class="outline-4">
1518
+<h4 id="orgecad7b2">LibreCMC</h4>
1519
+<div class="outline-text-4" id="text-orgecad7b2">
1620
 <p>
1520
 <p>
1621
 On a router running LibreCMC from the <b>Network</b> menu select <b>DHCP and DNS</b>. Enter the static IP address of your Freedombone system within <b>DNS Forwardings</b>, then at the bottom of the page click on <b>Save &amp; Apply</b>. Any devices which connect to your router will now have ad blocking.
1521
 On a router running LibreCMC from the <b>Network</b> menu select <b>DHCP and DNS</b>. Enter the static IP address of your Freedombone system within <b>DNS Forwardings</b>, then at the bottom of the page click on <b>Save &amp; Apply</b>. Any devices which connect to your router will now have ad blocking.
1622
 </p>
1522
 </p>
1624
 </div>
1524
 </div>
1625
 </div>
1525
 </div>
1626
 
1526
 
1627
-<div id="outline-container-org04d2be5" class="outline-3">
1628
-<h3 id="org04d2be5">Configuring block lists</h3>
1629
-<div class="outline-text-3" id="text-org04d2be5">
1527
+<div id="outline-container-org8cc4202" class="outline-3">
1528
+<h3 id="org8cc4202">Configuring block lists</h3>
1529
+<div class="outline-text-3" id="text-org8cc4202">
1630
 <p>
1530
 <p>
1631
 You can configure the block lists which the system uses by going to the <b>administrator control panel</b>, selecting <b>App Settings</b> then choosing <b>pihole</b>. You can also add any extra domain names to the whitelist if they're being wrongly blocked or to the blacklist if they're not blocked by the current lists.
1531
 You can configure the block lists which the system uses by going to the <b>administrator control panel</b>, selecting <b>App Settings</b> then choosing <b>pihole</b>. You can also add any extra domain names to the whitelist if they're being wrongly blocked or to the blacklist if they're not blocked by the current lists.
1632
 </p>
1532
 </p>