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

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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
doc/EN/usage.org
View File

@ -4,11 +4,27 @@
#+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
#+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
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
ssh username@domain -p 2222
su
control
sudo control
#+END_SRC
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*.
*** 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
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./
** 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
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 826 KiB

197
website/EN/usage.html
View File

@ -4,7 +4,7 @@
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<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 name="generator" content="Org-mode" />
<meta name="author" content="Bob Mottram" />
@ -154,47 +154,54 @@ for the JavaScript code in this tag.
<a name="top" id="top"></a>
</div>
<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">
<p><img src="./images/logo.png" alt="logo.png" />
</p>
</div>
</div>
<font color="white">.</font>
<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
<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" />
</colgroup>
<tbody>
<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="#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>
<tr>
<td class="org-left"><a href="#orgheadline2">Improving ssh security</a></td>
</tr>
<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>
</tbody>
</table>
@ -222,9 +229,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-orgheadline9" class="outline-2">
<h2 id="orgheadline9">Improving ssh security</h2>
<div class="outline-text-2" id="text-orgheadline9">
<div id="outline-container-orgheadline2" class="outline-2">
<h2 id="orgheadline2">Improving ssh security</h2>
<div class="outline-text-2" id="text-orgheadline2">
<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>
@ -250,22 +257,22 @@ For extra security you may also want to add a passphrase to the ssh private key.
</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:
Log into your system and open the control panel.
</p>
<div class="org-src-container">
<pre class="src src-bash">ssh username@domain -p 2222
emacs ~/.ssh/authorized_keys
sudo control
</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.
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>
@ -273,14 +280,14 @@ There are advantages and disadvantages to using ssh keys for logins. The advanta
</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>
</div>
</div>
<div id="outline-container-orgheadline2" class="outline-2">
<h2 id="orgheadline2">Using Email</h2>
<div class="outline-text-2" id="text-orgheadline2">
<div id="outline-container-orgheadline3" class="outline-2">
<h2 id="orgheadline3">Using Email</h2>
<div class="outline-text-2" id="text-orgheadline3">
</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">
@ -1049,9 +1056,9 @@ You can also reverse this by using the <b>freedombone-unignore</b> command with
</div>
</div>
</div>
<div id="outline-container-orgheadline3" class="outline-2">
<h2 id="orgheadline3">Mailing List</h2>
<div class="outline-text-2" id="text-orgheadline3">
<div id="outline-container-orgheadline4" class="outline-2">
<h2 id="orgheadline4">Mailing List</h2>
<div class="outline-text-2" id="text-orgheadline4">
<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>
@ -1071,9 +1078,9 @@ Tip: When using the Mutt email client if you want to send an email in cleartext
</p>
</div>
</div>
<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 id="outline-container-orgheadline5" class="outline-2">
<h2 id="orgheadline5">Syncing to the Cloud</h2>
<div class="outline-text-2" id="text-orgheadline5">
</div><div id="outline-container-orgheadline30" class="outline-3">
<h3 id="orgheadline30">Initial install</h3>
<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 id="outline-container-orgheadline5" class="outline-2">
<h2 id="orgheadline5">Play Music</h2>
<div class="outline-text-2" id="text-orgheadline5">
<div id="outline-container-orgheadline6" class="outline-2">
<h2 id="orgheadline6">Play Music</h2>
<div class="outline-text-2" id="text-orgheadline6">
</div><div id="outline-container-orgheadline33" class="outline-3">
<h3 id="orgheadline33">With the DLNA service</h3>
<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 id="outline-container-orgheadline6" class="outline-2">
<h2 id="orgheadline6">Microblogging</h2>
<div class="outline-text-2" id="text-orgheadline6">
<div id="outline-container-orgheadline7" class="outline-2">
<h2 id="orgheadline7">Microblogging</h2>
<div class="outline-text-2" id="text-orgheadline7">
</div><div id="outline-container-orgheadline35" class="outline-3">
<h3 id="orgheadline35">Initial configuration</h3>
<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 id="outline-container-orgheadline7" class="outline-2">
<h2 id="orgheadline7">Social Network</h2>
<div class="outline-text-2" id="text-orgheadline7">
<div id="outline-container-orgheadline8" class="outline-2">
<h2 id="orgheadline8">Social Network</h2>
<div class="outline-text-2" id="text-orgheadline8">
</div><div id="outline-container-orgheadline36" class="outline-3">
<h3 id="orgheadline36">Certificates</h3>
<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 id="outline-container-orgheadline8" class="outline-2">
<h2 id="orgheadline8">Chat Services</h2>
<div class="outline-text-2" id="text-orgheadline8">
<div id="outline-container-orgheadline9" class="outline-2">
<h2 id="orgheadline9">Chat Services</h2>
<div class="outline-text-2" id="text-orgheadline9">
</div><div id="outline-container-orgheadline38" class="outline-3">
<h3 id="orgheadline38">IRC</h3>
<div class="outline-text-3" id="text-orgheadline38">
@ -1430,9 +1437,9 @@ Click <b>close</b> and then <b>connect</b>.
</div>
</div>
<div id="outline-container-orgheadline45" class="outline-3">
<h3 id="orgheadline45">XMPP/Jabber</h3>
<div class="outline-text-3" id="text-orgheadline45">
<div id="outline-container-orgheadline46" class="outline-3">
<h3 id="orgheadline46">XMPP/Jabber</h3>
<div class="outline-text-3" id="text-orgheadline46">
</div><div id="outline-container-orgheadline41" class="outline-4">
<h4 id="orgheadline41">Managing users</h4>
<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 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">
<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>
</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 id="outline-container-orgheadline46" class="outline-3">
<h3 id="orgheadline46">Tox</h3>
<div class="outline-text-3" id="text-orgheadline46">
<div id="outline-container-orgheadline47" class="outline-3">
<h3 id="orgheadline47">Tox</h3>
<div class="outline-text-3" id="text-orgheadline47">
<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-orgheadline47" class="outline-4">
<h4 id="orgheadline47">Using the Toxic client</h4>
<div class="outline-text-4" id="text-orgheadline47">
<div id="outline-container-orgheadline48" class="outline-4">
<h4 id="orgheadline48">Using the Toxic client</h4>
<div class="outline-text-4" id="text-orgheadline48">
<p>
To connect to your node use the command:
</p>
@ -1597,12 +1612,12 @@ To connect to your node use the command:
</div>
</div>
</div>
<div id="outline-container-orgheadline50" class="outline-3">
<h3 id="orgheadline50">VoIP (Voice chat)</h3>
<div class="outline-text-3" id="text-orgheadline50">
</div><div id="outline-container-orgheadline48" class="outline-4">
<h4 id="orgheadline48">Using with Ubuntu</h4>
<div class="outline-text-4" id="text-orgheadline48">
<div id="outline-container-orgheadline51" class="outline-3">
<h3 id="orgheadline51">VoIP (Voice chat)</h3>
<div class="outline-text-3" id="text-orgheadline51">
</div><div id="outline-container-orgheadline49" class="outline-4">
<h4 id="orgheadline49">Using with Ubuntu</h4>
<div class="outline-text-4" id="text-orgheadline49">
<p>
Within the software center search for "mumble" and install the client then run it. Skip through the audio setup wizard.
</p>
@ -1616,9 +1631,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-orgheadline49" class="outline-4">
<h4 id="orgheadline49">Using with Android</h4>
<div class="outline-text-4" id="text-orgheadline49">
<div id="outline-container-orgheadline50" class="outline-4">
<h4 id="orgheadline50">Using with Android</h4>
<div class="outline-text-4" id="text-orgheadline50">
<p>
Install <a href="https://f-droid.org/">F-Droid</a>
</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 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 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">
<style type="text/css">