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

Update documentation for rss reader

This commit is contained in:
Bob Mottram 2016-02-23 11:45:39 +00:00
parent 54245f6d26
commit 9021c1e801
2 changed files with 19 additions and 41 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
doc/EN/usage.org
View File

@ -324,30 +324,20 @@ Selecting the server by pressing on it then connects you to the server so that y
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.
* RSS Reader
If you check the readme file within your home directory then you will be able to find out the onion address for the RSS reader which exists on most variants of Freedombone. The address can also be found on the control panel About screen.
The way that RSS reading is set up on Freedombone gives you strong reading privacy. Not only is there onion routing between you and the server but also between the server and the source of the RSS feed. The only down side is that many RSS feeds are still http only, and so could be vulnerable to injection attacks, but it's expected that more of this will go to https in the foreseeable future due to a combination of growing recognition of security issues and systems like Let's Encrypt which make obtaining certificates much easier.
See the control panel for the RSS reader onion address.
#+BEGIN_SRC bash
ssh username@domainname -p 2222
emacs README
exit
sudo control
#+END_SRC
Then select the *About* screen.
The RSS reader is accessible only via an onion address. This provides a reasonable degree of reading privacy, making it difficult for passive adversaries such as governments or corporations to create lists of sites which you are subscribed to.
To set up the system open http://rss_reader_onion_address/ and enter:
* Database type: MySQL
* Username: root
* Password: [MariaDB database root password]
* Database name: ttrss
* Host name: localhost
* Port: 3306
* Tiny Tint RSS URL: http://rss_reader_onion_address/
Click *Test configuration* and then *Initialize database*. You may need to click *Save configuration*.
Initially log in with username *admin* and password *password*.
Then go to *Preferences/Users*, click on the *admin* user and then change the password. You will immediately see what looks like an authorisation error, so log out and log back in with username "admin" and your new password.
To set up the system open http://rss_reader_onion_address/. Initially log in with username *admin* and password *password*. Then go to *Preferences/Users*, click on the *admin* user and then change the password. You will immediately see what looks like an authorisation error, so log out and log back in with username "admin" and your new password.
To access the RSS reader from a mobile device you can install a Tor compatible browser such as [[https://f-droid.org/wiki/page/info.guardianproject.orfox][OrFox]]. It will try to automatically change to the mobile version of the user interface, but if that doesn't work then navigate to http://rss_reader_onion_address/mobile.

36
website/EN/usage.html
View File

@ -3,7 +3,7 @@
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<!-- 2016-02-15 Mon 09:15 -->
<!-- 2016-02-23 Tue 11:45 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title></title>
@ -858,42 +858,30 @@ Freedombone also supports SIP phones The username and domain is the same as for
<h2 id="orgheadline9">RSS Reader</h2>
<div class="outline-text-2" id="text-orgheadline9">
<p>
If you check the readme file within your home directory then you will be able to find out the onion address for the RSS reader which exists on most variants of Freedombone. The address can also be found on the control panel About screen.
The way that RSS reading is set up on Freedombone gives you strong reading privacy. Not only is there onion routing between you and the server but also between the server and the source of the RSS feed. The only down side is that many RSS feeds are still http only, and so could be vulnerable to injection attacks, but it's expected that more of this will go to https in the foreseeable future due to a combination of growing recognition of security issues and systems like Let's Encrypt which make obtaining certificates much easier.
</p>
<p>
See the control panel for the RSS reader onion address.
</p>
<div class="org-src-container">
<pre class="src src-bash">ssh username@domainname -p 2222
emacs README
<span class="org-keyword">exit</span>
sudo control
</pre>
</div>
<p>
Then select the <b>About</b> screen.
</p>
<p>
The RSS reader is accessible only via an onion address. This provides a reasonable degree of reading privacy, making it difficult for passive adversaries such as governments or corporations to create lists of sites which you are subscribed to.
</p>
<p>
To set up the system open <a href="http://rss_reader_onion_address/">http://rss_reader_onion_address/</a> and enter:
</p>
<ul class="org-ul">
<li>Database type: MySQL</li>
<li>Username: root</li>
<li>Password: [MariaDB database root password]</li>
<li>Database name: ttrss</li>
<li>Host name: localhost</li>
<li>Port: 3306</li>
<li>Tiny Tint RSS URL: <a href="http://rss_reader_onion_address/">http://rss_reader_onion_address/</a></li>
</ul>
<p>
Click <b>Test configuration</b> and then <b>Initialize database</b>. You may need to click <b>Save configuration</b>.
Initially log in with username <b>admin</b> and password <b>password</b>.
</p>
<p>
Then go to <b>Preferences/Users</b>, click on the <b>admin</b> user and then change the password. You will immediately see what looks like an authorisation error, so log out and log back in with username "admin" and your new password.
To set up the system open <a href="http://rss_reader_onion_address/">http://rss_reader_onion_address/</a>. Initially log in with username <b>admin</b> and password <b>password</b>. Then go to <b>Preferences/Users</b>, click on the <b>admin</b> user and then change the password. You will immediately see what looks like an authorisation error, so log out and log back in with username "admin" and your new password.
</p>
<p>