free
/
freedombone
Segui 1
Vota 0
Forka 0
Codice Problemi 0 Pull Requests 0 Rilasci 0 Wiki Activity
Sfoglia il codice sorgente

ssh keys

Bob Mottram 10 anni fa
parent
99f21eefe1
commit
f143a83d94
2 ha cambiato i file con 310 aggiunte e 184 eliminazioni
Visualizzazione separata Mostra Diff Stats
  1. 30
    0
      usage.org
  2. 280
    184
      website/usage.html

+ 30
- 0
usage.org Vedi File 

@@ -21,6 +21,36 @@ emacs ~/README
21 21 
 You should transfer any passwords to a password manager such as [[http://www.keepassx.org/][KeepassX]] and then delete them from the README file. To save the file after removing passwords use *CTRL-x CTRL-s*.
22 22
23 23 
 To exit you can either just close the terminal or use *CTRL-x CTRL-c* followed by the *exit* command.
24 
+* Improving ssh security
25 
+To improve ssh security you can generate an ssh key pair on your system and then upload the public key to the Freedombone.
26 
+
27 
+On your local machine:
28 
+
29 
+#+BEGIN_SRC bash
30 
+ssh-keygen
31 
+#+END_SRC
32 
+
33 
+For extra security you may also want to add a passphrase to the ssh private key. You can show the generated public key with:
34 
+
35 
+#+BEGIN_SRC bash
36 
+cat ~/.ssh/id_rsa.pub
37 
+#+END_SRC
38 
+
39 
+Copy the contents of *~/.ssh/id_rsa* and *~/.ssh/id_rsa.pub* to you password manager, together with the private key password if you created one.
40 
+
41 
+ssh to the Freedombone and edit the authorized keys:
42 
+
43 
+#+BEGIN_SRC bash
44 
+ssh username@domain -p 2222
45 
+emacs ~/.ssh/authorized_keys
46 
+#+END_SRC
47 
+
48 
+Now copy and paste the contents of *id_rsa.pub* into the authorized_keys file. Save the file and exit. Open another terminal window and try logging in again and you should notice that you are no longer asked for a password, because the ssh key is used instead.
49 
+
50 
+There are advantages and disadvantages to using ssh keys for logins. The advantage is that this is much more secure than a memorised password, but the disadvantage is that you need to carry your ssh keys around and be able to install them on any computer of mobile device that you use. In high security or hostile infosec environments it may not be possible to carry or use USB thumb drives containing your keys and so memorised passwords may be the only available choice.
51 
+
52 
+If you wish to only use ssh keys then log in to the Freedombone and edit */etc/ssh/sshd_config*, then change *PasswordAuthentication* to "no", save and run *service ssh restart*. Any subsequent attempts to log in via a password will then be denied.
53 
+
24 54 
 * Using Email
25 55 
 ** A technical note about email transport security
26 56 
 Port 465 is used for SMTP and this is supposedly deprecated for secure email. However, using TLS from the start of the communications seems far more secure than starting off with insecure communications and then trying to upgrade it with a command to begin TLS, as happens with STARTTLS. There are [[https://www.eff.org/deeplinks/2014/11/starttls-downgrade-attacks][possible attacks against STARTTLS]] in which the command to begin secure communications is removed or overwritten which could then result in email being transferred in plain text over the internet and be readable by third parties.

+ 280
- 184
website/usage.html Vedi File 

@@ -4,7 +4,7 @@
4 4 
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5 5 
 <head>
6 6 
 <title></title>
7 
-<!-- 2014-11-11 Tue 21:13 -->
7 
+<!-- 2014-12-08 Mon 15:20 -->
8 8 
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
9 9 
 <meta  name="generator" content="Org-mode" />
10 10 
 <meta  name="author" content="Bob Mottram" />
 
@@ -91,10 +91,6 @@
91 91 
     { background-color: #ffff00; color: #000000; font-weight: bold; }
92 92 
   /*]]>*/-->
93 93 
 </style>
94 
-<link rel="stylesheet" type="text/css"
95 
-href="http://sachachua.com/blog/wp-content/themes/sacha-v3/foundation/css/foundation.min.css"></link>
96 
-<link rel="stylesheet" type="text/css" href="http://sachachua.com/org-export.css"></link>
97 
-<link rel="stylesheet" type="text/css" href="http://sachachua.com/blog/wp-content/themes/sacha-v3/style.css"></link>
98 94 
 <script type="text/javascript">
99 95 
 /*
100 96 
 @licstart  The following is the entire license notice for the
 
@@ -143,11 +139,85 @@ for the JavaScript code in this tag.
143 139 
 </script>
144 140 
 </head>
145 141 
 <body>
146 
-<div id="preamble" class="status">
147 
-<a name="top" id="top"></a>
148 
-</div>
149 142 
 <div id="content">
150 143 
 <h1 class="title"></h1>
144 
+<div id="table-of-contents">
145 
+<h2>Table of Contents</h2>
146 
+<div id="text-table-of-contents">
147 
+<ul>
148 
+<li><a href="#sec-1">1. Readme</a></li>
149 
+<li><a href="#sec-2">2. Improving ssh security</a></li>
150 
+<li><a href="#sec-3">3. Using Email</a>
151 
+<ul>
152 
+<li><a href="#sec-3-1">3.1. A technical note about email transport security</a></li>
153 
+<li><a href="#sec-3-2">3.2. Add a password to your GPG key</a></li>
154 
+<li><a href="#sec-3-3">3.3. Publishing your GPG public key</a></li>
155 
+<li><a href="#sec-3-4">3.4. Mutt email client</a></li>
156 
+<li><a href="#sec-3-5">3.5. Thunderbird</a>
157 
+<ul>
158 
+<li><a href="#sec-3-5-1">3.5.1. Initial setup</a></li>
159 
+<li><a href="#sec-3-5-2">3.5.2. Import your GPG keys</a></li>
160 
+<li><a href="#sec-3-5-3">3.5.3. Using for the first time</a></li>
161 
+<li><a href="#sec-3-5-4">3.5.4. Making folders visible</a></li>
162 
+</ul>
163 
+</li>
164 
+<li><a href="#sec-3-6">3.6. K9 Android client</a>
165 
+<ul>
166 
+<li><a href="#sec-3-6-1">3.6.1. Incoming server settings</a></li>
167 
+<li><a href="#sec-3-6-2">3.6.2. Outgoing (SMTP) server settings</a></li>
168 
+<li><a href="#sec-3-6-3">3.6.3. Folders</a></li>
169 
+</ul>
170 
+</li>
171 
+<li><a href="#sec-3-7">3.7. Subscribing to mailing lists</a></li>
172 
+<li><a href="#sec-3-8">3.8. Adding email addresses to a group/folder</a></li>
173 
+</ul>
174 
+</li>
175 
+<li><a href="#sec-4">4. Mailing List</a></li>
176 
+<li><a href="#sec-5">5. Syncing to the Cloud</a>
177 
+<ul>
178 
+<li><a href="#sec-5-1">5.1. Initial install</a></li>
179 
+<li><a href="#sec-5-2">5.2. On Android</a></li>
180 
+<li><a href="#sec-5-3">5.3. On Linux</a></li>
181 
+</ul>
182 
+</li>
183 
+<li><a href="#sec-6">6. Play Music</a>
184 
+<ul>
185 
+<li><a href="#sec-6-1">6.1. With the DLNA service</a></li>
186 
+<li><a href="#sec-6-2">6.2. With Owncloud</a></li>
187 
+</ul>
188 
+</li>
189 
+<li><a href="#sec-7">7. Microblogging</a>
190 
+<ul>
191 
+<li><a href="#sec-7-1">7.1. Initial configuration</a></li>
192 
+</ul>
193 
+</li>
194 
+<li><a href="#sec-8">8. Social Network</a>
195 
+<ul>
196 
+<li><a href="#sec-8-1">8.1. Certificates</a></li>
197 
+<li><a href="#sec-8-2">8.2. Initial install</a></li>
198 
+</ul>
199 
+</li>
200 
+<li><a href="#sec-9">9. Chat Services</a>
201 
+<ul>
202 
+<li><a href="#sec-9-1">9.1. IRC</a>
203 
+<ul>
204 
+<li><a href="#sec-9-1-1">9.1.1. Irssi</a></li>
205 
+<li><a href="#sec-9-1-2">9.1.2. XChat</a></li>
206 
+</ul>
207 
+</li>
208 
+<li><a href="#sec-9-2">9.2. XMPP/Jabber</a>
209 
+<ul>
210 
+<li><a href="#sec-9-2-1">9.2.1. Managing users</a></li>
211 
+<li><a href="#sec-9-2-2">9.2.2. Using with Jitsi</a></li>
212 
+<li><a href="#sec-9-2-3">9.2.3. Using with Ubuntu</a></li>
213 
+<li><a href="#sec-9-2-4">9.2.4. Using with Android</a></li>
214 
+</ul>
215 
+</li>
216 
+</ul>
217 
+</li>
218 
+</ul>
219 
+</div>
220 
+</div>
151 221 
 <div class="center">
152 222
153 223 
 <div class="figure">
 
@@ -181,21 +251,21 @@ for the JavaScript code in this tag.
181 251 
 <tbody>
182 252 
 <tr>
183 253 
 <td class="left"><a href="index.html">Home</a></td>
184 
-<td class="left"><a href="#unnumbered-1">Readme</a></td>
185 
-<td class="left"><a href="#unnumbered-2">Using Email</a></td>
186 
-<td class="left"><a href="#unnumbered-18">Mailing List</a></td>
187 
-<td class="left"><a href="#unnumbered-19">Syncing to the Cloud</a></td>
188 
-<td class="left"><a href="#unnumbered-23">Play Music</a></td>
189 
-<td class="left"><a href="#unnumbered-26">Microblogging</a></td>
190 
-<td class="left"><a href="#unnumbered-28">Social Network</a></td>
191 
-<td class="left"><a href="#unnumbered-31">Chat Services</a></td>
254 
+<td class="left"><a href="#sec-1">1</a></td>
255 
+<td class="left"><a href="#sec-3">3</a></td>
256 
+<td class="left"><a href="#sec-4">4</a></td>
257 
+<td class="left"><a href="#sec-5">5</a></td>
258 
+<td class="left"><a href="#sec-6">6</a></td>
259 
+<td class="left"><a href="#sec-7">7</a></td>
260 
+<td class="left"><a href="#sec-8">8</a></td>
261 
+<td class="left"><a href="#sec-9">9</a></td>
192 262 
 </tr>
193 263 
 </tbody>
194 264 
 </table>
195 265
196 
-<div id="outline-container-unnumbered-1" class="outline-2">
197 
-<h2 id="unnumbered-1">Readme</h2>
198 
-<div class="outline-text-2" id="text-unnumbered-1">
266 
+<div id="outline-container-sec-1" class="outline-2">
267 
+<h2 id="sec-1"><span class="section-number-2">1</span> Readme</h2>
268 
+<div class="outline-text-2" id="text-1">
199 269 
 <p>
200 270 
 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:
201 271 
 </p>
 
@@ -216,20 +286,76 @@ To exit you can either just close the terminal or use <b>CTRL-x CTRL-c</b> follo
216 286 
 </p>
217 287 
 </div>
218 288 
 </div>
219 
-<div id="outline-container-unnumbered-2" class="outline-2">
220 
-<h2 id="unnumbered-2">Using Email</h2>
221 
-<div class="outline-text-2" id="text-unnumbered-2">
222 
-</div><div id="outline-container-unnumbered-3" class="outline-3">
223 
-<h3 id="unnumbered-3">A technical note about email transport security</h3>
224 
-<div class="outline-text-3" id="text-unnumbered-3">
289 
+<div id="outline-container-sec-2" class="outline-2">
290 
+<h2 id="sec-2"><span class="section-number-2">2</span> Improving ssh security</h2>
291 
+<div class="outline-text-2" id="text-2">
292 
+<p>
293 
+To improve ssh security you can generate an ssh key pair on your system and then upload the public key to the Freedombone.
294 
+</p>
295 
+
296 
+<p>
297 
+On your local machine:
298 
+</p>
299 
+
300 
+<div class="org-src-container">
301 
+
302 
+<pre class="src src-bash">ssh-keygen
303 
+</pre>
304 
+</div>
305 
+
306 
+<p>
307 
+For extra security you may also want to add a passphrase to the ssh private key. You can show the generated public key with:
308 
+</p>
309 
+
310 
+<div class="org-src-container">
311 
+
312 
+<pre class="src src-bash">cat ~/.ssh/id_rsa.pub
313 
+</pre>
314 
+</div>
315 
+
316 
+<p>
317 
+Copy the contents of <b>~/.ssh/id_rsa</b> and <b>~/.ssh/id_rsa.pub</b> to you password manager, together with the private key password if you created one.
318 
+</p>
319 
+
320 
+<p>
321 
+ssh to the Freedombone and edit the authorized keys:
322 
+</p>
323 
+
324 
+<div class="org-src-container">
325 
+
326 
+<pre class="src src-bash">ssh username@domain -p 2222
327 
+emacs ~/.ssh/authorized_keys
328 
+</pre>
329 
+</div>
330 
+
331 
+<p>
332 
+Now copy and paste the contents of <b>id_rsa.pub</b> into the authorized_keys file. Save the file and exit. Open another terminal window and try logging in again and you should notice that you are no longer asked for a password, because the ssh key is used instead.
333 
+</p>
334 
+
335 
+<p>
336 
+There are advantages and disadvantages to using ssh keys for logins. The advantage is that this is much more secure than a memorised password, but the disadvantage is that you need to carry your ssh keys around and be able to install them on any computer of mobile device that you use. In high security or hostile infosec environments it may not be possible to carry or use USB thumb drives containing your keys and so memorised passwords may be the only available choice.
337 
+</p>
338 
+
339 
+<p>
340 
+If you wish to only use ssh keys then log in to the Freedombone and edit <b>/etc/ssh/sshd_config</b>, then change <b>PasswordAuthentication</b> to "no", save and run <b>service ssh restart</b>. Any subsequent attempts to log in via a password will then be denied.
341 
+</p>
342 
+</div>
343 
+</div>
344 
+
345 
+<div id="outline-container-sec-3" class="outline-2">
346 
+<h2 id="sec-3"><span class="section-number-2">3</span> Using Email</h2>
347 
+<div class="outline-text-2" id="text-3">
348 
+</div><div id="outline-container-sec-3-1" class="outline-3">
349 
+<h3 id="sec-3-1"><span class="section-number-3">3.1</span> A technical note about email transport security</h3>
350 
+<div class="outline-text-3" id="text-3-1">
225 351 
 <p>
226 352 
 Port 465 is used for SMTP and this is supposedly deprecated for secure email. However, using TLS from the start of the communications seems far more secure than starting off with insecure communications and then trying to upgrade it with a command to begin TLS, as happens with STARTTLS. There are <a href="https://www.eff.org/deeplinks/2014/11/starttls-downgrade-attacks">possible attacks against STARTTLS</a> in which the command to begin secure communications is removed or overwritten which could then result in email being transferred in plain text over the internet and be readable by third parties.
227 353 
 </p>
228 354 
 </div>
229 355 
 </div>
230 
-<div id="outline-container-unnumbered-4" class="outline-3">
231 
-<h3 id="unnumbered-4">Add a password to your GPG key</h3>
232 
-<div class="outline-text-3" id="text-unnumbered-4">
356 
+<div id="outline-container-sec-3-2" class="outline-3">
357 
+<h3 id="sec-3-2"><span class="section-number-3">3.2</span> Add a password to your GPG key</h3>
358 
+<div class="outline-text-3" id="text-3-2">
233 359 
 <p>
234 360 
 If you didn't use existing GPG keys during the Freedombone installation then you'll need to add a password to your newly generated private key. This is highly recommended. Go through the following sequence of commands to ssh into the Freedombone and then change your GPG password.
235 361 
 </p>
 
@@ -241,7 +367,7 @@ gpg --edit-key username@domain
241 367 
 passwd
242 368 
 save
243 369 
 quit
244 
-<span class="org-keyword">exit</span>
370 
+exit
245 371 
 </pre>
246 372 
 </div>
247 373 
 
@@ -251,9 +377,9 @@ Having a password on your GPG key will prevent someone from reading your email <
251 377 
 </div>
252 378 
 </div>
253 379
254 
-<div id="outline-container-unnumbered-5" class="outline-3">
255 
-<h3 id="unnumbered-5">Publishing your GPG public key</h3>
256 
-<div class="outline-text-3" id="text-unnumbered-5">
380 
+<div id="outline-container-sec-3-3" class="outline-3">
381 
+<h3 id="sec-3-3"><span class="section-number-3">3.3</span> Publishing your GPG public key</h3>
382 
+<div class="outline-text-3" id="text-3-3">
257 383 
 <p>
258 384 
 If you havn't already then you should publish your GPG public key so that others can find it.
259 385 
 </p>
 
@@ -262,14 +388,14 @@ If you havn't already then you should publish your GPG public key so that others
262 388
263 389 
 <pre class="src src-bash">ssh username@domainname -p 2222
264 390 
 gpg --send-keys username@domainname
265 
-<span class="org-keyword">exit</span>
391 
+exit
266 392 
 </pre>
267 393 
 </div>
268 394 
 </div>
269 395 
 </div>
270 
-<div id="outline-container-unnumbered-6" class="outline-3">
271 
-<h3 id="unnumbered-6">Mutt email client</h3>
272 
-<div class="outline-text-3" id="text-unnumbered-6">
396 
+<div id="outline-container-sec-3-4" class="outline-3">
397 
+<h3 id="sec-3-4"><span class="section-number-3">3.4</span> Mutt email client</h3>
398 
+<div class="outline-text-3" id="text-3-4">
273 399 
 <p>
274 400 
 Mutt is a terminal based email client which comes already installed onto the Freedombone. To access it you'll need to access it via ssh with:
275 401 
 </p>
 
@@ -412,9 +538,9 @@ When reading emails you will initially need to enter your GPG password. It will
412 538 
 </div>
413 539 
 </div>
414 540
415 
-<div id="outline-container-unnumbered-7" class="outline-3">
416 
-<h3 id="unnumbered-7">Thunderbird</h3>
417 
-<div class="outline-text-3" id="text-unnumbered-7">
541 
+<div id="outline-container-sec-3-5" class="outline-3">
542 
+<h3 id="sec-3-5"><span class="section-number-3">3.5</span> Thunderbird</h3>
543 
+<div class="outline-text-3" id="text-3-5">
418 544 
 <p>
419 545 
 Another common way in which you may want to access email is via Thunderbird.  This may be especially useful if you're trying to convert former Windows users who may previously have been using some version of Outlook.
420 546 
 </p>
 
@@ -424,9 +550,9 @@ The following instructions should be carried out on the client machines (laptop,
424 550 
 </p>
425 551 
 </div>
426 552
427 
-<div id="outline-container-unnumbered-8" class="outline-4">
428 
-<h4 id="unnumbered-8">Initial setup</h4>
429 
-<div class="outline-text-4" id="text-unnumbered-8">
553 
+<div id="outline-container-sec-3-5-1" class="outline-4">
554 
+<h4 id="sec-3-5-1"><span class="section-number-4">3.5.1</span> Initial setup</h4>
555 
+<div class="outline-text-4" id="text-3-5-1">
430 556 
 <p>
431 557 
 Install <b>Thunderbird</b> and <b>Enigmail</b>.  How you do this just depends upon your distro and software manager or "app store".
432 558 
 </p>
 
@@ -485,9 +611,9 @@ Select "<b>yes</b>" to change default settings.
485 611 
 </p>
486 612 
 </div>
487 613 
 </div>
488 
-<div id="outline-container-unnumbered-9" class="outline-4">
489 
-<h4 id="unnumbered-9">Import your GPG keys</h4>
490 
-<div class="outline-text-4" id="text-unnumbered-9">
614 
+<div id="outline-container-sec-3-5-2" class="outline-4">
615 
+<h4 id="sec-3-5-2"><span class="section-number-4">3.5.2</span> Import your GPG keys</h4>
616 
+<div class="outline-text-4" id="text-3-5-2">
491 617 
 <p>
492 618 
 On the Freedombone export your GPG public and private keys.
493 619 
 </p>
 
@@ -536,9 +662,9 @@ shred -zu ~/private_key.gpg
536 662 
 </div>
537 663 
 </div>
538 664
539 
-<div id="outline-container-unnumbered-10" class="outline-4">
540 
-<h4 id="unnumbered-10">Using for the first time</h4>
541 
-<div class="outline-text-4" id="text-unnumbered-10">
665 
+<div id="outline-container-sec-3-5-3" class="outline-4">
666 
+<h4 id="sec-3-5-3"><span class="section-number-4">3.5.3</span> Using for the first time</h4>
667 
+<div class="outline-text-4" id="text-3-5-3">
542 668 
 <p>
543 669 
 Click on the Thunderbird menu, which looks like three horizontal bars on the right hand side.
544 670 
 </p>
 
@@ -573,9 +699,9 @@ Get into the habit of using email encryption and encourage others to do so.  Rem
573 699 
 </div>
574 700 
 </div>
575 701
576 
-<div id="outline-container-unnumbered-11" class="outline-4">
577 
-<h4 id="unnumbered-11">Making folders visible</h4>
578 
-<div class="outline-text-4" id="text-unnumbered-11">
702 
+<div id="outline-container-sec-3-5-4" class="outline-4">
703 
+<h4 id="sec-3-5-4"><span class="section-number-4">3.5.4</span> Making folders visible</h4>
704 
+<div class="outline-text-4" id="text-3-5-4">
579 705 
 <p>
580 706 
 By default you won't be able to see any folders which you may have created earlier using the <i>mailinglistrule</i> script.  To make folders visible select:
581 707 
 </p>
 
@@ -591,17 +717,17 @@ Make sure that "<b>show only subscribed folders</b>" is not checked.  Then click
591 717 
 </div>
592 718 
 </div>
593 719
594 
-<div id="outline-container-unnumbered-12" class="outline-3">
595 
-<h3 id="unnumbered-12">K9 Android client</h3>
596 
-<div class="outline-text-3" id="text-unnumbered-12">
720 
+<div id="outline-container-sec-3-6" class="outline-3">
721 
+<h3 id="sec-3-6"><span class="section-number-3">3.6</span> K9 Android client</h3>
722 
+<div class="outline-text-3" id="text-3-6">
597 723 
 <p>
598 724 
 <b>NOTE</b>: Currently the K9 email client will not work with the Freedombone since it doesn't support PGP/MIME encoding. However, there is development work taking place on that feature and it is hoped that K9 may be usable in the near future.
599 725 
 </p>
600 726 
 </div>
601 727
602 
-<div id="outline-container-unnumbered-13" class="outline-4">
603 
-<h4 id="unnumbered-13">Incoming server settings</h4>
604 
-<div class="outline-text-4" id="text-unnumbered-13">
728 
+<div id="outline-container-sec-3-6-1" class="outline-4">
729 
+<h4 id="sec-3-6-1"><span class="section-number-4">3.6.1</span> Incoming server settings</h4>
730 
+<div class="outline-text-4" id="text-3-6-1">
605 731 
 <ul class="org-ul">
606 732 
 <li>Select settings/account settings
607 733 
 </li>
 
@@ -620,9 +746,9 @@ Make sure that "<b>show only subscribed folders</b>" is not checked.  Then click
620 746 
 </ul>
621 747 
 </div>
622 748 
 </div>
623 
-<div id="outline-container-unnumbered-14" class="outline-4">
624 
-<h4 id="unnumbered-14">Outgoing (SMTP) server settings</h4>
625 
-<div class="outline-text-4" id="text-unnumbered-14">
749 
+<div id="outline-container-sec-3-6-2" class="outline-4">
750 
+<h4 id="sec-3-6-2"><span class="section-number-4">3.6.2</span> Outgoing (SMTP) server settings</h4>
751 
+<div class="outline-text-4" id="text-3-6-2">
626 752 
 <ul class="org-ul">
627 753 
 <li>Select settings/account settings
628 754 
 </li>
 
@@ -643,9 +769,9 @@ Make sure that "<b>show only subscribed folders</b>" is not checked.  Then click
643 769 
 </ul>
644 770 
 </div>
645 771 
 </div>
646 
-<div id="outline-container-unnumbered-15" class="outline-4">
647 
-<h4 id="unnumbered-15">Folders</h4>
648 
-<div class="outline-text-4" id="text-unnumbered-15">
772 
+<div id="outline-container-sec-3-6-3" class="outline-4">
773 
+<h4 id="sec-3-6-3"><span class="section-number-4">3.6.3</span> Folders</h4>
774 
+<div class="outline-text-4" id="text-3-6-3">
649 775 
 <p>
650 776 
 To view any new folders which you may have created using the <i>mailinglistrule</i> script from your inbox press the <b>K9 icon</b> at the top left to access folders, then press the <b>menu button</b> and select <b>refresh folder list</b>.
651 777 
 </p>
 
@@ -657,9 +783,9 @@ If your folder still doesn't show up then press the <b>menu button</b>, select <
657 783 
 </div>
658 784 
 </div>
659 785
660 
-<div id="outline-container-unnumbered-16" class="outline-3">
661 
-<h3 id="unnumbered-16">Subscribing to mailing lists</h3>
662 
-<div class="outline-text-3" id="text-unnumbered-16">
786 
+<div id="outline-container-sec-3-7" class="outline-3">
787 
+<h3 id="sec-3-7"><span class="section-number-3">3.7</span> Subscribing to mailing lists</h3>
788 
+<div class="outline-text-3" id="text-3-7">
663 789 
 <p>
664 790 
 To subscribe to a mailing list so that it appears within Mutt or Thunderbird.
665 791 
 </p>
 
@@ -668,7 +794,7 @@ To subscribe to a mailing list so that it appears within Mutt or Thunderbird.
668 794
669 795 
 <pre class="src src-bash">ssh username@domainname -p 2222
670 796 
 addmailinglist &lt;username&gt; &lt;mailinglistname&gt; &lt;subjecttag&gt;
671 
-<span class="org-keyword">exit</span>
797 
+exit
672 798 
 </pre>
673 799 
 </div>
674 800 
 
@@ -677,9 +803,9 @@ The subject tag should be the word or phrase which appears within the brackets i
677 803 
 </p>
678 804 
 </div>
679 805 
 </div>
680 
-<div id="outline-container-unnumbered-17" class="outline-3">
681 
-<h3 id="unnumbered-17">Adding email addresses to a group/folder</h3>
682 
-<div class="outline-text-3" id="text-unnumbered-17">
806 
+<div id="outline-container-sec-3-8" class="outline-3">
807 
+<h3 id="sec-3-8"><span class="section-number-3">3.8</span> Adding email addresses to a group/folder</h3>
808 
+<div class="outline-text-3" id="text-3-8">
683 809 
 <p>
684 810 
 Similar to adding mailing list folders you can also add specified email addresses into a folder.
685 811 
 </p>
 
@@ -688,7 +814,7 @@ Similar to adding mailing list folders you can also add specified email addresse
688 814
689 815 
 <pre class="src src-bash">ssh username@domainname -p 2222
690 816 
 addemailtofolder &lt;username&gt; &lt;emailaddress&gt; &lt;mailinglistname&gt;
691 
-<span class="org-keyword">exit</span>
817 
+exit
692 818 
 </pre>
693 819 
 </div>
694 820 
 
@@ -699,9 +825,9 @@ The mailing list name should be something short so that it is readable within th
699 825 
 </div>
700 826 
 </div>
701 827
702 
-<div id="outline-container-unnumbered-18" class="outline-2">
703 
-<h2 id="unnumbered-18">Mailing List</h2>
704 
-<div class="outline-text-2" id="text-unnumbered-18">
828 
+<div id="outline-container-sec-4" class="outline-2">
829 
+<h2 id="sec-4"><span class="section-number-2">4</span> Mailing List</h2>
830 
+<div class="outline-text-2" id="text-4">
705 831 
 <p>
706 832 
 If you want to set up a public mailing list then when installing the system remember to set the <b>PUBLIC_MAILING_LIST</b> variable within <b>freedombone.cfg</b> to the name of your list. The name should have no spaces in it. Public mailing lists are unencrypted so anyone will be able to read the contents, including non subscribers.
707 833 
 </p>
 
@@ -721,12 +847,12 @@ Tip: When using the Mutt email client if you want to send an email in cleartext
721 847 
 </p>
722 848 
 </div>
723 849 
 </div>
724 
-<div id="outline-container-unnumbered-19" class="outline-2">
725 
-<h2 id="unnumbered-19">Syncing to the Cloud</h2>
726 
-<div class="outline-text-2" id="text-unnumbered-19">
727 
-</div><div id="outline-container-unnumbered-20" class="outline-3">
728 
-<h3 id="unnumbered-20">Initial install</h3>
729 
-<div class="outline-text-3" id="text-unnumbered-20">
850 
+<div id="outline-container-sec-5" class="outline-2">
851 
+<h2 id="sec-5"><span class="section-number-2">5</span> Syncing to the Cloud</h2>
852 
+<div class="outline-text-2" id="text-5">
853 
+</div><div id="outline-container-sec-5-1" class="outline-3">
854 
+<h3 id="sec-5-1"><span class="section-number-3">5.1</span> Initial install</h3>
855 
+<div class="outline-text-3" id="text-5-1">
730 856 
 <p>
731 857 
 Within a browser go to your owncloud domain, then create an administrator account. The username and password can be anything, and ideally should be generated from a password manager.
732 858 
 </p>
 
@@ -751,7 +877,7 @@ You will also need to enter database details:
751 877
752 878 
 <tr>
753 879 
 <td class="left">Owncloud database password</td>
754 
-<td class="left">See the <a href="#unnumbered-1">Readme</a> file</td>
880 
+<td class="left">See the <a href="#sec-1">1</a> file</td>
755 881 
 </tr>
756 882
757 883 
 <tr>
 
@@ -770,9 +896,9 @@ Log out from the administrator account and then log back in as the user you just
770 896 
 </p>
771 897 
 </div>
772 898 
 </div>
773 
-<div id="outline-container-unnumbered-21" class="outline-3">
774 
-<h3 id="unnumbered-21">On Android</h3>
775 
-<div class="outline-text-3" id="text-unnumbered-21">
899 
+<div id="outline-container-sec-5-2" class="outline-3">
900 
+<h3 id="sec-5-2"><span class="section-number-3">5.2</span> On Android</h3>
901 
+<div class="outline-text-3" id="text-5-2">
776 902 
 <p>
777 903 
 Within F-droid search for <b>owncloud</b> and install the client. Also install <b>CalDAV Sync Adapter</b>.
778 904 
 </p>
 
@@ -796,9 +922,9 @@ You will also be prompted to enter login details. Your Android and Owncloud cale
796 922 
 </p>
797 923 
 </div>
798 924 
 </div>
799 
-<div id="outline-container-unnumbered-22" class="outline-3">
800 
-<h3 id="unnumbered-22">On Linux</h3>
801 
-<div class="outline-text-3" id="text-unnumbered-22">
925 
+<div id="outline-container-sec-5-3" class="outline-3">
926 
+<h3 id="sec-5-3"><span class="section-number-3">5.3</span> On Linux</h3>
927 
+<div class="outline-text-3" id="text-5-3">
802 928 
 <p>
803 929 
 Open your software center and search for "owncloud client". Enter your owncloud domain name (with the https prefix) and login details.
804 930 
 </p>
 
@@ -809,12 +935,12 @@ You can now drag files into the <b>~/owncloud</b> directory and they will automa
809 935 
 </div>
810 936 
 </div>
811 937 
 </div>
812 
-<div id="outline-container-unnumbered-23" class="outline-2">
813 
-<h2 id="unnumbered-23">Play Music</h2>
814 
-<div class="outline-text-2" id="text-unnumbered-23">
815 
-</div><div id="outline-container-unnumbered-24" class="outline-3">
816 
-<h3 id="unnumbered-24">With the DLNA service</h3>
817 
-<div class="outline-text-3" id="text-unnumbered-24">
938 
+<div id="outline-container-sec-6" class="outline-2">
939 
+<h2 id="sec-6"><span class="section-number-2">6</span> Play Music</h2>
940 
+<div class="outline-text-2" id="text-6">
941 
+</div><div id="outline-container-sec-6-1" class="outline-3">
942 
+<h3 id="sec-6-1"><span class="section-number-3">6.1</span> With the DLNA service</h3>
943 
+<div class="outline-text-3" id="text-6-1">
818 944 
 <p>
819 945 
 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.
820 946 
 </p>
 
@@ -854,9 +980,9 @@ The DLNA service will only work within your local home network, and isn't remote
854 980 
 </div>
855 981 
 </div>
856 982
857 
-<div id="outline-container-unnumbered-25" class="outline-3">
858 
-<h3 id="unnumbered-25">With Owncloud</h3>
859 
-<div class="outline-text-3" id="text-unnumbered-25">
983 
+<div id="outline-container-sec-6-2" class="outline-3">
984 
+<h3 id="sec-6-2"><span class="section-number-3">6.2</span> With Owncloud</h3>
985 
+<div class="outline-text-3" id="text-6-2">
860 986 
 <p>
861 987 
 The main advantage of playing music via Owncloud is that you can do that from anywhere - not only within your home network.
862 988 
 </p>
 
@@ -868,12 +994,12 @@ By default a music player is installed into Owncloud, so all you need to do is t
868 994 
 </div>
869 995 
 </div>
870 996
871 
-<div id="outline-container-unnumbered-26" class="outline-2">
872 
-<h2 id="unnumbered-26">Microblogging</h2>
873 
-<div class="outline-text-2" id="text-unnumbered-26">
874 
-</div><div id="outline-container-unnumbered-27" class="outline-3">
875 
-<h3 id="unnumbered-27">Initial configuration</h3>
876 
-<div class="outline-text-3" id="text-unnumbered-27">
997 
+<div id="outline-container-sec-7" class="outline-2">
998 
+<h2 id="sec-7"><span class="section-number-2">7</span> Microblogging</h2>
999 
+<div class="outline-text-2" id="text-7">
1000 
+</div><div id="outline-container-sec-7-1" class="outline-3">
1001 
+<h3 id="sec-7-1"><span class="section-number-3">7.1</span> Initial configuration</h3>
1002 
+<div class="outline-text-3" id="text-7-1">
877 1003 
 <p>
878 1004 
 To set up your microblog go to:
879 1005 
 </p>
 
@@ -924,7 +1050,7 @@ and enter the following settings:
924 1050
925 1051 
 <tr>
926 1052 
 <td class="left">DB Password</td>
927 
-<td class="left">See the MariaDB password in the <a href="#unnumbered-1">Readme</a> file</td>
1053 
+<td class="left">See the MariaDB password in the <a href="#sec-1">1</a> file</td>
928 1054 
 </tr>
929 1055
930 1056 
 <tr>
 
@@ -934,7 +1060,7 @@ and enter the following settings:
934 1060
935 1061 
 <tr>
936 1062 
 <td class="left">Administrator password</td>
937 
-<td class="left">See the <a href="#unnumbered-1">Readme</a> file</td>
1063 
+<td class="left">See the <a href="#sec-1">1</a> file</td>
938 1064 
 </tr>
939 1065
940 1066 
 <tr>
 
@@ -981,12 +1107,12 @@ When the install is complete you will see a lot of warnings but just ignore thos
981 1107 
 </div>
982 1108 
 </div>
983 1109 
 </div>
984 
-<div id="outline-container-unnumbered-28" class="outline-2">
985 
-<h2 id="unnumbered-28">Social Network</h2>
986 
-<div class="outline-text-2" id="text-unnumbered-28">
987 
-</div><div id="outline-container-unnumbered-29" class="outline-3">
988 
-<h3 id="unnumbered-29">Certificates</h3>
989 
-<div class="outline-text-3" id="text-unnumbered-29">
1110 
+<div id="outline-container-sec-8" class="outline-2">
1111 
+<h2 id="sec-8"><span class="section-number-2">8</span> Social Network</h2>
1112 
+<div class="outline-text-2" id="text-8">
1113 
+</div><div id="outline-container-sec-8-1" class="outline-3">
1114 
+<h3 id="sec-8-1"><span class="section-number-3">8.1</span> Certificates</h3>
1115 
+<div class="outline-text-3" id="text-8-1">
990 1116 
 <p>
991 1117 
 You will need to have a non self-signed SSL certificate in order to use Red Matrix. Put the public certificate in <b>/etc/ssl/certs/yourredmatrixdomainname.crt</b> and the private certificate in <b>/etc/ssl/private/yourredmatrixdomainname.key</b>. If there is an intermediate certificate needed (such as with StartSSL) then this will need to be concatenated onto the end of the crt file, like this:
992 1118 
 </p>
 
@@ -1003,9 +1129,9 @@ Then change ssl_certificate to <b>/etc/ssl/certs/yourredmatrixdomainname.bundle.
1003 1129 
 </p>
1004 1130 
 </div>
1005 1131 
 </div>
1006 
-<div id="outline-container-unnumbered-30" class="outline-3">
1007 
-<h3 id="unnumbered-30">Initial install</h3>
1008 
-<div class="outline-text-3" id="text-unnumbered-30">
1132 
+<div id="outline-container-sec-8-2" class="outline-3">
1133 
+<h3 id="sec-8-2"><span class="section-number-3">8.2</span> Initial install</h3>
1134 
+<div class="outline-text-3" id="text-8-2">
1009 1135 
 <p>
1010 1136 
 Visit the URL of your Red Matrix site and you should be taken through the rest of the installation procedure.  Note that this may take a few minutes so don't be concerned if it looks as if it has crashed - just leave it running.
1011 1137 
 </p>
 
@@ -1016,21 +1142,21 @@ When installation is complete you can register a new user.
1016 1142 
 </div>
1017 1143 
 </div>
1018 1144 
 </div>
1019 
-<div id="outline-container-unnumbered-31" class="outline-2">
1020 
-<h2 id="unnumbered-31">Chat Services</h2>
1021 
-<div class="outline-text-2" id="text-unnumbered-31">
1022 
-</div><div id="outline-container-unnumbered-32" class="outline-3">
1023 
-<h3 id="unnumbered-32">IRC</h3>
1024 
-<div class="outline-text-3" id="text-unnumbered-32">
1145 
+<div id="outline-container-sec-9" class="outline-2">
1146 
+<h2 id="sec-9"><span class="section-number-2">9</span> Chat Services</h2>
1147 
+<div class="outline-text-2" id="text-9">
1148 
+</div><div id="outline-container-sec-9-1" class="outline-3">
1149 
+<h3 id="sec-9-1"><span class="section-number-3">9.1</span> IRC</h3>
1150 
+<div class="outline-text-3" id="text-9-1">
1025 1151 
 <p>
1026 1152 
 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.
1027 1153 
 </p>
1028 1154 
 </div>
1029 
-<div id="outline-container-unnumbered-33" class="outline-4">
1030 
-<h4 id="unnumbered-33">Irssi</h4>
1031 
-<div class="outline-text-4" id="text-unnumbered-33">
1155 
+<div id="outline-container-sec-9-1-1" class="outline-4">
1156 
+<h4 id="sec-9-1-1"><span class="section-number-4">9.1.1</span> Irssi</h4>
1157 
+<div class="outline-text-4" id="text-9-1-1">
1032 1158 
 <p>
1033 
-If you are using the <a href="http://www.irssi.org/">irssi</a> IRC client then you can use the following commands to connect to your IRC server.
1159 
+If you are using the <a href="http://www.irssi.org">irssi</a> IRC client then you can use the following commands to connect to your IRC server.
1034 1160 
 </p>
1035 1161
1036 1162 
 <div class="org-src-container">
 
@@ -1042,9 +1168,9 @@ If you are using the <a href="http://www.irssi.org/">irssi</a> IRC client then y
1042 1168 
 </div>
1043 1169 
 </div>
1044 1170 
 </div>
1045 
-<div id="outline-container-unnumbered-34" class="outline-4">
1046 
-<h4 id="unnumbered-34">XChat</h4>
1047 
-<div class="outline-text-4" id="text-unnumbered-34">
1171 
+<div id="outline-container-sec-9-1-2" class="outline-4">
1172 
+<h4 id="sec-9-1-2"><span class="section-number-4">9.1.2</span> XChat</h4>
1173 
+<div class="outline-text-4" id="text-9-1-2">
1048 1174 
 <p>
1049 1175 
 If you are using the XChat client:
1050 1176 
 </p>
 
@@ -1080,12 +1206,12 @@ Click <b>close</b> and then <b>connect</b>.
1080 1206 
 </div>
1081 1207 
 </div>
1082 1208
1083 
-<div id="outline-container-unnumbered-35" class="outline-3">
1084 
-<h3 id="unnumbered-35">XMPP/Jabber</h3>
1085 
-<div class="outline-text-3" id="text-unnumbered-35">
1086 
-</div><div id="outline-container-unnumbered-36" class="outline-4">
1087 
-<h4 id="unnumbered-36">Managing users</h4>
1088 
-<div class="outline-text-4" id="text-unnumbered-36">
1209 
+<div id="outline-container-sec-9-2" class="outline-3">
1210 
+<h3 id="sec-9-2"><span class="section-number-3">9.2</span> XMPP/Jabber</h3>
1211 
+<div class="outline-text-3" id="text-9-2">
1212 
+</div><div id="outline-container-sec-9-2-1" class="outline-4">
1213 
+<h4 id="sec-9-2-1"><span class="section-number-4">9.2.1</span> Managing users</h4>
1214 
+<div class="outline-text-4" id="text-9-2-1">
1089 1215 
 <p>
1090 1216 
 To add a user:
1091 1217 
 </p>
 
@@ -1095,8 +1221,8 @@ To add a user:
1095 1221 
 <pre class="src src-bash">ssh username@domainname -p 2222
1096 1222 
 su
1097 1223 
 prosodyctl adduser newusername@newdomainname
1098 
-<span class="org-keyword">exit</span>
1099 
-<span class="org-keyword">exit</span>
1224 
+exit
1225 
+exit
1100 1226 
 </pre>
1101 1227 
 </div>
1102 1228 
 
@@ -1109,8 +1235,8 @@ To change a user password:
1109 1235 
 <pre class="src src-bash">ssh username@domainname -p 2222
1110 1236 
 su
1111 1237 
 prosodyctl passwd username@domainname
1112 
-<span class="org-keyword">exit</span>
1113 
-<span class="org-keyword">exit</span>
1238 
+exit
1239 
+exit
1114 1240 
 </pre>
1115 1241 
 </div>
1116 1242 
 
@@ -1123,8 +1249,8 @@ To remove a user:
1123 1249 
 <pre class="src src-bash">ssh username@domainname -p 2222
1124 1250 
 su
1125 1251 
 prosodyctl deluser username@domainname.com
1126 
-<span class="org-keyword">exit</span>
1127 
-<span class="org-keyword">exit</span>
1252 
+exit
1253 
+exit
1128 1254 
 </pre>
1129 1255 
 </div>
1130 1256 
 
@@ -1137,22 +1263,22 @@ Report the status of the XMPP server:
1137 1263 
 <pre class="src src-bash">ssh username@domainname -p 2222
1138 1264 
 su
1139 1265 
 prosodyctl status
1140 
-<span class="org-keyword">exit</span>
1141 
-<span class="org-keyword">exit</span>
1266 
+exit
1267 
+exit
1142 1268 
 </pre>
1143 1269 
 </div>
1144 1270 
 </div>
1145 1271 
 </div>
1146 1272
1147 
-<div id="outline-container-unnumbered-37" class="outline-4">
1148 
-<h4 id="unnumbered-37">Using with Jitsi</h4>
1149 
-<div class="outline-text-4" id="text-unnumbered-37">
1273 
+<div id="outline-container-sec-9-2-2" class="outline-4">
1274 
+<h4 id="sec-9-2-2"><span class="section-number-4">9.2.2</span> Using with Jitsi</h4>
1275 
+<div class="outline-text-4" id="text-9-2-2">
1150 1276 
 <p>
1151 1277 
 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.
1152 1278 
 </p>
1153 1279
1154 1280 
 <p>
1155 
-Jitsi can be downloaded from <a href="https://jitsi.org/">https://jitsi.org/</a>
1281 
+Jitsi can be downloaded from <a href="https://jitsi.org">https://jitsi.org</a>
1156 1282 
 </p>
1157 1283
1158 1284 
 <p>
 
@@ -1176,9 +1302,9 @@ You can also <a href="https://www.youtube.com/watch?v=vgx7VSrDGjk">see this vide
1176 1302 
 </p>
1177 1303 
 </div>
1178 1304 
 </div>
1179 
-<div id="outline-container-unnumbered-38" class="outline-4">
1180 
-<h4 id="unnumbered-38">Using with Ubuntu</h4>
1181 
-<div class="outline-text-4" id="text-unnumbered-38">
1305 
+<div id="outline-container-sec-9-2-3" class="outline-4">
1306 
+<h4 id="sec-9-2-3"><span class="section-number-4">9.2.3</span> Using with Ubuntu</h4>
1307 
+<div class="outline-text-4" id="text-9-2-3">
1182 1308 
 <p>
1183 1309 
 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.
1184 1310 
 </p>
 
@@ -1196,9 +1322,9 @@ Click on <b>Advanced</b> and make sure that <b>Encryption required</b> and <b>Ig
1196 1322 
 </p>
1197 1323 
 </div>
1198 1324 
 </div>
1199 
-<div id="outline-container-unnumbered-39" class="outline-4">
1200 
-<h4 id="unnumbered-39">Using with Android</h4>
1201 
-<div class="outline-text-4" id="text-unnumbered-39">
1325 
+<div id="outline-container-sec-9-2-4" class="outline-4">
1326 
+<h4 id="sec-9-2-4"><span class="section-number-4">9.2.4</span> Using with Android</h4>
1327 
+<div class="outline-text-4" id="text-9-2-4">
1202 1328 
 <p>
1203 1329 
 Install <a href="https://f-droid.org/">F-Droid</a>
1204 1330 
 </p>
 
@@ -1228,40 +1354,10 @@ Go back to the initial screen and then using the menu you can add contacts and b
1228 1354 
 </div>
1229 1355 
 </div>
1230 1356 
 <div id="postamble" class="status">
1231 
-
1232 
-<style type="text/css">
1233 
-.back-to-top {
1234 
-    position: fixed;
1235 
-    bottom: 2em;
1236 
-    right: 0px;
1237 
-    text-decoration: none;
1238 
-    color: #000000;
1239 
-    background-color: rgba(235, 235, 235, 0.80);
1240 
-    font-size: 12px;
1241 
-    padding: 1em;
1242 
-    display: none;
1243 
-}
1244 
-
1245 
-.back-to-top:hover {
1246 
-    background-color: rgba(135, 135, 135, 0.50);
1247 
-}
1248 
-</style>
1249 
-
1250 
-<div class="back-to-top">
1251 
-<a href="#top">Back to top</a> | <a href="mailto:bob@robotics.uk.to">E-mail me</a>
1252 
-</div>
1253 
-
1254 
-<script type="text/javascript">
1255 
-    var offset = 220;
1256 
-    var duration = 500;
1257 
-    jQuery(window).scroll(function() {
1258 
-        if (jQuery(this).scrollTop() > offset) {
1259 
-            jQuery('.back-to-top').fadeIn(duration);
1260 
-        } else {
1261 
-            jQuery('.back-to-top').fadeOut(duration);
1262 
-        }
1263 
-    });
1264 
-</script>
1357 
+<p class="author">Author: Bob Mottram</p>
1358 
+<p class="date">Created: 2014-12-08 Mon 15:20</p>
1359 
+<p class="creator"><a href="http://www.gnu.org/software/emacs/">Emacs</a> 24.4.1 (<a href="http://orgmode.org">Org</a> mode 8.2.10)</p>
1360 
+<p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
1265 1361 
 </div>
1266 1362 
 </body>
1267 1363 
 </html>