usage picture

This commit is contained in:
Bob Mottram 2015-12-16 19:56:29 +00:00
parent d17f888363
commit d52bef4645
3 changed files with 141 additions and 90 deletions

View File

@ -4,11 +4,27 @@
#+KEYWORDS: freedombox, debian, beaglebone, hubzilla, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber #+KEYWORDS: freedombox, debian, beaglebone, hubzilla, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber
#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server #+DESCRIPTION: Turn the Beaglebone Black into a personal communications server
#+OPTIONS: ^:nil toc:nil #+OPTIONS: ^:nil toc:nil
#+BEGIN_CENTER
[[./images/logo.png]]
#+END_CENTER
| [[file:index.html][Home]] | [[Readme]] | [[Using Email]] | [[Mailing List]] | [[Syncing to the Cloud]] | [[Play Music]] | [[Microblogging]] | [[Social Network]] | [[Chat Services]] | #+BEGIN_HTML
<center>
<a href="index.html"><img style="max-width: 100%; max-height: 100%; padding: 0; margin: 0; display: block; width:100%; top: 0; left: 0; float:right;" src="images/network.png"/></a>
</center>
<br><br><br><br><br>
#+END_HTML
#+BEGIN_HTML
<font color="white">.</font>
#+END_HTML
| [[Readme]] |
| [[Improving ssh security]] |
| [[Using Email]] |
| [[Mailing List]] |
| [[Syncing to the Cloud]] |
| [[Play Music]] |
| [[Microblogging]] |
| [[Social Network]] |
| [[Chat Services]] |
* Readme * Readme
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:
@ -40,8 +56,7 @@ Log into your system and open the control panel.
#+BEGIN_SRC bash #+BEGIN_SRC bash
ssh username@domain -p 2222 ssh username@domain -p 2222
su sudo control
control
#+END_SRC #+END_SRC
Select /Manage Users/ then /Change user ssh public key/. Copy and paste the public key here, then exit. Select /Manage Users/ then /Change user ssh public key/. Copy and paste the public key here, then exit.
@ -678,7 +693,7 @@ Enter your username (username@domainname) and password.
Click on *Advanced* and make sure that *Encryption required* and *Ignore SSL certificate errors* are checked. Ignoring the certificate errors will allow you to use the self-signed certificate created earlier. Then click *Done* and set your Jabber account and Empathy to *On*. Click on *Advanced* and make sure that *Encryption required* and *Ignore SSL certificate errors* are checked. Ignoring the certificate errors will allow you to use the self-signed certificate created earlier. Then click *Done* and set your Jabber account and Empathy to *On*.
*** Using Tor Messenger *** Using Tor Messenger
Tor Messenger is a messaging client which supports XMPP, and its onion routing enables you to protect the metadata of chat interactions to some extent by making it difficult for an adversary to know which server is talking to which. You can download Tor Messenger from [[torproject.org]] and the setup is pretty simple. Tor Messenger is a messaging client which supports XMPP, and its onion routing enables you to protect the metadata of chat interactions to some extent by making it difficult for an adversary to know which server is talking to which. You can download Tor Messenger from [[https://torproject.org][torproject.org]] and the setup is pretty simple.
*** Using with Android *** Using with Android
Install [[https://f-droid.org/][F-Droid]] Install [[https://f-droid.org/][F-Droid]]
@ -719,4 +734,7 @@ Selecting the server by pressing on it then connects you to the server so that y
/Note: if you don't know the default domain name and you did a full installation then it will be the same as the wiki domain name./ /Note: if you don't know the default domain name and you did a full installation then it will be the same as the wiki domain name./
** SIP phones ** SIP phones
Freedombone also supports SIP phones The username and domain is the same as for your email address, and the SIP password and extension number will appear within the README file in your home directory. Various SIP client options are available, such as CSipSimple on Android and Jitsi on desktop or laptop machines. Ideally use clients which support ZRTP, which will provide the best level of security. Freedombone also supports SIP phones The username and domain is the same as for your email address, and the SIP password and extension number will appear within the README file in your home directory. Various SIP client options are available, such as CSipSimple on Android and Jitsi on desktop or laptop machines. Ideally use clients which support ZRTP, which will provide the best level of security.[fn:1]
[fn:1] Picture by [[https://www.flickr.com/photos/chanceprojects/16428389357/in/photolist-r2HMNn-fjSsGA-AC97hw-o8VN4t-o9E3R2-7Jukfe-yFYFcj-7imfPW-7AxaHC-9paZ9X-4Ut5PG-9XEDKe-9XHvyQ-8VEWGu-8W1azK-7EGNmd-fGHxic-9GkDTP-zLBfiV-fGHurR-qRMYzp-bqHnh2-e2yu7B-9gkk24-2z2s35-2yX4m2-r6VEkh-91g7v9-9ptxJn-fHWton-rymKbZ-9tGirx-fGHuV2-5TfydJ-9oNAuY-od51v3-51QxYW-buf1br-fGHwUV-9EBUqv-rtyL6v-7rq8Qt-5QTEFc-7SGnU2-8sD9kL-7SGnVt-mnrvP-a3gCpa-qwW37Z-fmw7Bt][Neil Cummings]], CC BY-SA 2.0

BIN
img/network.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 826 KiB

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>
<!-- 2015-10-28 Wed 22:55 --> <!-- 2015-12-16 Wed 19:51 -->
<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" />
@ -154,47 +154,54 @@ for the JavaScript code in this tag.
<a name="top" id="top"></a> <a name="top" id="top"></a>
</div> </div>
<div id="content"> <div id="content">
<div class="center"> <center>
<a href="index.html"><img style="max-width: 100%; max-height: 100%; padding: 0; margin: 0; display: block; width:100%; top: 0; left: 0; float:right;" src="images/network.png"/></a>
</center>
<br><br><br><br><br>
<div class="figure"> <font color="white">.</font>
<p><img src="./images/logo.png" alt="logo.png" />
</p>
</div>
</div>
<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides"> <table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
<colgroup> <colgroup>
<col class="org-left" />
<col class="org-left" />
<col class="org-left" />
<col class="org-left" />
<col class="org-left" />
<col class="org-left" />
<col class="org-left" />
<col class="org-left" />
<col class="org-left" /> <col class="org-left" />
</colgroup> </colgroup>
<tbody> <tbody>
<tr> <tr>
<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="#orgheadline1">Readme</a></td>
<td class="org-left"><a href="#orgheadline2">Using Email</a></td> </tr>
<td class="org-left"><a href="#orgheadline3">Mailing List</a></td>
<td class="org-left"><a href="#orgheadline4">Syncing to the Cloud</a></td> <tr>
<td class="org-left"><a href="#orgheadline5">Play Music</a></td> <td class="org-left"><a href="#orgheadline2">Improving ssh security</a></td>
<td class="org-left"><a href="#orgheadline6">Microblogging</a></td> </tr>
<td class="org-left"><a href="#orgheadline7">Social Network</a></td>
<td class="org-left"><a href="#orgheadline8">Chat Services</a></td> <tr>
<td class="org-left"><a href="#orgheadline3">Using Email</a></td>
</tr>
<tr>
<td class="org-left"><a href="#orgheadline4">Mailing List</a></td>
</tr>
<tr>
<td class="org-left"><a href="#orgheadline5">Syncing to the Cloud</a></td>
</tr>
<tr>
<td class="org-left"><a href="#orgheadline6">Play Music</a></td>
</tr>
<tr>
<td class="org-left"><a href="#orgheadline7">Microblogging</a></td>
</tr>
<tr>
<td class="org-left"><a href="#orgheadline8">Social Network</a></td>
</tr>
<tr>
<td class="org-left"><a href="#orgheadline9">Chat Services</a></td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
@ -222,9 +229,9 @@ 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-orgheadline9" class="outline-2"> <div id="outline-container-orgheadline2" class="outline-2">
<h2 id="orgheadline9">Improving ssh security</h2> <h2 id="orgheadline2">Improving ssh security</h2>
<div class="outline-text-2" id="text-orgheadline9"> <div class="outline-text-2" id="text-orgheadline2">
<p> <p>
To improve ssh security you can generate an ssh key pair on your system and then upload the public key to the Freedombone. To improve ssh security you can generate an ssh key pair on your system and then upload the public key to the Freedombone.
</p> </p>
@ -250,22 +257,22 @@ For extra security you may also want to add a passphrase to the ssh private key.
</div> </div>
<p> <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. Log into your system and open the control panel.
</p>
<p>
ssh to the Freedombone and edit the authorized keys:
</p> </p>
<div class="org-src-container"> <div class="org-src-container">
<pre class="src src-bash">ssh username@domain -p 2222 <pre class="src src-bash">ssh username@domain -p 2222
emacs ~/.ssh/authorized_keys sudo control
</pre> </pre>
</div> </div>
<p> <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. Select <i>Manage Users</i> then <i>Change user ssh public key</i>. Copy and paste the public key here, then exit.
</p>
<p>
It's a good idea to also 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>
<p> <p>
@ -273,14 +280,14 @@ There are advantages and disadvantages to using ssh keys for logins. The advanta
</p> </p>
<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. If you wish to only use ssh keys then log in to the Freedombone, become the root user and open the control panel with the 'control' command. Select <i>Security Settings</i> then keep hitting enter until you reach the question about allowing password logins. Select "no" for that, then apply the settings. Any subsequent attempts to log in via a password will then be denied.
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-orgheadline2" class="outline-2"> <div id="outline-container-orgheadline3" class="outline-2">
<h2 id="orgheadline2">Using Email</h2> <h2 id="orgheadline3">Using Email</h2>
<div class="outline-text-2" id="text-orgheadline2"> <div class="outline-text-2" id="text-orgheadline3">
</div><div id="outline-container-orgheadline10" class="outline-3"> </div><div id="outline-container-orgheadline10" class="outline-3">
<h3 id="orgheadline10">A technical note about email transport security</h3> <h3 id="orgheadline10">A technical note about email transport security</h3>
<div class="outline-text-3" id="text-orgheadline10"> <div class="outline-text-3" id="text-orgheadline10">
@ -1049,9 +1056,9 @@ You can also reverse this by using the <b>freedombone-unignore</b> command with
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-orgheadline3" class="outline-2"> <div id="outline-container-orgheadline4" class="outline-2">
<h2 id="orgheadline3">Mailing List</h2> <h2 id="orgheadline4">Mailing List</h2>
<div class="outline-text-2" id="text-orgheadline3"> <div class="outline-text-2" id="text-orgheadline4">
<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>
@ -1071,9 +1078,9 @@ 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-orgheadline4" class="outline-2"> <div id="outline-container-orgheadline5" class="outline-2">
<h2 id="orgheadline4">Syncing to the Cloud</h2> <h2 id="orgheadline5">Syncing to the Cloud</h2>
<div class="outline-text-2" id="text-orgheadline4"> <div class="outline-text-2" id="text-orgheadline5">
</div><div id="outline-container-orgheadline30" class="outline-3"> </div><div id="outline-container-orgheadline30" class="outline-3">
<h3 id="orgheadline30">Initial install</h3> <h3 id="orgheadline30">Initial install</h3>
<div class="outline-text-3" id="text-orgheadline30"> <div class="outline-text-3" id="text-orgheadline30">
@ -1159,9 +1166,9 @@ 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-orgheadline5" class="outline-2"> <div id="outline-container-orgheadline6" class="outline-2">
<h2 id="orgheadline5">Play Music</h2> <h2 id="orgheadline6">Play Music</h2>
<div class="outline-text-2" id="text-orgheadline5"> <div class="outline-text-2" id="text-orgheadline6">
</div><div id="outline-container-orgheadline33" class="outline-3"> </div><div id="outline-container-orgheadline33" class="outline-3">
<h3 id="orgheadline33">With the DLNA service</h3> <h3 id="orgheadline33">With the DLNA service</h3>
<div class="outline-text-3" id="text-orgheadline33"> <div class="outline-text-3" id="text-orgheadline33">
@ -1218,9 +1225,9 @@ 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-orgheadline6" class="outline-2"> <div id="outline-container-orgheadline7" class="outline-2">
<h2 id="orgheadline6">Microblogging</h2> <h2 id="orgheadline7">Microblogging</h2>
<div class="outline-text-2" id="text-orgheadline6"> <div class="outline-text-2" id="text-orgheadline7">
</div><div id="outline-container-orgheadline35" class="outline-3"> </div><div id="outline-container-orgheadline35" class="outline-3">
<h3 id="orgheadline35">Initial configuration</h3> <h3 id="orgheadline35">Initial configuration</h3>
<div class="outline-text-3" id="text-orgheadline35"> <div class="outline-text-3" id="text-orgheadline35">
@ -1331,9 +1338,9 @@ 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-orgheadline7" class="outline-2"> <div id="outline-container-orgheadline8" class="outline-2">
<h2 id="orgheadline7">Social Network</h2> <h2 id="orgheadline8">Social Network</h2>
<div class="outline-text-2" id="text-orgheadline7"> <div class="outline-text-2" id="text-orgheadline8">
</div><div id="outline-container-orgheadline36" class="outline-3"> </div><div id="outline-container-orgheadline36" class="outline-3">
<h3 id="orgheadline36">Certificates</h3> <h3 id="orgheadline36">Certificates</h3>
<div class="outline-text-3" id="text-orgheadline36"> <div class="outline-text-3" id="text-orgheadline36">
@ -1366,9 +1373,9 @@ When installation is complete you can register a new user.
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-orgheadline8" class="outline-2"> <div id="outline-container-orgheadline9" class="outline-2">
<h2 id="orgheadline8">Chat Services</h2> <h2 id="orgheadline9">Chat Services</h2>
<div class="outline-text-2" id="text-orgheadline8"> <div class="outline-text-2" id="text-orgheadline9">
</div><div id="outline-container-orgheadline38" class="outline-3"> </div><div id="outline-container-orgheadline38" class="outline-3">
<h3 id="orgheadline38">IRC</h3> <h3 id="orgheadline38">IRC</h3>
<div class="outline-text-3" id="text-orgheadline38"> <div class="outline-text-3" id="text-orgheadline38">
@ -1430,9 +1437,9 @@ Click <b>close</b> and then <b>connect</b>.
</div> </div>
</div> </div>
<div id="outline-container-orgheadline45" class="outline-3"> <div id="outline-container-orgheadline46" class="outline-3">
<h3 id="orgheadline45">XMPP/Jabber</h3> <h3 id="orgheadline46">XMPP/Jabber</h3>
<div class="outline-text-3" id="text-orgheadline45"> <div class="outline-text-3" id="text-orgheadline46">
</div><div id="outline-container-orgheadline41" class="outline-4"> </div><div id="outline-container-orgheadline41" class="outline-4">
<h4 id="orgheadline41">Managing users</h4> <h4 id="orgheadline41">Managing users</h4>
<div class="outline-text-4" id="text-orgheadline41"> <div class="outline-text-4" id="text-orgheadline41">
@ -1547,9 +1554,17 @@ Click on <b>Advanced</b> and make sure that <b>Encryption required</b> and <b>Ig
</div> </div>
</div> </div>
<div id="outline-container-orgheadline44" class="outline-4"> <div id="outline-container-orgheadline44" class="outline-4">
<h4 id="orgheadline44">Using with Android</h4> <h4 id="orgheadline44">Using Tor Messenger</h4>
<div class="outline-text-4" id="text-orgheadline44"> <div class="outline-text-4" id="text-orgheadline44">
<p> <p>
Tor Messenger is a messaging client which supports XMPP, and its onion routing enables you to protect the metadata of chat interactions to some extent by making it difficult for an adversary to know which server is talking to which. You can download Tor Messenger from <a href="https://torproject.org/">torproject.org</a> and the setup is pretty simple.
</p>
</div>
</div>
<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> Install <a href="https://f-droid.org/">F-Droid</a>
</p> </p>
@ -1575,16 +1590,16 @@ Go back to the initial screen and then using the menu you can add contacts and b
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-orgheadline46" class="outline-3"> <div id="outline-container-orgheadline47" class="outline-3">
<h3 id="orgheadline46">Tox</h3> <h3 id="orgheadline47">Tox</h3>
<div class="outline-text-3" id="text-orgheadline46"> <div class="outline-text-3" id="text-orgheadline47">
<p> <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. 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> </p>
</div> </div>
<div id="outline-container-orgheadline47" class="outline-4"> <div id="outline-container-orgheadline48" class="outline-4">
<h4 id="orgheadline47">Using the Toxic client</h4> <h4 id="orgheadline48">Using the Toxic client</h4>
<div class="outline-text-4" id="text-orgheadline47"> <div class="outline-text-4" id="text-orgheadline48">
<p> <p>
To connect to your node use the command: To connect to your node use the command:
</p> </p>
@ -1597,12 +1612,12 @@ To connect to your node use the command:
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-orgheadline50" class="outline-3"> <div id="outline-container-orgheadline51" class="outline-3">
<h3 id="orgheadline50">VoIP (Voice chat)</h3> <h3 id="orgheadline51">VoIP (Voice chat)</h3>
<div class="outline-text-3" id="text-orgheadline50"> <div class="outline-text-3" id="text-orgheadline51">
</div><div id="outline-container-orgheadline48" class="outline-4"> </div><div id="outline-container-orgheadline49" class="outline-4">
<h4 id="orgheadline48">Using with Ubuntu</h4> <h4 id="orgheadline49">Using with Ubuntu</h4>
<div class="outline-text-4" id="text-orgheadline48"> <div class="outline-text-4" id="text-orgheadline49">
<p> <p>
Within the software center search for "mumble" and install the client then run it. Skip through the audio setup wizard. Within the software center search for "mumble" and install the client then run it. Skip through the audio setup wizard.
</p> </p>
@ -1616,9 +1631,9 @@ Click on "add new" to add a new server and enter the default domain name for the
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-orgheadline49" class="outline-4"> <div id="outline-container-orgheadline50" class="outline-4">
<h4 id="orgheadline49">Using with Android</h4> <h4 id="orgheadline50">Using with Android</h4>
<div class="outline-text-4" id="text-orgheadline49"> <div class="outline-text-4" id="text-orgheadline50">
<p> <p>
Install <a href="https://f-droid.org/">F-Droid</a> Install <a href="https://f-droid.org/">F-Droid</a>
</p> </p>
@ -1645,8 +1660,26 @@ Selecting the server by pressing on it then connects you to the server so that y
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-orgheadline52" class="outline-3">
<h3 id="orgheadline52">SIP phones</h3>
<div class="outline-text-3" id="text-orgheadline52">
<p>
Freedombone also supports SIP phones The username and domain is the same as for your email address, and the SIP password and extension number will appear within the README file in your home directory. Various SIP client options are available, such as CSipSimple on Android and Jitsi on desktop or laptop machines. Ideally use clients which support ZRTP, which will provide the best level of security.<sup><a id="fnr.1" class="footref" href="#fn.1">1</a></sup>
</p>
</div> </div>
</div> </div>
</div>
<div id="footnotes">
<h2 class="footnotes">Footnotes: </h2>
<div id="text-footnotes">
<div class="footdef"><sup><a id="fn.1" class="footnum" href="#fnr.1">1</a></sup> <p class="footpara">
Picture by <a href="https://www.flickr.com/photos/chanceprojects/16428389357/in/photolist-r2HMNn-fjSsGA-AC97hw-o8VN4t-o9E3R2-7Jukfe-yFYFcj-7imfPW-7AxaHC-9paZ9X-4Ut5PG-9XEDKe-9XHvyQ-8VEWGu-8W1azK-7EGNmd-fGHxic-9GkDTP-zLBfiV-fGHurR-qRMYzp-bqHnh2-e2yu7B-9gkk24-2z2s35-2yX4m2-r6VEkh-91g7v9-9ptxJn-fHWton-rymKbZ-9tGirx-fGHuV2-5TfydJ-9oNAuY-od51v3-51QxYW-buf1br-fGHwUV-9EBUqv-rtyL6v-7rq8Qt-5QTEFc-7SGnU2-8sD9kL-7SGnVt-mnrvP-a3gCpa-qwW37Z-fmw7Bt">Neil Cummings</a>, CC BY-SA 2.0
</p></div>
</div>
</div></div>
<div id="postamble" class="status"> <div id="postamble" class="status">
<style type="text/css"> <style type="text/css">