free
/
freedomboneeee
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

ssh keys

This commit is contained in:
Bob Mottram 2014-12-08 18:43:32 +00:00
parent 99f21eefe1
commit f143a83d94
2 changed files with 310 additions and 184 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
usage.org
View File

@ -21,6 +21,36 @@ emacs ~/README
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*. 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*.
To exit you can either just close the terminal or use *CTRL-x CTRL-c* followed by the *exit* command. To exit you can either just close the terminal or use *CTRL-x CTRL-c* followed by the *exit* command.
* Improving ssh security
To improve ssh security you can generate an ssh key pair on your system and then upload the public key to the Freedombone.
On your local machine:
#+BEGIN_SRC bash
ssh-keygen
#+END_SRC
For extra security you may also want to add a passphrase to the ssh private key. You can show the generated public key with:
#+BEGIN_SRC bash
cat ~/.ssh/id_rsa.pub
#+END_SRC
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.
ssh to the Freedombone and edit the authorized keys:
#+BEGIN_SRC bash
ssh username@domain -p 2222
emacs ~/.ssh/authorized_keys
#+END_SRC
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.
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.
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.
* Using Email * Using Email
** A technical note about email transport security ** A technical note about email transport security
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. 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.

464
website/usage.html
View File

@ -4,7 +4,7 @@
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"> <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head> <head>
<title></title> <title></title>
<!-- 2014-11-11 Tue 21:13 --> <!-- 2014-12-08 Mon 15:20 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" /> <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="generator" content="Org-mode" /> <meta name="generator" content="Org-mode" />
<meta name="author" content="Bob Mottram" /> <meta name="author" content="Bob Mottram" />
@ -91,10 +91,6 @@
{ background-color: #ffff00; color: #000000; font-weight: bold; } { background-color: #ffff00; color: #000000; font-weight: bold; }
/*]]>*/--> /*]]>*/-->
</style> </style>
<link rel="stylesheet" type="text/css"
href="http://sachachua.com/blog/wp-content/themes/sacha-v3/foundation/css/foundation.min.css"></link>
<link rel="stylesheet" type="text/css" href="http://sachachua.com/org-export.css"></link>
<link rel="stylesheet" type="text/css" href="http://sachachua.com/blog/wp-content/themes/sacha-v3/style.css"></link>
<script type="text/javascript"> <script type="text/javascript">
/* /*
@licstart The following is the entire license notice for the @licstart The following is the entire license notice for the
@ -143,11 +139,85 @@ for the JavaScript code in this tag.
</script> </script>
</head> </head>
<body> <body>
<div id="preamble" class="status">
<a name="top" id="top"></a>
</div>
<div id="content"> <div id="content">
<h1 class="title"></h1> <h1 class="title"></h1>
<div id="table-of-contents">
<h2>Table of Contents</h2>
<div id="text-table-of-contents">
<ul>
<li><a href="#sec-1">1. Readme</a></li>
<li><a href="#sec-2">2. Improving ssh security</a></li>
<li><a href="#sec-3">3. Using Email</a>
<ul>
<li><a href="#sec-3-1">3.1. A technical note about email transport security</a></li>
<li><a href="#sec-3-2">3.2. Add a password to your GPG key</a></li>
<li><a href="#sec-3-3">3.3. Publishing your GPG public key</a></li>
<li><a href="#sec-3-4">3.4. Mutt email client</a></li>
<li><a href="#sec-3-5">3.5. Thunderbird</a>
<ul>
<li><a href="#sec-3-5-1">3.5.1. Initial setup</a></li>
<li><a href="#sec-3-5-2">3.5.2. Import your GPG keys</a></li>
<li><a href="#sec-3-5-3">3.5.3. Using for the first time</a></li>
<li><a href="#sec-3-5-4">3.5.4. Making folders visible</a></li>
</ul>
</li>
<li><a href="#sec-3-6">3.6. K9 Android client</a>
<ul>
<li><a href="#sec-3-6-1">3.6.1. Incoming server settings</a></li>
<li><a href="#sec-3-6-2">3.6.2. Outgoing (SMTP) server settings</a></li>
<li><a href="#sec-3-6-3">3.6.3. Folders</a></li>
</ul>
</li>
<li><a href="#sec-3-7">3.7. Subscribing to mailing lists</a></li>
<li><a href="#sec-3-8">3.8. Adding email addresses to a group/folder</a></li>
</ul>
</li>
<li><a href="#sec-4">4. Mailing List</a></li>
<li><a href="#sec-5">5. Syncing to the Cloud</a>
<ul>
<li><a href="#sec-5-1">5.1. Initial install</a></li>
<li><a href="#sec-5-2">5.2. On Android</a></li>
<li><a href="#sec-5-3">5.3. On Linux</a></li>
</ul>
</li>
<li><a href="#sec-6">6. Play Music</a>
<ul>
<li><a href="#sec-6-1">6.1. With the DLNA service</a></li>
<li><a href="#sec-6-2">6.2. With Owncloud</a></li>
</ul>
</li>
<li><a href="#sec-7">7. Microblogging</a>
<ul>
<li><a href="#sec-7-1">7.1. Initial configuration</a></li>
</ul>
</li>
<li><a href="#sec-8">8. Social Network</a>
<ul>
<li><a href="#sec-8-1">8.1. Certificates</a></li>
<li><a href="#sec-8-2">8.2. Initial install</a></li>
</ul>
</li>
<li><a href="#sec-9">9. Chat Services</a>
<ul>
<li><a href="#sec-9-1">9.1. IRC</a>
<ul>
<li><a href="#sec-9-1-1">9.1.1. Irssi</a></li>
<li><a href="#sec-9-1-2">9.1.2. XChat</a></li>
</ul>
</li>
<li><a href="#sec-9-2">9.2. XMPP/Jabber</a>
<ul>
<li><a href="#sec-9-2-1">9.2.1. Managing users</a></li>
<li><a href="#sec-9-2-2">9.2.2. Using with Jitsi</a></li>
<li><a href="#sec-9-2-3">9.2.3. Using with Ubuntu</a></li>
<li><a href="#sec-9-2-4">9.2.4. Using with Android</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<div class="center"> <div class="center">
<div class="figure"> <div class="figure">
@ -181,21 +251,21 @@ for the JavaScript code in this tag.
<tbody> <tbody>
<tr> <tr>
<td class="left"><a href="index.html">Home</a></td> <td class="left"><a href="index.html">Home</a></td>
<td class="left"><a href="#unnumbered-1">Readme</a></td> <td class="left"><a href="#sec-1">1</a></td>
<td class="left"><a href="#unnumbered-2">Using Email</a></td> <td class="left"><a href="#sec-3">3</a></td>
<td class="left"><a href="#unnumbered-18">Mailing List</a></td> <td class="left"><a href="#sec-4">4</a></td>
<td class="left"><a href="#unnumbered-19">Syncing to the Cloud</a></td> <td class="left"><a href="#sec-5">5</a></td>
<td class="left"><a href="#unnumbered-23">Play Music</a></td> <td class="left"><a href="#sec-6">6</a></td>
<td class="left"><a href="#unnumbered-26">Microblogging</a></td> <td class="left"><a href="#sec-7">7</a></td>
<td class="left"><a href="#unnumbered-28">Social Network</a></td> <td class="left"><a href="#sec-8">8</a></td>
<td class="left"><a href="#unnumbered-31">Chat Services</a></td> <td class="left"><a href="#sec-9">9</a></td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
<div id="outline-container-unnumbered-1" class="outline-2"> <div id="outline-container-sec-1" class="outline-2">
<h2 id="unnumbered-1">Readme</h2> <h2 id="sec-1"><span class="section-number-2">1</span> Readme</h2>
<div class="outline-text-2" id="text-unnumbered-1"> <div class="outline-text-2" id="text-1">
<p> <p>
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: 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:
</p> </p>
@ -216,20 +286,76 @@ To exit you can either just close the terminal or use <b>CTRL-x CTRL-c</b> follo
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-2" class="outline-2"> <div id="outline-container-sec-2" class="outline-2">
<h2 id="unnumbered-2">Using Email</h2> <h2 id="sec-2"><span class="section-number-2">2</span> Improving ssh security</h2>
<div class="outline-text-2" id="text-unnumbered-2"> <div class="outline-text-2" id="text-2">
</div><div id="outline-container-unnumbered-3" class="outline-3"> <p>
<h3 id="unnumbered-3">A technical note about email transport security</h3> To improve ssh security you can generate an ssh key pair on your system and then upload the public key to the Freedombone.
<div class="outline-text-3" id="text-unnumbered-3"> </p>
<p>
On your local machine:
</p>
<div class="org-src-container">
<pre class="src src-bash">ssh-keygen
</pre>
</div>
<p>
For extra security you may also want to add a passphrase to the ssh private key. You can show the generated public key with:
</p>
<div class="org-src-container">
<pre class="src src-bash">cat ~/.ssh/id_rsa.pub
</pre>
</div>
<p>
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.
</p>
<p>
ssh to the Freedombone and edit the authorized keys:
</p>
<div class="org-src-container">
<pre class="src src-bash">ssh username@domain -p 2222
emacs ~/.ssh/authorized_keys
</pre>
</div>
<p>
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.
</p>
<p>
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.
</p>
<p>
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.
</p>
</div>
</div>
<div id="outline-container-sec-3" class="outline-2">
<h2 id="sec-3"><span class="section-number-2">3</span> Using Email</h2>
<div class="outline-text-2" id="text-3">
</div><div id="outline-container-sec-3-1" class="outline-3">
<h3 id="sec-3-1"><span class="section-number-3">3.1</span> A technical note about email transport security</h3>
<div class="outline-text-3" id="text-3-1">
<p> <p>
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. 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.
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-4" class="outline-3"> <div id="outline-container-sec-3-2" class="outline-3">
<h3 id="unnumbered-4">Add a password to your GPG key</h3> <h3 id="sec-3-2"><span class="section-number-3">3.2</span> Add a password to your GPG key</h3>
<div class="outline-text-3" id="text-unnumbered-4"> <div class="outline-text-3" id="text-3-2">
<p> <p>
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. 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.
</p> </p>
@ -241,7 +367,7 @@ gpg --edit-key username@domain
passwd passwd
save save
quit quit
<span class="org-keyword">exit</span> exit
</pre> </pre>
</div> </div>
@ -251,9 +377,9 @@ Having a password on your GPG key will prevent someone from reading your email <
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-5" class="outline-3"> <div id="outline-container-sec-3-3" class="outline-3">
<h3 id="unnumbered-5">Publishing your GPG public key</h3> <h3 id="sec-3-3"><span class="section-number-3">3.3</span> Publishing your GPG public key</h3>
<div class="outline-text-3" id="text-unnumbered-5"> <div class="outline-text-3" id="text-3-3">
<p> <p>
If you havn't already then you should publish your GPG public key so that others can find it. If you havn't already then you should publish your GPG public key so that others can find it.
</p> </p>
@ -262,14 +388,14 @@ If you havn't already then you should publish your GPG public key so that others
<pre class="src src-bash">ssh username@domainname -p 2222 <pre class="src src-bash">ssh username@domainname -p 2222
gpg --send-keys username@domainname gpg --send-keys username@domainname
<span class="org-keyword">exit</span> exit
</pre> </pre>
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-6" class="outline-3"> <div id="outline-container-sec-3-4" class="outline-3">
<h3 id="unnumbered-6">Mutt email client</h3> <h3 id="sec-3-4"><span class="section-number-3">3.4</span> Mutt email client</h3>
<div class="outline-text-3" id="text-unnumbered-6"> <div class="outline-text-3" id="text-3-4">
<p> <p>
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: 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:
</p> </p>
@ -412,9 +538,9 @@ When reading emails you will initially need to enter your GPG password. It will
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-7" class="outline-3"> <div id="outline-container-sec-3-5" class="outline-3">
<h3 id="unnumbered-7">Thunderbird</h3> <h3 id="sec-3-5"><span class="section-number-3">3.5</span> Thunderbird</h3>
<div class="outline-text-3" id="text-unnumbered-7"> <div class="outline-text-3" id="text-3-5">
<p> <p>
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. 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.
</p> </p>
@ -424,9 +550,9 @@ The following instructions should be carried out on the client machines (laptop,
</p> </p>
</div> </div>
<div id="outline-container-unnumbered-8" class="outline-4"> <div id="outline-container-sec-3-5-1" class="outline-4">
<h4 id="unnumbered-8">Initial setup</h4> <h4 id="sec-3-5-1"><span class="section-number-4">3.5.1</span> Initial setup</h4>
<div class="outline-text-4" id="text-unnumbered-8"> <div class="outline-text-4" id="text-3-5-1">
<p> <p>
Install <b>Thunderbird</b> and <b>Enigmail</b>. How you do this just depends upon your distro and software manager or "app store". Install <b>Thunderbird</b> and <b>Enigmail</b>. How you do this just depends upon your distro and software manager or "app store".
</p> </p>
@ -485,9 +611,9 @@ Select "<b>yes</b>" to change default settings.
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-9" class="outline-4"> <div id="outline-container-sec-3-5-2" class="outline-4">
<h4 id="unnumbered-9">Import your GPG keys</h4> <h4 id="sec-3-5-2"><span class="section-number-4">3.5.2</span> Import your GPG keys</h4>
<div class="outline-text-4" id="text-unnumbered-9"> <div class="outline-text-4" id="text-3-5-2">
<p> <p>
On the Freedombone export your GPG public and private keys. On the Freedombone export your GPG public and private keys.
</p> </p>
@ -536,9 +662,9 @@ shred -zu ~/private_key.gpg
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-10" class="outline-4"> <div id="outline-container-sec-3-5-3" class="outline-4">
<h4 id="unnumbered-10">Using for the first time</h4> <h4 id="sec-3-5-3"><span class="section-number-4">3.5.3</span> Using for the first time</h4>
<div class="outline-text-4" id="text-unnumbered-10"> <div class="outline-text-4" id="text-3-5-3">
<p> <p>
Click on the Thunderbird menu, which looks like three horizontal bars on the right hand side. Click on the Thunderbird menu, which looks like three horizontal bars on the right hand side.
</p> </p>
@ -573,9 +699,9 @@ Get into the habit of using email encryption and encourage others to do so. Rem
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-11" class="outline-4"> <div id="outline-container-sec-3-5-4" class="outline-4">
<h4 id="unnumbered-11">Making folders visible</h4> <h4 id="sec-3-5-4"><span class="section-number-4">3.5.4</span> Making folders visible</h4>
<div class="outline-text-4" id="text-unnumbered-11"> <div class="outline-text-4" id="text-3-5-4">
<p> <p>
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: 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:
</p> </p>
@ -591,17 +717,17 @@ Make sure that "<b>show only subscribed folders</b>" is not checked. Then click
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-12" class="outline-3"> <div id="outline-container-sec-3-6" class="outline-3">
<h3 id="unnumbered-12">K9 Android client</h3> <h3 id="sec-3-6"><span class="section-number-3">3.6</span> K9 Android client</h3>
<div class="outline-text-3" id="text-unnumbered-12"> <div class="outline-text-3" id="text-3-6">
<p> <p>
<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. <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.
</p> </p>
</div> </div>
<div id="outline-container-unnumbered-13" class="outline-4"> <div id="outline-container-sec-3-6-1" class="outline-4">
<h4 id="unnumbered-13">Incoming server settings</h4> <h4 id="sec-3-6-1"><span class="section-number-4">3.6.1</span> Incoming server settings</h4>
<div class="outline-text-4" id="text-unnumbered-13"> <div class="outline-text-4" id="text-3-6-1">
<ul class="org-ul"> <ul class="org-ul">
<li>Select settings/account settings <li>Select settings/account settings
</li> </li>
@ -620,9 +746,9 @@ Make sure that "<b>show only subscribed folders</b>" is not checked. Then click
</ul> </ul>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-14" class="outline-4"> <div id="outline-container-sec-3-6-2" class="outline-4">
<h4 id="unnumbered-14">Outgoing (SMTP) server settings</h4> <h4 id="sec-3-6-2"><span class="section-number-4">3.6.2</span> Outgoing (SMTP) server settings</h4>
<div class="outline-text-4" id="text-unnumbered-14"> <div class="outline-text-4" id="text-3-6-2">
<ul class="org-ul"> <ul class="org-ul">
<li>Select settings/account settings <li>Select settings/account settings
</li> </li>
@ -643,9 +769,9 @@ Make sure that "<b>show only subscribed folders</b>" is not checked. Then click
</ul> </ul>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-15" class="outline-4"> <div id="outline-container-sec-3-6-3" class="outline-4">
<h4 id="unnumbered-15">Folders</h4> <h4 id="sec-3-6-3"><span class="section-number-4">3.6.3</span> Folders</h4>
<div class="outline-text-4" id="text-unnumbered-15"> <div class="outline-text-4" id="text-3-6-3">
<p> <p>
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>. 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>.
</p> </p>
@ -657,9 +783,9 @@ If your folder still doesn't show up then press the <b>menu button</b>, select <
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-16" class="outline-3"> <div id="outline-container-sec-3-7" class="outline-3">
<h3 id="unnumbered-16">Subscribing to mailing lists</h3> <h3 id="sec-3-7"><span class="section-number-3">3.7</span> Subscribing to mailing lists</h3>
<div class="outline-text-3" id="text-unnumbered-16"> <div class="outline-text-3" id="text-3-7">
<p> <p>
To subscribe to a mailing list so that it appears within Mutt or Thunderbird. To subscribe to a mailing list so that it appears within Mutt or Thunderbird.
</p> </p>
@ -668,7 +794,7 @@ To subscribe to a mailing list so that it appears within Mutt or Thunderbird.
<pre class="src src-bash">ssh username@domainname -p 2222 <pre class="src src-bash">ssh username@domainname -p 2222
addmailinglist &lt;username&gt; &lt;mailinglistname&gt; &lt;subjecttag&gt; addmailinglist &lt;username&gt; &lt;mailinglistname&gt; &lt;subjecttag&gt;
<span class="org-keyword">exit</span> exit
</pre> </pre>
</div> </div>
@ -677,9 +803,9 @@ The subject tag should be the word or phrase which appears within the brackets i
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-17" class="outline-3"> <div id="outline-container-sec-3-8" class="outline-3">
<h3 id="unnumbered-17">Adding email addresses to a group/folder</h3> <h3 id="sec-3-8"><span class="section-number-3">3.8</span> Adding email addresses to a group/folder</h3>
<div class="outline-text-3" id="text-unnumbered-17"> <div class="outline-text-3" id="text-3-8">
<p> <p>
Similar to adding mailing list folders you can also add specified email addresses into a folder. Similar to adding mailing list folders you can also add specified email addresses into a folder.
</p> </p>
@ -688,7 +814,7 @@ Similar to adding mailing list folders you can also add specified email addresse
<pre class="src src-bash">ssh username@domainname -p 2222 <pre class="src src-bash">ssh username@domainname -p 2222
addemailtofolder &lt;username&gt; &lt;emailaddress&gt; &lt;mailinglistname&gt; addemailtofolder &lt;username&gt; &lt;emailaddress&gt; &lt;mailinglistname&gt;
<span class="org-keyword">exit</span> exit
</pre> </pre>
</div> </div>
@ -699,9 +825,9 @@ The mailing list name should be something short so that it is readable within th
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-18" class="outline-2"> <div id="outline-container-sec-4" class="outline-2">
<h2 id="unnumbered-18">Mailing List</h2> <h2 id="sec-4"><span class="section-number-2">4</span> Mailing List</h2>
<div class="outline-text-2" id="text-unnumbered-18"> <div class="outline-text-2" id="text-4">
<p> <p>
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. 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.
</p> </p>
@ -721,12 +847,12 @@ Tip: When using the Mutt email client if you want to send an email in cleartext
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-19" class="outline-2"> <div id="outline-container-sec-5" class="outline-2">
<h2 id="unnumbered-19">Syncing to the Cloud</h2> <h2 id="sec-5"><span class="section-number-2">5</span> Syncing to the Cloud</h2>
<div class="outline-text-2" id="text-unnumbered-19"> <div class="outline-text-2" id="text-5">
</div><div id="outline-container-unnumbered-20" class="outline-3"> </div><div id="outline-container-sec-5-1" class="outline-3">
<h3 id="unnumbered-20">Initial install</h3> <h3 id="sec-5-1"><span class="section-number-3">5.1</span> Initial install</h3>
<div class="outline-text-3" id="text-unnumbered-20"> <div class="outline-text-3" id="text-5-1">
<p> <p>
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. 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.
</p> </p>
@ -751,7 +877,7 @@ You will also need to enter database details:
<tr> <tr>
<td class="left">Owncloud database password</td> <td class="left">Owncloud database password</td>
<td class="left">See the <a href="#unnumbered-1">Readme</a> file</td> <td class="left">See the <a href="#sec-1">1</a> file</td>
</tr> </tr>
<tr> <tr>
@ -770,9 +896,9 @@ Log out from the administrator account and then log back in as the user you just
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-21" class="outline-3"> <div id="outline-container-sec-5-2" class="outline-3">
<h3 id="unnumbered-21">On Android</h3> <h3 id="sec-5-2"><span class="section-number-3">5.2</span> On Android</h3>
<div class="outline-text-3" id="text-unnumbered-21"> <div class="outline-text-3" id="text-5-2">
<p> <p>
Within F-droid search for <b>owncloud</b> and install the client. Also install <b>CalDAV Sync Adapter</b>. Within F-droid search for <b>owncloud</b> and install the client. Also install <b>CalDAV Sync Adapter</b>.
</p> </p>
@ -796,9 +922,9 @@ You will also be prompted to enter login details. Your Android and Owncloud cale
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-22" class="outline-3"> <div id="outline-container-sec-5-3" class="outline-3">
<h3 id="unnumbered-22">On Linux</h3> <h3 id="sec-5-3"><span class="section-number-3">5.3</span> On Linux</h3>
<div class="outline-text-3" id="text-unnumbered-22"> <div class="outline-text-3" id="text-5-3">
<p> <p>
Open your software center and search for "owncloud client". Enter your owncloud domain name (with the https prefix) and login details. Open your software center and search for "owncloud client". Enter your owncloud domain name (with the https prefix) and login details.
</p> </p>
@ -809,12 +935,12 @@ You can now drag files into the <b>~/owncloud</b> directory and they will automa
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-23" class="outline-2"> <div id="outline-container-sec-6" class="outline-2">
<h2 id="unnumbered-23">Play Music</h2> <h2 id="sec-6"><span class="section-number-2">6</span> Play Music</h2>
<div class="outline-text-2" id="text-unnumbered-23"> <div class="outline-text-2" id="text-6">
</div><div id="outline-container-unnumbered-24" class="outline-3"> </div><div id="outline-container-sec-6-1" class="outline-3">
<h3 id="unnumbered-24">With the DLNA service</h3> <h3 id="sec-6-1"><span class="section-number-3">6.1</span> With the DLNA service</h3>
<div class="outline-text-3" id="text-unnumbered-24"> <div class="outline-text-3" id="text-6-1">
<p> <p>
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. 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.
</p> </p>
@ -854,9 +980,9 @@ The DLNA service will only work within your local home network, and isn't remote
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-25" class="outline-3"> <div id="outline-container-sec-6-2" class="outline-3">
<h3 id="unnumbered-25">With Owncloud</h3> <h3 id="sec-6-2"><span class="section-number-3">6.2</span> With Owncloud</h3>
<div class="outline-text-3" id="text-unnumbered-25"> <div class="outline-text-3" id="text-6-2">
<p> <p>
The main advantage of playing music via Owncloud is that you can do that from anywhere - not only within your home network. The main advantage of playing music via Owncloud is that you can do that from anywhere - not only within your home network.
</p> </p>
@ -868,12 +994,12 @@ By default a music player is installed into Owncloud, so all you need to do is t
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-26" class="outline-2"> <div id="outline-container-sec-7" class="outline-2">
<h2 id="unnumbered-26">Microblogging</h2> <h2 id="sec-7"><span class="section-number-2">7</span> Microblogging</h2>
<div class="outline-text-2" id="text-unnumbered-26"> <div class="outline-text-2" id="text-7">
</div><div id="outline-container-unnumbered-27" class="outline-3"> </div><div id="outline-container-sec-7-1" class="outline-3">
<h3 id="unnumbered-27">Initial configuration</h3> <h3 id="sec-7-1"><span class="section-number-3">7.1</span> Initial configuration</h3>
<div class="outline-text-3" id="text-unnumbered-27"> <div class="outline-text-3" id="text-7-1">
<p> <p>
To set up your microblog go to: To set up your microblog go to:
</p> </p>
@ -924,7 +1050,7 @@ and enter the following settings:
<tr> <tr>
<td class="left">DB Password</td> <td class="left">DB Password</td>
<td class="left">See the MariaDB password in the <a href="#unnumbered-1">Readme</a> file</td> <td class="left">See the MariaDB password in the <a href="#sec-1">1</a> file</td>
</tr> </tr>
<tr> <tr>
@ -934,7 +1060,7 @@ and enter the following settings:
<tr> <tr>
<td class="left">Administrator password</td> <td class="left">Administrator password</td>
<td class="left">See the <a href="#unnumbered-1">Readme</a> file</td> <td class="left">See the <a href="#sec-1">1</a> file</td>
</tr> </tr>
<tr> <tr>
@ -981,12 +1107,12 @@ When the install is complete you will see a lot of warnings but just ignore thos
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-28" class="outline-2"> <div id="outline-container-sec-8" class="outline-2">
<h2 id="unnumbered-28">Social Network</h2> <h2 id="sec-8"><span class="section-number-2">8</span> Social Network</h2>
<div class="outline-text-2" id="text-unnumbered-28"> <div class="outline-text-2" id="text-8">
</div><div id="outline-container-unnumbered-29" class="outline-3"> </div><div id="outline-container-sec-8-1" class="outline-3">
<h3 id="unnumbered-29">Certificates</h3> <h3 id="sec-8-1"><span class="section-number-3">8.1</span> Certificates</h3>
<div class="outline-text-3" id="text-unnumbered-29"> <div class="outline-text-3" id="text-8-1">
<p> <p>
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: 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:
</p> </p>
@ -1003,9 +1129,9 @@ Then change ssl_certificate to <b>/etc/ssl/certs/yourredmatrixdomainname.bundle.
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-30" class="outline-3"> <div id="outline-container-sec-8-2" class="outline-3">
<h3 id="unnumbered-30">Initial install</h3> <h3 id="sec-8-2"><span class="section-number-3">8.2</span> Initial install</h3>
<div class="outline-text-3" id="text-unnumbered-30"> <div class="outline-text-3" id="text-8-2">
<p> <p>
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. 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.
</p> </p>
@ -1016,21 +1142,21 @@ When installation is complete you can register a new user.
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-31" class="outline-2"> <div id="outline-container-sec-9" class="outline-2">
<h2 id="unnumbered-31">Chat Services</h2> <h2 id="sec-9"><span class="section-number-2">9</span> Chat Services</h2>
<div class="outline-text-2" id="text-unnumbered-31"> <div class="outline-text-2" id="text-9">
</div><div id="outline-container-unnumbered-32" class="outline-3"> </div><div id="outline-container-sec-9-1" class="outline-3">
<h3 id="unnumbered-32">IRC</h3> <h3 id="sec-9-1"><span class="section-number-3">9.1</span> IRC</h3>
<div class="outline-text-3" id="text-unnumbered-32"> <div class="outline-text-3" id="text-9-1">
<p> <p>
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. 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.
</p> </p>
</div> </div>
<div id="outline-container-unnumbered-33" class="outline-4"> <div id="outline-container-sec-9-1-1" class="outline-4">
<h4 id="unnumbered-33">Irssi</h4> <h4 id="sec-9-1-1"><span class="section-number-4">9.1.1</span> Irssi</h4>
<div class="outline-text-4" id="text-unnumbered-33"> <div class="outline-text-4" id="text-9-1-1">
<p> <p>
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. 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.
</p> </p>
<div class="org-src-container"> <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
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-34" class="outline-4"> <div id="outline-container-sec-9-1-2" class="outline-4">
<h4 id="unnumbered-34">XChat</h4> <h4 id="sec-9-1-2"><span class="section-number-4">9.1.2</span> XChat</h4>
<div class="outline-text-4" id="text-unnumbered-34"> <div class="outline-text-4" id="text-9-1-2">
<p> <p>
If you are using the XChat client: If you are using the XChat client:
</p> </p>
@ -1080,12 +1206,12 @@ Click <b>close</b> and then <b>connect</b>.
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-35" class="outline-3"> <div id="outline-container-sec-9-2" class="outline-3">
<h3 id="unnumbered-35">XMPP/Jabber</h3> <h3 id="sec-9-2"><span class="section-number-3">9.2</span> XMPP/Jabber</h3>
<div class="outline-text-3" id="text-unnumbered-35"> <div class="outline-text-3" id="text-9-2">
</div><div id="outline-container-unnumbered-36" class="outline-4"> </div><div id="outline-container-sec-9-2-1" class="outline-4">
<h4 id="unnumbered-36">Managing users</h4> <h4 id="sec-9-2-1"><span class="section-number-4">9.2.1</span> Managing users</h4>
<div class="outline-text-4" id="text-unnumbered-36"> <div class="outline-text-4" id="text-9-2-1">
<p> <p>
To add a user: To add a user:
</p> </p>
@ -1095,8 +1221,8 @@ To add a user:
<pre class="src src-bash">ssh username@domainname -p 2222 <pre class="src src-bash">ssh username@domainname -p 2222
su su
prosodyctl adduser newusername@newdomainname prosodyctl adduser newusername@newdomainname
<span class="org-keyword">exit</span> exit
<span class="org-keyword">exit</span> exit
</pre> </pre>
</div> </div>
@ -1109,8 +1235,8 @@ To change a user password:
<pre class="src src-bash">ssh username@domainname -p 2222 <pre class="src src-bash">ssh username@domainname -p 2222
su su
prosodyctl passwd username@domainname prosodyctl passwd username@domainname
<span class="org-keyword">exit</span> exit
<span class="org-keyword">exit</span> exit
</pre> </pre>
</div> </div>
@ -1123,8 +1249,8 @@ To remove a user:
<pre class="src src-bash">ssh username@domainname -p 2222 <pre class="src src-bash">ssh username@domainname -p 2222
su su
prosodyctl deluser username@domainname.com prosodyctl deluser username@domainname.com
<span class="org-keyword">exit</span> exit
<span class="org-keyword">exit</span> exit
</pre> </pre>
</div> </div>
@ -1137,22 +1263,22 @@ Report the status of the XMPP server:
<pre class="src src-bash">ssh username@domainname -p 2222 <pre class="src src-bash">ssh username@domainname -p 2222
su su
prosodyctl status prosodyctl status
<span class="org-keyword">exit</span> exit
<span class="org-keyword">exit</span> exit
</pre> </pre>
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-37" class="outline-4"> <div id="outline-container-sec-9-2-2" class="outline-4">
<h4 id="unnumbered-37">Using with Jitsi</h4> <h4 id="sec-9-2-2"><span class="section-number-4">9.2.2</span> Using with Jitsi</h4>
<div class="outline-text-4" id="text-unnumbered-37"> <div class="outline-text-4" id="text-9-2-2">
<p> <p>
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. 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.
</p> </p>
<p> <p>
Jitsi can be downloaded from <a href="https://jitsi.org/">https://jitsi.org/</a> Jitsi can be downloaded from <a href="https://jitsi.org">https://jitsi.org</a>
</p> </p>
<p> <p>
@ -1176,9 +1302,9 @@ You can also <a href="https://www.youtube.com/watch?v=vgx7VSrDGjk">see this vide
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-38" class="outline-4"> <div id="outline-container-sec-9-2-3" class="outline-4">
<h4 id="unnumbered-38">Using with Ubuntu</h4> <h4 id="sec-9-2-3"><span class="section-number-4">9.2.3</span> Using with Ubuntu</h4>
<div class="outline-text-4" id="text-unnumbered-38"> <div class="outline-text-4" id="text-9-2-3">
<p> <p>
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. 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.
</p> </p>
@ -1196,9 +1322,9 @@ Click on <b>Advanced</b> and make sure that <b>Encryption required</b> and <b>Ig
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-unnumbered-39" class="outline-4"> <div id="outline-container-sec-9-2-4" class="outline-4">
<h4 id="unnumbered-39">Using with Android</h4> <h4 id="sec-9-2-4"><span class="section-number-4">9.2.4</span> Using with Android</h4>
<div class="outline-text-4" id="text-unnumbered-39"> <div class="outline-text-4" id="text-9-2-4">
<p> <p>
Install <a href="https://f-droid.org/">F-Droid</a> Install <a href="https://f-droid.org/">F-Droid</a>
</p> </p>
@ -1228,40 +1354,10 @@ Go back to the initial screen and then using the menu you can add contacts and b
</div> </div>
</div> </div>
<div id="postamble" class="status"> <div id="postamble" class="status">
<p class="author">Author: Bob Mottram</p>
<style type="text/css"> <p class="date">Created: 2014-12-08 Mon 15:20</p>
.back-to-top { <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>
position: fixed; <p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
bottom: 2em;
right: 0px;
text-decoration: none;
color: #000000;
background-color: rgba(235, 235, 235, 0.80);
font-size: 12px;
padding: 1em;
display: none;
}
.back-to-top:hover {
background-color: rgba(135, 135, 135, 0.50);
}
</style>
<div class="back-to-top">
<a href="#top">Back to top</a> | <a href="mailto:bob@robotics.uk.to">E-mail me</a>
</div>
<script type="text/javascript">
var offset = 220;
var duration = 500;
jQuery(window).scroll(function() {
if (jQuery(this).scrollTop() > offset) {
jQuery('.back-to-top').fadeIn(duration);
} else {
jQuery('.back-to-top').fadeOut(duration);
}
});
</script>
</div> </div>
</body> </body>
</html> </html>