Documentation

This commit is contained in:
Bob Mottram 2015-07-11 12:51:59 +01:00
parent a03c9e0416
commit f20c24f330
5 changed files with 292 additions and 251 deletions

View File

@ -8,7 +8,7 @@ The Freedombone system can be installed onto a Beaglebone Black, or any system c
- **Social**: Social networking with Red Matrix and GNU Social
- **Media**: Runs media services such as DLNA to play music or videos on your devices
- **Writer**: Host your blog and wiki
- **Chat**: Encrypted IRC, XMPP and VoIP services for one-to-one and many-to-many chat
- **Chat**: Encrypted IRC, XMPP, Tox and VoIP services for one-to-one and many-to-many chat
- **Developer**: Host your own git projects with a Github-like user interface
- **Nonmailbox**: Installs eveything except for the email server

View File

@ -177,6 +177,7 @@ On your internet router, typically under firewall settings, open the following p
| Email | 465 |
| Email | 993 |
| VoIP | 64738 |
| Tox | 33445 |
* Keydrives
After installing for the first time it's a good idea to create some keydrives. These will store your gpg key so that if all else fails you will still be able to restore from backup. There are two ways to do this:

View File

@ -130,11 +130,11 @@ Open Thinderbird
Select "*Skip this and use existing email*"
Enter your name, email address (myusername@mydomainname.com) and the password for your user (the one from [[Add a user]]).
Enter your name, email address (myusername@mydomainname.com) and the password for your user.
You'll get a message saying "/Thunderbird failed to find the settings/"
The settings should be as follows, substituting /mydomainname.com/ for your domain name and /myusername/ for the username given previously in [[Add a user]].
The settings should be as follows, substituting /mydomainname.com/ for your domain name and /myusername/ for the username.
* Incoming: IMAP, mydomainname.com, 993, SSL/TLS, Normal Password
* Outgoing: SMTP, mydomainname.com, 465, SSL/TLS, Normal Password
@ -481,6 +481,14 @@ From the menu select *Settings* then *Security* then *OTR mode*. Set the mode t
Make sure that *Check server certificate* is not checked.
Go back to the initial screen and then using the menu you can add contacts and begin chatting. Both parties will need to go through the off-the-record question and answer verification before the chat can begin, but that only needs to be done once for each person you're chatting with.
** Tox
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.
*** Using the Toxic client
To connect to your node use the command:
#+BEGIN_SRC bash
/connect [yourdomainname] 33445 [your tox node ID]
#+END_SRC
** VoIP (Voice chat)
*** Using with Ubuntu
Within the software center search for "mumble" and install the client then run it. Skip through the audio setup wizard.

View File

@ -4,7 +4,7 @@
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<title></title>
<!-- 2015-07-05 Sun 20:31 -->
<!-- 2015-07-11 Sat 12:37 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="generator" content="Org-mode" />
<meta name="author" content="Bob Mottram" />
@ -547,6 +547,11 @@ On your internet router, typically under firewall settings, open the following p
<td class="org-left">VoIP</td>
<td class="org-right">64738</td>
</tr>
<tr>
<td class="org-left">Tox</td>
<td class="org-right">33445</td>
</tr>
</tbody>
</table>
</div>

View File

@ -4,16 +4,22 @@
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<title></title>
<!-- 2015-04-08 Wed 23:37 -->
<!-- 2015-07-11 Sat 12:51 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="generator" content="Org-mode" />
<meta name="author" content="Bob Mottram" />
<meta name="description" content="Turn the Beaglebone Black into a personal communications server"
/>
<meta name="keywords" content="freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<style type="text/css">
<!--/*--><![CDATA[/*><!--*/
.title { text-align: center; }
.title { text-align: center;
margin-bottom: .2em; }
.subtitle { text-align: center;
font-size: medium;
font-weight: bold;
margin-top:0; }
.todo { font-family: monospace; color: red; }
.done { font-family: monospace; color: green; }
.priority { font-family: monospace; color: orange; }
@ -21,9 +27,9 @@
padding: 2px; font-size: 80%; font-weight: normal; }
.timestamp { color: #bebebe; }
.timestamp-kwd { color: #5f9ea0; }
.right { margin-left: auto; margin-right: 0px; text-align: right; }
.left { margin-left: 0px; margin-right: auto; text-align: left; }
.center { margin-left: auto; margin-right: auto; text-align: center; }
.org-right { margin-left: auto; margin-right: 0px; text-align: right; }
.org-left { margin-left: 0px; margin-right: auto; text-align: left; }
.org-center { margin-left: auto; margin-right: auto; text-align: center; }
.underline { text-decoration: underline; }
#postamble p, #preamble p { font-size: 90%; margin: .2em; }
p.verse { margin-left: 3%; }
@ -62,12 +68,12 @@
caption.t-above { caption-side: top; }
caption.t-bottom { caption-side: bottom; }
td, th { vertical-align:top; }
th.right { text-align: center; }
th.left { text-align: center; }
th.center { text-align: center; }
td.right { text-align: right; }
td.left { text-align: left; }
td.center { text-align: center; }
th.org-right { text-align: center; }
th.org-left { text-align: center; }
th.org-center { text-align: center; }
td.org-right { text-align: right; }
td.org-left { text-align: left; }
td.org-center { text-align: center; }
dt { font-weight: bold; }
.footpara:nth-child(2) { display: inline; }
.footpara { display: block; }
@ -148,7 +154,6 @@ for the JavaScript code in this tag.
<a name="top" id="top"></a>
</div>
<div id="content">
<h1 class="title"></h1>
<div class="center">
<div class="figure">
@ -161,42 +166,42 @@ for the JavaScript code in this tag.
<colgroup>
<col class="left" />
<col class="org-left" />
<col class="left" />
<col class="org-left" />
<col class="left" />
<col class="org-left" />
<col class="left" />
<col class="org-left" />
<col class="left" />
<col class="org-left" />
<col class="left" />
<col class="org-left" />
<col class="left" />
<col class="org-left" />
<col class="left" />
<col class="org-left" />
<col class="left" />
<col class="org-left" />
</colgroup>
<tbody>
<tr>
<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="#unnumbered-3">Using Email</a></td>
<td class="left"><a href="#unnumbered-20">Mailing List</a></td>
<td class="left"><a href="#unnumbered-21">Syncing to the Cloud</a></td>
<td class="left"><a href="#unnumbered-25">Play Music</a></td>
<td class="left"><a href="#unnumbered-28">Microblogging</a></td>
<td class="left"><a href="#unnumbered-30">Social Network</a></td>
<td class="left"><a href="#unnumbered-33">Chat Services</a></td>
<td class="org-left"><a href="index.html">Home</a></td>
<td class="org-left"><a href="#orgheadline1">Readme</a></td>
<td class="org-left"><a href="#orgheadline2">Using Email</a></td>
<td class="org-left"><a href="#orgheadline3">Mailing List</a></td>
<td class="org-left"><a href="#orgheadline4">Syncing to the Cloud</a></td>
<td class="org-left"><a href="#orgheadline5">Play Music</a></td>
<td class="org-left"><a href="#orgheadline6">Microblogging</a></td>
<td class="org-left"><a href="#orgheadline7">Social Network</a></td>
<td class="org-left"><a href="#orgheadline8">Chat Services</a></td>
</tr>
</tbody>
</table>
<div id="outline-container-unnumbered-1" class="outline-2">
<h2 id="unnumbered-1">Readme</h2>
<div class="outline-text-2" id="text-unnumbered-1">
<div id="outline-container-orgheadline1" class="outline-2">
<h2 id="orgheadline1">Readme</h2>
<div class="outline-text-2" id="text-orgheadline1">
<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:
</p>
@ -217,9 +222,9 @@ To exit you can either just close the terminal or use <b>CTRL-x CTRL-c</b> follo
</p>
</div>
</div>
<div id="outline-container-unnumbered-2" class="outline-2">
<h2 id="unnumbered-2">Improving ssh security</h2>
<div class="outline-text-2" id="text-unnumbered-2">
<div id="outline-container-orgheadline9" class="outline-2">
<h2 id="orgheadline9">Improving ssh security</h2>
<div class="outline-text-2" id="text-orgheadline9">
<p>
To improve ssh security you can generate an ssh key pair on your system and then upload the public key to the Freedombone.
</p>
@ -273,20 +278,20 @@ If you wish to only use ssh keys then log in to the Freedombone and edit <b>/etc
</div>
</div>
<div id="outline-container-unnumbered-3" class="outline-2">
<h2 id="unnumbered-3">Using Email</h2>
<div class="outline-text-2" id="text-unnumbered-3">
</div><div id="outline-container-unnumbered-4" class="outline-3">
<h3 id="unnumbered-4">A technical note about email transport security</h3>
<div class="outline-text-3" id="text-unnumbered-4">
<div id="outline-container-orgheadline2" class="outline-2">
<h2 id="orgheadline2">Using Email</h2>
<div class="outline-text-2" id="text-orgheadline2">
</div><div id="outline-container-orgheadline10" class="outline-3">
<h3 id="orgheadline10">A technical note about email transport security</h3>
<div class="outline-text-3" id="text-orgheadline10">
<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.
</p>
</div>
</div>
<div id="outline-container-unnumbered-5" class="outline-3">
<h3 id="unnumbered-5">Add a password to your GPG key</h3>
<div class="outline-text-3" id="text-unnumbered-5">
<div id="outline-container-orgheadline11" class="outline-3">
<h3 id="orgheadline11">Add a password to your GPG key</h3>
<div class="outline-text-3" id="text-orgheadline11">
<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.
</p>
@ -308,9 +313,9 @@ Having a password on your GPG key will prevent someone from reading your email <
</div>
</div>
<div id="outline-container-unnumbered-6" class="outline-3">
<h3 id="unnumbered-6">Publishing your GPG public key</h3>
<div class="outline-text-3" id="text-unnumbered-6">
<div id="outline-container-orgheadline12" class="outline-3">
<h3 id="orgheadline12">Publishing your GPG public key</h3>
<div class="outline-text-3" id="text-orgheadline12">
<p>
If you havn't already then you should publish your GPG public key so that others can find it.
</p>
@ -324,9 +329,9 @@ gpg --send-keys username@domainname
</div>
</div>
</div>
<div id="outline-container-unnumbered-7" class="outline-3">
<h3 id="unnumbered-7">Mutt email client</h3>
<div class="outline-text-3" id="text-unnumbered-7">
<div id="outline-container-orgheadline13" class="outline-3">
<h3 id="orgheadline13">Mutt email client</h3>
<div class="outline-text-3" id="text-orgheadline13">
<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:
</p>
@ -353,114 +358,114 @@ Some useful keys to know are:
<colgroup>
<col class="left" />
<col class="org-left" />
<col class="left" />
<col class="org-left" />
</colgroup>
<tbody>
<tr>
<td class="left">"/"</td>
<td class="left">Search for text within headers</td>
<td class="org-left">"/"</td>
<td class="org-left">Search for text within headers</td>
</tr>
<tr>
<td class="left">*</td>
<td class="left">Move to the last message</td>
<td class="org-left">*</td>
<td class="org-left">Move to the last message</td>
</tr>
<tr>
<td class="left">TAB</td>
<td class="left">Move to the next unread message</td>
<td class="org-left">TAB</td>
<td class="org-left">Move to the next unread message</td>
</tr>
<tr>
<td class="left">d</td>
<td class="left">Delete a message</td>
<td class="org-left">d</td>
<td class="org-left">Delete a message</td>
</tr>
<tr>
<td class="left">u</td>
<td class="left">Undelete a mail which is pending deletion</td>
<td class="org-left">u</td>
<td class="org-left">Undelete a mail which is pending deletion</td>
</tr>
<tr>
<td class="left">$</td>
<td class="left">Delete all messages selected and check for new messages</td>
<td class="org-left">$</td>
<td class="org-left">Delete all messages selected and check for new messages</td>
</tr>
<tr>
<td class="left">a</td>
<td class="left">Add to the address book</td>
<td class="org-left">a</td>
<td class="org-left">Add to the address book</td>
</tr>
<tr>
<td class="left">m</td>
<td class="left">Send a new mail</td>
<td class="org-left">m</td>
<td class="org-left">Send a new mail</td>
</tr>
<tr>
<td class="left">ESC-m</td>
<td class="left">Mark all messages as having been read</td>
<td class="org-left">ESC-m</td>
<td class="org-left">Mark all messages as having been read</td>
</tr>
<tr>
<td class="left">S</td>
<td class="left">Mark a message as spam</td>
<td class="org-left">S</td>
<td class="org-left">Mark a message as spam</td>
</tr>
<tr>
<td class="left">H</td>
<td class="left">Mark a message as ham</td>
<td class="org-left">H</td>
<td class="org-left">Mark a message as ham</td>
</tr>
<tr>
<td class="left">CTRL-b</td>
<td class="left">Toggle side bar on/off</td>
<td class="org-left">CTRL-b</td>
<td class="org-left">Toggle side bar on/off</td>
</tr>
<tr>
<td class="left">CTRL-n</td>
<td class="left">Next mailbox (on side bar)</td>
<td class="org-left">CTRL-n</td>
<td class="org-left">Next mailbox (on side bar)</td>
</tr>
<tr>
<td class="left">CTRL-p</td>
<td class="left">Previous mailbox (on side bar)</td>
<td class="org-left">CTRL-p</td>
<td class="org-left">Previous mailbox (on side bar)</td>
</tr>
<tr>
<td class="left">CTRL-o</td>
<td class="left">Open mailbox (on side bar)</td>
<td class="org-left">CTRL-o</td>
<td class="org-left">Open mailbox (on side bar)</td>
</tr>
<tr>
<td class="left">r</td>
<td class="left">Reply to an email</td>
<td class="org-left">r</td>
<td class="org-left">Reply to an email</td>
</tr>
<tr>
<td class="left">L</td>
<td class="left">Reply to a mailing list email</td>
<td class="org-left">L</td>
<td class="org-left">Reply to a mailing list email</td>
</tr>
<tr>
<td class="left">]</td>
<td class="left">Expand or collapse all threads</td>
<td class="org-left">]</td>
<td class="org-left">Expand or collapse all threads</td>
</tr>
<tr>
<td class="left">[</td>
<td class="left">Expand of collapse the current thread</td>
<td class="org-left">[</td>
<td class="org-left">Expand of collapse the current thread</td>
</tr>
<tr>
<td class="left">CTRL-k</td>
<td class="left">Import a PGP/GPG public key</td>
<td class="org-left">CTRL-k</td>
<td class="org-left">Import a PGP/GPG public key</td>
</tr>
<tr>
<td class="left">q</td>
<td class="left">Quit</td>
<td class="org-left">q</td>
<td class="org-left">Quit</td>
</tr>
</tbody>
</table>
@ -479,9 +484,9 @@ When reading emails you will initially need to enter your GPG password. It will
</div>
</div>
<div id="outline-container-unnumbered-8" class="outline-3">
<h3 id="unnumbered-8">Thunderbird</h3>
<div class="outline-text-3" id="text-unnumbered-8">
<div id="outline-container-orgheadline14" class="outline-3">
<h3 id="orgheadline14">Thunderbird</h3>
<div class="outline-text-3" id="text-orgheadline14">
<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.
</p>
@ -491,9 +496,9 @@ The following instructions should be carried out on the client machines (laptop,
</p>
</div>
<div id="outline-container-unnumbered-9" class="outline-4">
<h4 id="unnumbered-9">Initial setup</h4>
<div class="outline-text-4" id="text-unnumbered-9">
<div id="outline-container-orgheadline15" class="outline-4">
<h4 id="orgheadline15">Initial setup</h4>
<div class="outline-text-4" id="text-orgheadline15">
<p>
Install <b>Thunderbird</b> and <b>Enigmail</b>. How you do this just depends upon your distro and software manager or "app store".
</p>
@ -507,7 +512,7 @@ Select "<b>Skip this and use existing email</b>"
</p>
<p>
Enter your name, email address (myusername@mydomainname.com) and the password for your user (the one from <i>Add a user</i>).
Enter your name, email address (myusername@mydomainname.com) and the password for your user.
</p>
<p>
@ -515,7 +520,7 @@ You'll get a message saying "<i>Thunderbird failed to find the settings</i>"
</p>
<p>
The settings should be as follows, substituting <i>mydomainname.com</i> for your domain name and <i>myusername</i> for the username given previously in <i>Add a user</i>.
The settings should be as follows, substituting <i>mydomainname.com</i> for your domain name and <i>myusername</i> for the username.
</p>
<ul class="org-ul">
@ -549,9 +554,9 @@ Select "<b>yes</b>" to change default settings.
</p>
</div>
</div>
<div id="outline-container-unnumbered-10" class="outline-4">
<h4 id="unnumbered-10">Import your GPG keys</h4>
<div class="outline-text-4" id="text-unnumbered-10">
<div id="outline-container-orgheadline16" class="outline-4">
<h4 id="orgheadline16">Import your GPG keys</h4>
<div class="outline-text-4" id="text-orgheadline16">
<p>
On the Freedombone export your GPG public and private keys.
</p>
@ -600,9 +605,9 @@ shred -zu ~/private_key.gpg
</div>
</div>
<div id="outline-container-unnumbered-11" class="outline-4">
<h4 id="unnumbered-11">Using for the first time</h4>
<div class="outline-text-4" id="text-unnumbered-11">
<div id="outline-container-orgheadline17" class="outline-4">
<h4 id="orgheadline17">Using for the first time</h4>
<div class="outline-text-4" id="text-orgheadline17">
<p>
Click on the Thunderbird menu, which looks like three horizontal bars on the right hand side.
</p>
@ -637,9 +642,9 @@ Get into the habit of using email encryption and encourage others to do so. Rem
</div>
</div>
<div id="outline-container-unnumbered-12" class="outline-4">
<h4 id="unnumbered-12">Making folders visible</h4>
<div class="outline-text-4" id="text-unnumbered-12">
<div id="outline-container-orgheadline18" class="outline-4">
<h4 id="orgheadline18">Making folders visible</h4>
<div class="outline-text-4" id="text-orgheadline18">
<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:
</p>
@ -655,17 +660,17 @@ Make sure that "<b>show only subscribed folders</b>" is not checked. Then click
</div>
</div>
<div id="outline-container-unnumbered-13" class="outline-3">
<h3 id="unnumbered-13">K9 Android client</h3>
<div class="outline-text-3" id="text-unnumbered-13">
<div id="outline-container-orgheadline19" class="outline-3">
<h3 id="orgheadline19">K9 Android client</h3>
<div class="outline-text-3" id="text-orgheadline19">
<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.
</p>
</div>
<div id="outline-container-unnumbered-14" class="outline-4">
<h4 id="unnumbered-14">Incoming server settings</h4>
<div class="outline-text-4" id="text-unnumbered-14">
<div id="outline-container-orgheadline20" class="outline-4">
<h4 id="orgheadline20">Incoming server settings</h4>
<div class="outline-text-4" id="text-orgheadline20">
<ul class="org-ul">
<li>Select settings/account settings</li>
<li>Select Fetching mail/incoming server</li>
@ -677,9 +682,9 @@ Make sure that "<b>show only subscribed folders</b>" is not checked. Then click
</ul>
</div>
</div>
<div id="outline-container-unnumbered-15" class="outline-4">
<h4 id="unnumbered-15">Outgoing (SMTP) server settings</h4>
<div class="outline-text-4" id="text-unnumbered-15">
<div id="outline-container-orgheadline21" class="outline-4">
<h4 id="orgheadline21">Outgoing (SMTP) server settings</h4>
<div class="outline-text-4" id="text-orgheadline21">
<ul class="org-ul">
<li>Select settings/account settings</li>
<li>Select Sending mail/outgoing server</li>
@ -692,9 +697,9 @@ Make sure that "<b>show only subscribed folders</b>" is not checked. Then click
</ul>
</div>
</div>
<div id="outline-container-unnumbered-16" class="outline-4">
<h4 id="unnumbered-16">Folders</h4>
<div class="outline-text-4" id="text-unnumbered-16">
<div id="outline-container-orgheadline22" class="outline-4">
<h4 id="orgheadline22">Folders</h4>
<div class="outline-text-4" id="text-orgheadline22">
<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>.
</p>
@ -706,9 +711,9 @@ If your folder still doesn't show up then press the <b>menu button</b>, select <
</div>
</div>
<div id="outline-container-unnumbered-17" class="outline-3">
<h3 id="unnumbered-17">Subscribing to mailing lists</h3>
<div class="outline-text-3" id="text-unnumbered-17">
<div id="outline-container-orgheadline23" class="outline-3">
<h3 id="orgheadline23">Subscribing to mailing lists</h3>
<div class="outline-text-3" id="text-orgheadline23">
<p>
To subscribe to a mailing list log in as your user (i.e. not the root user).
</p>
@ -726,9 +731,9 @@ The subject tag should be the word or phrase which appears within the brackets i
</p>
</div>
</div>
<div id="outline-container-unnumbered-18" class="outline-3">
<h3 id="unnumbered-18">Adding email addresses to a group/folder</h3>
<div class="outline-text-3" id="text-unnumbered-18">
<div id="outline-container-orgheadline24" class="outline-3">
<h3 id="orgheadline24">Adding email addresses to a group/folder</h3>
<div class="outline-text-3" id="text-orgheadline24">
<p>
Similar to adding mailing list folders you can also add specified email addresses into a group/folder.
</p>
@ -747,9 +752,9 @@ The group name should be something short so that it is readable within the left
</div>
</div>
<div id="outline-container-unnumbered-19" class="outline-3">
<h3 id="unnumbered-19">Ignoring incoming emails</h3>
<div class="outline-text-3" id="text-unnumbered-19">
<div id="outline-container-orgheadline25" class="outline-3">
<h3 id="orgheadline25">Ignoring incoming emails</h3>
<div class="outline-text-3" id="text-orgheadline25">
<p>
It is possible to ignore incoming emails if they are from a particular email address or if the subject line contains particular text.
</p>
@ -780,9 +785,9 @@ You can also reverse this by using the <b>freedombone-unignore</b> command with
</div>
</div>
</div>
<div id="outline-container-unnumbered-20" class="outline-2">
<h2 id="unnumbered-20">Mailing List</h2>
<div class="outline-text-2" id="text-unnumbered-20">
<div id="outline-container-orgheadline3" class="outline-2">
<h2 id="orgheadline3">Mailing List</h2>
<div class="outline-text-2" id="text-orgheadline3">
<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.
</p>
@ -802,12 +807,12 @@ Tip: When using the Mutt email client if you want to send an email in cleartext
</p>
</div>
</div>
<div id="outline-container-unnumbered-21" class="outline-2">
<h2 id="unnumbered-21">Syncing to the Cloud</h2>
<div class="outline-text-2" id="text-unnumbered-21">
</div><div id="outline-container-unnumbered-22" class="outline-3">
<h3 id="unnumbered-22">Initial install</h3>
<div class="outline-text-3" id="text-unnumbered-22">
<div id="outline-container-orgheadline4" class="outline-2">
<h2 id="orgheadline4">Syncing to the Cloud</h2>
<div class="outline-text-2" id="text-orgheadline4">
</div><div id="outline-container-orgheadline26" class="outline-3">
<h3 id="orgheadline26">Initial install</h3>
<div class="outline-text-3" id="text-orgheadline26">
<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.
</p>
@ -820,24 +825,24 @@ You will also need to enter database details:
<colgroup>
<col class="left" />
<col class="org-left" />
<col class="left" />
<col class="org-left" />
</colgroup>
<tbody>
<tr>
<td class="left">Owncloud database user</td>
<td class="left">owncloudadmin</td>
<td class="org-left">Owncloud database user</td>
<td class="org-left">owncloudadmin</td>
</tr>
<tr>
<td class="left">Owncloud database password</td>
<td class="left">See the <a href="#unnumbered-1">Readme</a> file</td>
<td class="org-left">Owncloud database password</td>
<td class="org-left">See the <a href="#orgheadline1">Readme</a> file</td>
</tr>
<tr>
<td class="left">Owncloud database name</td>
<td class="left">owncloud</td>
<td class="org-left">Owncloud database name</td>
<td class="org-left">owncloud</td>
</tr>
</tbody>
</table>
@ -851,9 +856,9 @@ Log out from the administrator account and then log back in as the user you just
</p>
</div>
</div>
<div id="outline-container-unnumbered-23" class="outline-3">
<h3 id="unnumbered-23">On Android</h3>
<div class="outline-text-3" id="text-unnumbered-23">
<div id="outline-container-orgheadline27" class="outline-3">
<h3 id="orgheadline27">On Android</h3>
<div class="outline-text-3" id="text-orgheadline27">
<p>
Within F-droid search for <b>owncloud</b> and install the client. Also install <b>CalDAV Sync Adapter</b>.
</p>
@ -863,7 +868,7 @@ Open the owncloud app and enter your owncloud domain name (including the https p
</p>
<p>
Open the calendar app and under <b>settings</b> add a CalDav account with the url:
Open the calendar app (S planner) and under <b>settings</b> select <b>Calendars</b> then <b>Add account</b> then <b>CalDAV Sync Adapter</b>. Enter your owncloud username and password and the following URL:
</p>
<div class="org-src-container">
@ -877,9 +882,9 @@ You will also be prompted to enter login details. Your Android and Owncloud cale
</p>
</div>
</div>
<div id="outline-container-unnumbered-24" class="outline-3">
<h3 id="unnumbered-24">On Linux</h3>
<div class="outline-text-3" id="text-unnumbered-24">
<div id="outline-container-orgheadline28" class="outline-3">
<h3 id="orgheadline28">On Linux</h3>
<div class="outline-text-3" id="text-orgheadline28">
<p>
Open your software center and search for "owncloud client". Enter your owncloud domain name (with the https prefix) and login details.
</p>
@ -890,12 +895,12 @@ You can now drag files into the <b>~/owncloud</b> directory and they will automa
</div>
</div>
</div>
<div id="outline-container-unnumbered-25" class="outline-2">
<h2 id="unnumbered-25">Play Music</h2>
<div class="outline-text-2" id="text-unnumbered-25">
</div><div id="outline-container-unnumbered-26" class="outline-3">
<h3 id="unnumbered-26">With the DLNA service</h3>
<div class="outline-text-3" id="text-unnumbered-26">
<div id="outline-container-orgheadline5" class="outline-2">
<h2 id="orgheadline5">Play Music</h2>
<div class="outline-text-2" id="text-orgheadline5">
</div><div id="outline-container-orgheadline29" class="outline-3">
<h3 id="orgheadline29">With the DLNA service</h3>
<div class="outline-text-3" id="text-orgheadline29">
<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.
</p>
@ -935,9 +940,9 @@ The DLNA service will only work within your local home network, and isn't remote
</div>
</div>
<div id="outline-container-unnumbered-27" class="outline-3">
<h3 id="unnumbered-27">With Owncloud</h3>
<div class="outline-text-3" id="text-unnumbered-27">
<div id="outline-container-orgheadline30" class="outline-3">
<h3 id="orgheadline30">With Owncloud</h3>
<div class="outline-text-3" id="text-orgheadline30">
<p>
The main advantage of playing music via Owncloud is that you can do that from anywhere - not only within your home network.
</p>
@ -949,12 +954,12 @@ By default a music player is installed into Owncloud, so all you need to do is t
</div>
</div>
<div id="outline-container-unnumbered-28" class="outline-2">
<h2 id="unnumbered-28">Microblogging</h2>
<div class="outline-text-2" id="text-unnumbered-28">
</div><div id="outline-container-unnumbered-29" class="outline-3">
<h3 id="unnumbered-29">Initial configuration</h3>
<div class="outline-text-3" id="text-unnumbered-29">
<div id="outline-container-orgheadline6" class="outline-2">
<h2 id="orgheadline6">Microblogging</h2>
<div class="outline-text-2" id="text-orgheadline6">
</div><div id="outline-container-orgheadline31" class="outline-3">
<h3 id="orgheadline31">Initial configuration</h3>
<div class="outline-text-3" id="text-orgheadline31">
<p>
To set up your microblog go to:
</p>
@ -973,59 +978,59 @@ and enter the following settings:
<colgroup>
<col class="left" />
<col class="org-left" />
<col class="left" />
<col class="org-left" />
</colgroup>
<tbody>
<tr>
<td class="left">Server SSL</td>
<td class="left">enable</td>
<td class="org-left">Server SSL</td>
<td class="org-left">enable</td>
</tr>
<tr>
<td class="left">Hostname</td>
<td class="left">localhost</td>
<td class="org-left">Hostname</td>
<td class="org-left">localhost</td>
</tr>
<tr>
<td class="left">Type</td>
<td class="left">MySql/MariaDB</td>
<td class="org-left">Type</td>
<td class="org-left">MySql/MariaDB</td>
</tr>
<tr>
<td class="left">Name</td>
<td class="left">gnusocial</td>
<td class="org-left">Name</td>
<td class="org-left">gnusocial</td>
</tr>
<tr>
<td class="left">DB username</td>
<td class="left">root</td>
<td class="org-left">DB username</td>
<td class="org-left">root</td>
</tr>
<tr>
<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="org-left">DB Password</td>
<td class="org-left">See the MariaDB password in the <a href="#orgheadline1">Readme</a> file</td>
</tr>
<tr>
<td class="left">Administrator nickname</td>
<td class="left">Your username</td>
<td class="org-left">Administrator nickname</td>
<td class="org-left">Your username</td>
</tr>
<tr>
<td class="left">Administrator password</td>
<td class="left">See the <a href="#unnumbered-1">Readme</a> file</td>
<td class="org-left">Administrator password</td>
<td class="org-left">See the <a href="#orgheadline1">Readme</a> file</td>
</tr>
<tr>
<td class="left">Subscribe to announcements</td>
<td class="left">ticked</td>
<td class="org-left">Subscribe to announcements</td>
<td class="org-left">ticked</td>
</tr>
<tr>
<td class="left">Site profile</td>
<td class="left">Community</td>
<td class="org-left">Site profile</td>
<td class="org-left">Community</td>
</tr>
</tbody>
</table>
@ -1038,36 +1043,36 @@ When the install is complete you will see a lot of warnings but just ignore thos
<colgroup>
<col class="left" />
<col class="org-left" />
<col class="left" />
<col class="org-left" />
</colgroup>
<tbody>
<tr>
<td class="left">Site settings</td>
<td class="left">Text limit 140, Dupe Limit 60000</td>
<td class="org-left">Site settings</td>
<td class="org-left">Text limit 140, Dupe Limit 60000</td>
</tr>
<tr>
<td class="left">User settings</td>
<td class="left">Bio limit 1000</td>
<td class="org-left">User settings</td>
<td class="org-left">Bio limit 1000</td>
</tr>
<tr>
<td class="left">Access settings</td>
<td class="left"><i>Invite only</i> ticked</td>
<td class="org-left">Access settings</td>
<td class="org-left"><i>Invite only</i> ticked</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div id="outline-container-unnumbered-30" class="outline-2">
<h2 id="unnumbered-30">Social Network</h2>
<div class="outline-text-2" id="text-unnumbered-30">
</div><div id="outline-container-unnumbered-31" class="outline-3">
<h3 id="unnumbered-31">Certificates</h3>
<div class="outline-text-3" id="text-unnumbered-31">
<div id="outline-container-orgheadline7" class="outline-2">
<h2 id="orgheadline7">Social Network</h2>
<div class="outline-text-2" id="text-orgheadline7">
</div><div id="outline-container-orgheadline32" class="outline-3">
<h3 id="orgheadline32">Certificates</h3>
<div class="outline-text-3" id="text-orgheadline32">
<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:
</p>
@ -1084,9 +1089,9 @@ Then change ssl_certificate to <b>/etc/ssl/certs/yourredmatrixdomainname.bundle.
</p>
</div>
</div>
<div id="outline-container-unnumbered-32" class="outline-3">
<h3 id="unnumbered-32">Initial install</h3>
<div class="outline-text-3" id="text-unnumbered-32">
<div id="outline-container-orgheadline33" class="outline-3">
<h3 id="orgheadline33">Initial install</h3>
<div class="outline-text-3" id="text-orgheadline33">
<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.
</p>
@ -1097,19 +1102,19 @@ When installation is complete you can register a new user.
</div>
</div>
</div>
<div id="outline-container-unnumbered-33" class="outline-2">
<h2 id="unnumbered-33">Chat Services</h2>
<div class="outline-text-2" id="text-unnumbered-33">
</div><div id="outline-container-unnumbered-34" class="outline-3">
<h3 id="unnumbered-34">IRC</h3>
<div class="outline-text-3" id="text-unnumbered-34">
<div id="outline-container-orgheadline8" class="outline-2">
<h2 id="orgheadline8">Chat Services</h2>
<div class="outline-text-2" id="text-orgheadline8">
</div><div id="outline-container-orgheadline34" class="outline-3">
<h3 id="orgheadline34">IRC</h3>
<div class="outline-text-3" id="text-orgheadline34">
<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.
</p>
</div>
<div id="outline-container-unnumbered-35" class="outline-4">
<h4 id="unnumbered-35">Irssi</h4>
<div class="outline-text-4" id="text-unnumbered-35">
<div id="outline-container-orgheadline35" class="outline-4">
<h4 id="orgheadline35">Irssi</h4>
<div class="outline-text-4" id="text-orgheadline35">
<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.
</p>
@ -1123,9 +1128,9 @@ If you are using the <a href="http://www.irssi.org/">irssi</a> IRC client then y
</div>
</div>
</div>
<div id="outline-container-unnumbered-36" class="outline-4">
<h4 id="unnumbered-36">XChat</h4>
<div class="outline-text-4" id="text-unnumbered-36">
<div id="outline-container-orgheadline36" class="outline-4">
<h4 id="orgheadline36">XChat</h4>
<div class="outline-text-4" id="text-orgheadline36">
<p>
If you are using the XChat client:
</p>
@ -1161,12 +1166,12 @@ Click <b>close</b> and then <b>connect</b>.
</div>
</div>
<div id="outline-container-unnumbered-37" class="outline-3">
<h3 id="unnumbered-37">XMPP/Jabber</h3>
<div class="outline-text-3" id="text-unnumbered-37">
</div><div id="outline-container-unnumbered-38" class="outline-4">
<h4 id="unnumbered-38">Managing users</h4>
<div class="outline-text-4" id="text-unnumbered-38">
<div id="outline-container-orgheadline41" class="outline-3">
<h3 id="orgheadline41">XMPP/Jabber</h3>
<div class="outline-text-3" id="text-orgheadline41">
</div><div id="outline-container-orgheadline37" class="outline-4">
<h4 id="orgheadline37">Managing users</h4>
<div class="outline-text-4" id="text-orgheadline37">
<p>
To add a user:
</p>
@ -1225,9 +1230,9 @@ prosodyctl status
</div>
</div>
<div id="outline-container-unnumbered-39" class="outline-4">
<h4 id="unnumbered-39">Using with Jitsi</h4>
<div class="outline-text-4" id="text-unnumbered-39">
<div id="outline-container-orgheadline38" class="outline-4">
<h4 id="orgheadline38">Using with Jitsi</h4>
<div class="outline-text-4" id="text-orgheadline38">
<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.
</p>
@ -1257,9 +1262,9 @@ You can also <a href="https://www.youtube.com/watch?v=vgx7VSrDGjk">see this vide
</p>
</div>
</div>
<div id="outline-container-unnumbered-40" class="outline-4">
<h4 id="unnumbered-40">Using with Ubuntu</h4>
<div class="outline-text-4" id="text-unnumbered-40">
<div id="outline-container-orgheadline39" class="outline-4">
<h4 id="orgheadline39">Using with Ubuntu</h4>
<div class="outline-text-4" id="text-orgheadline39">
<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.
</p>
@ -1277,9 +1282,9 @@ Click on <b>Advanced</b> and make sure that <b>Encryption required</b> and <b>Ig
</p>
</div>
</div>
<div id="outline-container-unnumbered-41" class="outline-4">
<h4 id="unnumbered-41">Using with Android</h4>
<div class="outline-text-4" id="text-unnumbered-41">
<div id="outline-container-orgheadline40" class="outline-4">
<h4 id="orgheadline40">Using with Android</h4>
<div class="outline-text-4" id="text-orgheadline40">
<p>
Install <a href="https://f-droid.org/">F-Droid</a>
</p>
@ -1306,12 +1311,34 @@ Go back to the initial screen and then using the menu you can add contacts and b
</div>
</div>
</div>
<div id="outline-container-unnumbered-42" class="outline-3">
<h3 id="unnumbered-42">VoIP (Voice chat)</h3>
<div class="outline-text-3" id="text-unnumbered-42">
</div><div id="outline-container-unnumbered-43" class="outline-4">
<h4 id="unnumbered-43">Using with Ubuntu</h4>
<div class="outline-text-4" id="text-unnumbered-43">
<div id="outline-container-orgheadline42" class="outline-3">
<h3 id="orgheadline42">Tox</h3>
<div class="outline-text-3" id="text-orgheadline42">
<p>
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.
</p>
</div>
<div id="outline-container-orgheadline43" class="outline-4">
<h4 id="orgheadline43">Using the Toxic client</h4>
<div class="outline-text-4" id="text-orgheadline43">
<p>
To connect to your node use the command:
</p>
<div class="org-src-container">
<pre class="src src-bash">/connect [yourdomainname] 33445 [your tox node ID]
</pre>
</div>
</div>
</div>
</div>
<div id="outline-container-orgheadline46" class="outline-3">
<h3 id="orgheadline46">VoIP (Voice chat)</h3>
<div class="outline-text-3" id="text-orgheadline46">
</div><div id="outline-container-orgheadline44" class="outline-4">
<h4 id="orgheadline44">Using with Ubuntu</h4>
<div class="outline-text-4" id="text-orgheadline44">
<p>
Within the software center search for "mumble" and install the client then run it. Skip through the audio setup wizard.
</p>
@ -1325,9 +1352,9 @@ Click on "add new" to add a new server and enter the default domain name for the
</p>
</div>
</div>
<div id="outline-container-unnumbered-44" class="outline-4">
<h4 id="unnumbered-44">Using with Android</h4>
<div class="outline-text-4" id="text-unnumbered-44">
<div id="outline-container-orgheadline45" class="outline-4">
<h4 id="orgheadline45">Using with Android</h4>
<div class="outline-text-4" id="text-orgheadline45">
<p>
Install <a href="https://f-droid.org/">F-Droid</a>
</p>