free
/
freedombone
Watch 1
Star 0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
Browse Source

Gogs usage

Bob Mottram 8 years ago
parent
4bae0f73ea
commit
dbd9010e2a
2 changed files with 187 additions and 120 deletions
Split View Show Diff Stats
  1. 24
    1
      doc/EN/usage.org
  2. 163
    119
      website/EN/usage.html

+ 24
- 1
doc/EN/usage.org View File 

@@ -19,7 +19,7 @@
19 19 
 | [[Readme]]                                               |
20 20 
 | [[Improving ssh security]]                               |
21 21 
 | [[Administrating the system via an onion address (Tor)]] |
22 
-| [[./mobile.html][Mobile advice]]                     |
22 
+| [[./mobile.html][Mobile advice]]                                        |
23 23 
 | [[./usage_email.html][Using Email]]                                          |
24 24 
 | [[Syncing to the Cloud]]                                 |
25 25 
 | [[Play Music]]                                           |
 
@@ -27,6 +27,7 @@
27 27 
 | [[Social Network]]                                       |
28 28 
 | [[Chat Services]]                                        |
29 29 
 | [[RSS Reader]]                                           |
30 
+| [[Git Projects]]                                         |
30 31 
 | [[Adding or removing users]]                             |
31 32
32 33 
 * Readme
 
@@ -555,6 +556,28 @@ To access the RSS reader from a mobile device you can install a Tor compatible b
555 556 
 #+BEGIN_QUOTE
556 557 
 A note for the paranoid is that on mobile devices you get redirected to a different onion address which is specially set up for the mobile interface, so don't be alarmed that it looks like your connection is being hijacked.
557 558 
 #+END_QUOTE
559 
+* Git Projects
560 
+Github is ok, but it's proprietary and funded by venture capital. If you been around on the internet for long enough then you know how this story eventually works itself out - i.e. badly for the users. It's really only a question of time. If you're a software developer or do things which involve the Git version control system then it's a good idea to become accustomed to hosting your own repositories, before the inevitable Github shitstorm happens.
561 
+
562 
+A Git hosting system called [[https://gogs.io][Gogs]] can optionally be installed. This is very similar to Github in appearance and use. It's lightweight and so well suited for use on low power ARM servers.
563 
+
564 
+Navigate to your git site and click the *Register* button. The first user registered on the system becomes the administrator. Once you've done that then it's a good idea to disable further registrations. Currently that's a little complicated, but you can do it as follows:
565 
+
566 
+#+begin_src bash :tangle no
567 
+sudo username@domainname -p 2222
568 
+#+end_src
569 
+
570 
+Select *Exit to the comand line*.
571 
+
572 
+#+begin_src bash :tangle no
573 
+sudo su
574 
+export GO_VERSION=1.5
575 
+sed -i "s|DISABLE_REGISTRATION =.*|DISABLE_REGISTRATION = true|g" /home/git/gvm/pkgsets/go${GO_VERSION}/global/src/github.com/gogits/gogs/custom/conf/app.ini
576 
+systemctl restart gogs
577 
+exit; exit
578 
+#+end_src
579 
+
580 
+This will stop any spam accounts being created by random strangers or bots. You might want to mirror existing repos, and at any time a mirror can be converted into the main repo.
558 581 
 * Adding or removing users
559 582 
 Log into the system with:
560 583

+ 163
- 119
website/EN/usage.html View File 

@@ -3,7 +3,7 @@
3 3 
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4 4 
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5 5 
 <head>
6 
-<!-- 2016-05-08 Sun 10:56 -->
6 
+<!-- 2016-05-12 Thu 21:35 -->
7 7 
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
8 8 
 <meta name="viewport" content="width=device-width, initial-scale=1" />
9 9 
 <title></title>
 
@@ -170,15 +170,15 @@ for the JavaScript code in this tag.
170 170 
 </colgroup>
171 171 
 <tbody>
172 172 
 <tr>
173 
-<td class="org-left"><a href="#orgb124ed4">Readme</a></td>
173 
+<td class="org-left"><a href="#orga29796d">Readme</a></td>
174 174 
 </tr>
175 175
176 176 
 <tr>
177 
-<td class="org-left"><a href="#org94abdfa">Improving ssh security</a></td>
177 
+<td class="org-left"><a href="#org76b84af">Improving ssh security</a></td>
178 178 
 </tr>
179 179
180 180 
 <tr>
181 
-<td class="org-left"><a href="#orgc788e6e">Administrating the system via an onion address (Tor)</a></td>
181 
+<td class="org-left"><a href="#orgdc0c61d">Administrating the system via an onion address (Tor)</a></td>
182 182 
 </tr>
183 183
184 184 
 <tr>
 
@@ -190,38 +190,42 @@ for the JavaScript code in this tag.
190 190 
 </tr>
191 191
192 192 
 <tr>
193 
-<td class="org-left"><a href="#org431e863">Syncing to the Cloud</a></td>
193 
+<td class="org-left"><a href="#org13934e9">Syncing to the Cloud</a></td>
194 194 
 </tr>
195 195
196 196 
 <tr>
197 
-<td class="org-left"><a href="#orgce2c066">Play Music</a></td>
197 
+<td class="org-left"><a href="#orgb56caf4">Play Music</a></td>
198 198 
 </tr>
199 199
200 200 
 <tr>
201 
-<td class="org-left"><a href="#org892a0bf">Microblogging (GNU Social)</a></td>
201 
+<td class="org-left"><a href="#org96d4f87">Microblogging (GNU Social)</a></td>
202 202 
 </tr>
203 203
204 204 
 <tr>
205 
-<td class="org-left"><a href="#org84d8805">Social Network</a></td>
205 
+<td class="org-left"><a href="#org77e7b85">Social Network</a></td>
206 206 
 </tr>
207 207
208 208 
 <tr>
209 
-<td class="org-left"><a href="#org53b4d97">Chat Services</a></td>
209 
+<td class="org-left"><a href="#org79353a1">Chat Services</a></td>
210 210 
 </tr>
211 211
212 212 
 <tr>
213 
-<td class="org-left"><a href="#org106df4e">RSS Reader</a></td>
213 
+<td class="org-left"><a href="#org260b176">RSS Reader</a></td>
214 214 
 </tr>
215 215
216 216 
 <tr>
217 
-<td class="org-left"><a href="#orga8ba25b">Adding or removing users</a></td>
217 
+<td class="org-left"><a href="#orgadc5cdd">Git Projects</a></td>
218 
+</tr>
219 
+
220 
+<tr>
221 
+<td class="org-left"><a href="#org639977b">Adding or removing users</a></td>
218 222 
 </tr>
219 223 
 </tbody>
220 224 
 </table>
221 225
222 
-<div id="outline-container-orgb124ed4" class="outline-2">
223 
-<h2 id="orgb124ed4">Readme</h2>
224 
-<div class="outline-text-2" id="text-orgb124ed4">
226 
+<div id="outline-container-orga29796d" class="outline-2">
227 
+<h2 id="orga29796d">Readme</h2>
228 
+<div class="outline-text-2" id="text-orga29796d">
225 229 
 <p>
226 230 
 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:
227 231 
 </p>
 
@@ -242,9 +246,9 @@ To exit you can either just close the terminal or use <b>CTRL-x CTRL-c</b> follo
242 246 
 </p>
243 247 
 </div>
244 248 
 </div>
245 
-<div id="outline-container-org94abdfa" class="outline-2">
246 
-<h2 id="org94abdfa">Improving ssh security</h2>
247 
-<div class="outline-text-2" id="text-org94abdfa">
249 
+<div id="outline-container-org76b84af" class="outline-2">
250 
+<h2 id="org76b84af">Improving ssh security</h2>
251 
+<div class="outline-text-2" id="text-org76b84af">
248 252 
 <p>
249 253 
 To improve ssh security you can generate an ssh key pair on your system and then upload the public key to the Freedombone.
250 254 
 </p>
 
@@ -297,9 +301,9 @@ If you wish to only use ssh keys then log in to the Freedombone, become the root
297 301 
 </div>
298 302 
 </div>
299 303
300 
-<div id="outline-container-orgc788e6e" class="outline-2">
301 
-<h2 id="orgc788e6e">Administrating the system via an onion address (Tor)</h2>
302 
-<div class="outline-text-2" id="text-orgc788e6e">
304 
+<div id="outline-container-orgdc0c61d" class="outline-2">
305 
+<h2 id="orgdc0c61d">Administrating the system via an onion address (Tor)</h2>
306 
+<div class="outline-text-2" id="text-orgdc0c61d">
303 307 
 <p>
304 308 
 You can also access your system via the Tor system using an onion address. To find out what the onion address for ssh access is you can do the following:
305 309 
 </p>
 
@@ -345,9 +349,9 @@ Subsequently even if dynamic DNS isn't working you may still be able to administ
345 349 
 </p>
346 350 
 </div>
347 351 
 </div>
348 
-<div id="outline-container-org431e863" class="outline-2">
349 
-<h2 id="org431e863">Syncing to the Cloud</h2>
350 
-<div class="outline-text-2" id="text-org431e863">
352 
+<div id="outline-container-org13934e9" class="outline-2">
353 
+<h2 id="org13934e9">Syncing to the Cloud</h2>
354 
+<div class="outline-text-2" id="text-org13934e9">
351 355 
 <p>
352 356 
 <a href="https://syncthing.net/">Syncthing</a> provides a similar capability to proprietary systems such as <a href="http://www.drop-dropbox.com/">Dropbox</a>, and also is well suited for use with low power single board computers. You can have one or more directories which are synchronized across your various laptops/desktops/devices, and this makes it hard for you to ever lose important files. The manner in which the synchronization is done is pretty secure, such that it would be difficult for passive adversaries (mass surveillance, "<i>men in the middle</i>", etc) to know what files you're sharing. Of course, you don't necessarily need to be running a server in order to use Syncthing, but if you do have a server which is always running then there's always at least one place to synchronize your files to or from.
353 357 
 </p>
 
@@ -357,9 +361,9 @@ Freedombone provides Syncthing shared directories for each user on the system, p
357 361 
 </p>
358 362 
 </div>
359 363
360 
-<div id="outline-container-orgb544ba" class="outline-3">
361 
-<h3 id="orgb544ba">On a laptop</h3>
362 
-<div class="outline-text-3" id="text-orgb544ba">
364 
+<div id="outline-container-orgf4f2201" class="outline-3">
365 
+<h3 id="orgf4f2201">On a laptop</h3>
366 
+<div class="outline-text-3" id="text-orgf4f2201">
363 367 
 <p>
364 368 
 Install syncthing:
365 369 
 </p>
 
@@ -414,9 +418,9 @@ Now wait for a few minutes. Eventually you will see two messages appear within t
414 418 
 </p>
415 419 
 </div>
416 420 
 </div>
417 
-<div id="outline-container-org827e209" class="outline-3">
418 
-<h3 id="org827e209">On Android</h3>
419 
-<div class="outline-text-3" id="text-org827e209">
421 
+<div id="outline-container-org92eab03" class="outline-3">
422 
+<h3 id="org92eab03">On Android</h3>
423 
+<div class="outline-text-3" id="text-org92eab03">
420 424 
 <p>
421 425 
 Install Syncthing and Connectbot from F-droid.
422 426 
 </p>
 
@@ -447,12 +451,12 @@ Now wait for a few minutes or more. Eventually you should receive two notificati
447 451 
 </div>
448 452 
 </div>
449 453 
 </div>
450 
-<div id="outline-container-orgce2c066" class="outline-2">
451 
-<h2 id="orgce2c066">Play Music</h2>
452 
-<div class="outline-text-2" id="text-orgce2c066">
453 
-</div><div id="outline-container-orge6ff98f" class="outline-3">
454 
-<h3 id="orge6ff98f">With the DLNA service</h3>
455 
-<div class="outline-text-3" id="text-orge6ff98f">
454 
+<div id="outline-container-orgb56caf4" class="outline-2">
455 
+<h2 id="orgb56caf4">Play Music</h2>
456 
+<div class="outline-text-2" id="text-orgb56caf4">
457 
+</div><div id="outline-container-orgbecf4f8" class="outline-3">
458 
+<h3 id="orgbecf4f8">With the DLNA service</h3>
459 
+<div class="outline-text-3" id="text-orgbecf4f8">
456 460 
 <p>
457 461 
 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.
458 462 
 </p>
 
@@ -493,9 +497,9 @@ The DLNA service will only work within your local home network, and isn't remote
493 497 
 </div>
494 498 
 </div>
495 499
496 
-<div id="outline-container-org892a0bf" class="outline-2">
497 
-<h2 id="org892a0bf">Microblogging (GNU Social)</h2>
498 
-<div class="outline-text-2" id="text-org892a0bf">
500 
+<div id="outline-container-org96d4f87" class="outline-2">
501 
+<h2 id="org96d4f87">Microblogging (GNU Social)</h2>
502 
+<div class="outline-text-2" id="text-org96d4f87">
499 503 
 <p>
500 504 
 To log into your GNU Social site first obtain your username and password from the "microblogging" section of the readme file.
501 505 
 </p>
 
@@ -524,20 +528,20 @@ GNU Social has a clutter-free mobile user interface which can be accessed via a
524 528 
 </div>
525 529 
 </div>
526 530
527 
-<div id="outline-container-org84d8805" class="outline-2">
528 
-<h2 id="org84d8805">Social Network</h2>
529 
-<div class="outline-text-2" id="text-org84d8805">
530 
-</div><div id="outline-container-org817be50" class="outline-3">
531 
-<h3 id="org817be50">Domains</h3>
532 
-<div class="outline-text-3" id="text-org817be50">
531 
+<div id="outline-container-org77e7b85" class="outline-2">
532 
+<h2 id="org77e7b85">Social Network</h2>
533 
+<div class="outline-text-2" id="text-org77e7b85">
534 
+</div><div id="outline-container-org6bf9f06" class="outline-3">
535 
+<h3 id="org6bf9f06">Domains</h3>
536 
+<div class="outline-text-3" id="text-org6bf9f06">
533 537 
 <p>
534 538 
 Both Hubzilla and GNU Social try to obtain certificates automatically at the time of installation via Let's Encrypt. This will likely mean that in order for this to work you'll need to have obtained at least one "official" domain via a domain selling service, since Let's Encrypt mostly doesn't seem to work with free subdomains from sites such as freeDNS.
535 539 
 </p>
536 540 
 </div>
537 541 
 </div>
538 
-<div id="outline-container-orgcd14e1e" class="outline-3">
539 
-<h3 id="orgcd14e1e">Initial install</h3>
540 
-<div class="outline-text-3" id="text-orgcd14e1e">
542 
+<div id="outline-container-org2545d6" class="outline-3">
543 
+<h3 id="org2545d6">Initial install</h3>
544 
+<div class="outline-text-3" id="text-org2545d6">
541 545 
 <p>
542 546 
 On first visiting your Hubzilla site you'll see the login screen. The first thing you need to do is <b>register</b> a new user. The first user on the system then becomes its administrator.
543 547 
 </p>
 
@@ -551,19 +555,19 @@ On first visiting your Hubzilla site you'll see the login screen. The first thin
551 555 
 </div>
552 556 
 </div>
553 557
554 
-<div id="outline-container-org53b4d97" class="outline-2">
555 
-<h2 id="org53b4d97">Chat Services</h2>
556 
-<div class="outline-text-2" id="text-org53b4d97">
557 
-</div><div id="outline-container-org3c173a9" class="outline-3">
558 
-<h3 id="org3c173a9">IRC</h3>
559 
-<div class="outline-text-3" id="text-org3c173a9">
558 
+<div id="outline-container-org79353a1" class="outline-2">
559 
+<h2 id="org79353a1">Chat Services</h2>
560 
+<div class="outline-text-2" id="text-org79353a1">
561 
+</div><div id="outline-container-orgf5725a2" class="outline-3">
562 
+<h3 id="orgf5725a2">IRC</h3>
563 
+<div class="outline-text-3" id="text-orgf5725a2">
560 564 
 <p>
561 565 
 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.
562 566 
 </p>
563 567 
 </div>
564 
-<div id="outline-container-org23b4060" class="outline-4">
565 
-<h4 id="org23b4060">Irssi</h4>
566 
-<div class="outline-text-4" id="text-org23b4060">
568 
+<div id="outline-container-org3c905ca" class="outline-4">
569 
+<h4 id="org3c905ca">Irssi</h4>
570 
+<div class="outline-text-4" id="text-org3c905ca">
567 571 
 <p>
568 572 
 The easiest way to use irssi is to connect to your system, like this:
569 573 
 </p>
 
@@ -579,9 +583,9 @@ Then select <b>IRC</b> from the menu. However, other than via this method using
579 583 
 </p>
580 584 
 </div>
581 585 
 </div>
582 
-<div id="outline-container-orga30122" class="outline-4">
583 
-<h4 id="orga30122">HexChat</h4>
584 
-<div class="outline-text-4" id="text-orga30122">
586 
+<div id="outline-container-orge186b63" class="outline-4">
587 
+<h4 id="orge186b63">HexChat</h4>
588 
+<div class="outline-text-4" id="text-orge186b63">
585 589 
 <p>
586 590 
 HexChat (formerly XChat) is compatible with proxying via Tor and so provides the best security when connecting to your IRC server. It will allow you to connect to your IRC server's onion address.
587 591 
 </p>
 
@@ -759,9 +763,9 @@ Click <b>close</b> and then <b>connect</b>.
759 763 
 </div>
760 764 
 </div>
761 765
762 
-<div id="outline-container-org44e5114" class="outline-4">
763 
-<h4 id="org44e5114">Emacs</h4>
764 
-<div class="outline-text-4" id="text-org44e5114">
766 
+<div id="outline-container-org466e0b8" class="outline-4">
767 
+<h4 id="org466e0b8">Emacs</h4>
768 
+<div class="outline-text-4" id="text-org466e0b8">
765 769 
 <p>
766 770 
 If you are an Emacs user then you can also connect to your IRC server via Emacs.
767 771 
 </p>
 
@@ -794,9 +798,9 @@ Add the following to your Emacs configuration file:
794 798 
 </div>
795 799 
 </div>
796 800 
 </div>
797 
-<div id="outline-container-org7903439" class="outline-4">
798 
-<h4 id="org7903439">Changing or removing the IRC password</h4>
799 
-<div class="outline-text-4" id="text-org7903439">
801 
+<div id="outline-container-orgd61731d" class="outline-4">
802 
+<h4 id="orgd61731d">Changing or removing the IRC password</h4>
803 
+<div class="outline-text-4" id="text-orgd61731d">
800 804 
 <p>
801 805 
 By default the IRC server is set up to require a password for users to log in. The password is the same for all users. If you want to change or remove the password:
802 806 
 </p>
 
@@ -814,12 +818,12 @@ Select <i>Administrator controls</i> then <b>IRC Menu</b> and then change the pa
814 818 
 </div>
815 819 
 </div>
816 820
817 
-<div id="outline-container-org9fb684" class="outline-3">
818 
-<h3 id="org9fb684">XMPP/Jabber</h3>
819 
-<div class="outline-text-3" id="text-org9fb684">
820 
-</div><div id="outline-container-org6386283" class="outline-4">
821 
-<h4 id="org6386283">Using with Profanity</h4>
822 
-<div class="outline-text-4" id="text-org6386283">
821 
+<div id="outline-container-org5655389" class="outline-3">
822 
+<h3 id="org5655389">XMPP/Jabber</h3>
823 
+<div class="outline-text-3" id="text-org5655389">
824 
+</div><div id="outline-container-orgc130ac5" class="outline-4">
825 
+<h4 id="orgc130ac5">Using with Profanity</h4>
826 
+<div class="outline-text-4" id="text-orgc130ac5">
823 827 
 <p>
824 828 
 The <a href="http://profanity.im/">Profanity</a> shell based user interface and is perhaps the simplest way to use XMPP from a laptop. It's also a good way to ensure that your OTR keys are the same even when logging in from different laptops or devices, and it also means that if those devices later become compomised then there are no locally stored OTR keys to be found.
825 829 
 </p>
 
@@ -909,9 +913,9 @@ When accessed via the user control panel the client is automatically routed thro
909 913 
 </p>
910 914 
 </div>
911 915 
 </div>
912 
-<div id="outline-container-org10b8f66" class="outline-4">
913 
-<h4 id="org10b8f66">Using with Jitsi</h4>
914 
-<div class="outline-text-4" id="text-org10b8f66">
916 
+<div id="outline-container-org476471d" class="outline-4">
917 
+<h4 id="org476471d">Using with Jitsi</h4>
918 
+<div class="outline-text-4" id="text-org476471d">
915 919 
 <p>
916 920 
 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.
917 921 
 </p>
 
@@ -941,9 +945,9 @@ You can also <a href="https://www.youtube.com/watch?v=vgx7VSrDGjk">see this vide
941 945 
 </p>
942 946 
 </div>
943 947 
 </div>
944 
-<div id="outline-container-orge4fd4dd" class="outline-4">
945 
-<h4 id="orge4fd4dd">Using with Ubuntu</h4>
946 
-<div class="outline-text-4" id="text-orge4fd4dd">
948 
+<div id="outline-container-org2e97e46" class="outline-4">
949 
+<h4 id="org2e97e46">Using with Ubuntu</h4>
950 
+<div class="outline-text-4" id="text-org2e97e46">
947 951 
 <p>
948 952 
 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.
949 953 
 </p>
 
@@ -961,17 +965,17 @@ Click on <b>Advanced</b> and make sure that <b>Encryption required</b> and <b>Ig
961 965 
 </p>
962 966 
 </div>
963 967 
 </div>
964 
-<div id="outline-container-orgc42c89" class="outline-4">
965 
-<h4 id="orgc42c89">Using Tor Messenger</h4>
966 
-<div class="outline-text-4" id="text-orgc42c89">
968 
+<div id="outline-container-orgfdd2fba" class="outline-4">
969 
+<h4 id="orgfdd2fba">Using Tor Messenger</h4>
970 
+<div class="outline-text-4" id="text-orgfdd2fba">
967 971 
 <p>
968 972 
 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.
969 973 
 </p>
970 974 
 </div>
971 975 
 </div>
972 
-<div id="outline-container-orgcbf5cfb" class="outline-4">
973 
-<h4 id="orgcbf5cfb">Using with Android</h4>
974 
-<div class="outline-text-4" id="text-orgcbf5cfb">
976 
+<div id="outline-container-org353235d" class="outline-4">
977 
+<h4 id="org353235d">Using with Android</h4>
978 
+<div class="outline-text-4" id="text-org353235d">
975 979 
 <p>
976 980 
 Install <a href="https://f-droid.org/">F-Droid</a>
977 981 
 </p>
 
@@ -1007,16 +1011,16 @@ Then select <b>Next</b>. When chatting you can use the lock icon to encrypt your
1007 1011 
 </div>
1008 1012 
 </div>
1009 1013 
 </div>
1010 
-<div id="outline-container-org2fa6b4a" class="outline-3">
1011 
-<h3 id="org2fa6b4a">Tox</h3>
1012 
-<div class="outline-text-3" id="text-org2fa6b4a">
1014 
+<div id="outline-container-org44bb9df" class="outline-3">
1015 
+<h3 id="org44bb9df">Tox</h3>
1016 
+<div class="outline-text-3" id="text-org44bb9df">
1013 1017 
 <p>
1014 1018 
 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.
1015 1019 
 </p>
1016 1020 
 </div>
1017 
-<div id="outline-container-orgb3e1360" class="outline-4">
1018 
-<h4 id="orgb3e1360">Using the Toxic client</h4>
1019 
-<div class="outline-text-4" id="text-orgb3e1360">
1021 
+<div id="outline-container-orgcf71c64" class="outline-4">
1022 
+<h4 id="orgcf71c64">Using the Toxic client</h4>
1023 
+<div class="outline-text-4" id="text-orgcf71c64">
1020 1024 
 <p>
1021 1025 
 Log into your system with:
1022 1026 
 </p>
 
@@ -1040,20 +1044,20 @@ Then from the menu select <b>Tox Chat</b>. Tox is encrypted by default and also
1040 1044 
 </div>
1041 1045 
 </div>
1042 1046
1043 
-<div id="outline-container-orgd1b40a6" class="outline-3">
1044 
-<h3 id="orgd1b40a6">VoIP (Voice and text chat)</h3>
1045 
-<div class="outline-text-3" id="text-orgd1b40a6">
1046 
-</div><div id="outline-container-org6123a3" class="outline-4">
1047 
-<h4 id="org6123a3">Text chat</h4>
1048 
-<div class="outline-text-4" id="text-org6123a3">
1047 
+<div id="outline-container-org72b4e23" class="outline-3">
1048 
+<h3 id="org72b4e23">VoIP (Voice and text chat)</h3>
1049 
+<div class="outline-text-3" id="text-org72b4e23">
1050 
+</div><div id="outline-container-orgf752908" class="outline-4">
1051 
+<h4 id="orgf752908">Text chat</h4>
1052 
+<div class="outline-text-4" id="text-orgf752908">
1049 1053 
 <p>
1050 1054 
 In addition to voice it is also possible to do text chat via mumble. The security of this is pretty good provided that you do it via Plumble and Orbot on mobile, but compared to other options such as XMPP/Conversations or Tox the security is not as good, since the mumble server currently doesn't support forward secrecy.
1051 1055 
 </p>
1052 1056 
 </div>
1053 1057 
 </div>
1054 
-<div id="outline-container-org9a46067" class="outline-4">
1055 
-<h4 id="org9a46067">Using with Ubuntu</h4>
1056 
-<div class="outline-text-4" id="text-org9a46067">
1058 
+<div id="outline-container-org515757b" class="outline-4">
1059 
+<h4 id="org515757b">Using with Ubuntu</h4>
1060 
+<div class="outline-text-4" id="text-org515757b">
1057 1061 
 <p>
1058 1062 
 Within the software center search for "mumble" and install the client then run it. Skip through the audio setup wizard.
1059 1063 
 </p>
 
@@ -1063,9 +1067,9 @@ Click on "add new" to add a new server and enter the default domain name for the
1063 1067 
 </p>
1064 1068 
 </div>
1065 1069 
 </div>
1066 
-<div id="outline-container-org37e2e5" class="outline-4">
1067 
-<h4 id="org37e2e5">Using with Android</h4>
1068 
-<div class="outline-text-4" id="text-org37e2e5">
1070 
+<div id="outline-container-org4c306ab" class="outline-4">
1071 
+<h4 id="org4c306ab">Using with Android</h4>
1072 
+<div class="outline-text-4" id="text-org4c306ab">
1069 1073 
 <p>
1070 1074 
 Install <a href="https://f-droid.org/">F-Droid</a>
1071 1075 
 </p>
 
@@ -1100,24 +1104,24 @@ Selecting the server by pressing on it then connects you to the server so that y
1100 1104 
 </div>
1101 1105 
 </div>
1102 1106 
 </div>
1103 
-<div id="outline-container-org6201fa9" class="outline-3">
1104 
-<h3 id="org6201fa9">SIP phones</h3>
1105 
-<div class="outline-text-3" id="text-org6201fa9">
1107 
+<div id="outline-container-orgaac74d6" class="outline-3">
1108 
+<h3 id="orgaac74d6">SIP phones</h3>
1109 
+<div class="outline-text-3" id="text-orgaac74d6">
1106 1110 
 <p>
1107 1111 
 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.
1108 1112 
 </p>
1109 1113 
 </div>
1110 
-<div id="outline-container-org220d740" class="outline-4">
1111 
-<h4 id="org220d740">About ZRTP</h4>
1112 
-<div class="outline-text-4" id="text-org220d740">
1114 
+<div id="outline-container-org231a250" class="outline-4">
1115 
+<h4 id="org231a250">About ZRTP</h4>
1116 
+<div class="outline-text-4" id="text-org231a250">
1113 1117 
 <p>
1114 1118 
 <a href="https://jitsi.org/Documentation/ZrtpFAQ">ZRTP</a> appears to be the current best standard to end-to-end encrypted voice calls, combining good security with simplicity of use. When the initial cryptographic negotiation between phones is done at the start of a call a short authentication string (SAS) is calculated and displayed at both ends. To check that there isn't anyone intercepting the call and acting as a <i>man in the middle</i> - as <a href="https://en.wikipedia.org/wiki/Stingray_phone_tracker">stingray type devices</a> try to do - the short authentication string can be read out and verbally confirmed between the callers. If it's the same then you can be pretty confident that the call is secure.
1115 1119 
 </p>
1116 1120 
 </div>
1117 1121 
 </div>
1118 
-<div id="outline-container-orgd9d8df3" class="outline-4">
1119 
-<h4 id="orgd9d8df3">Using with CSIPSimple</h4>
1120 
-<div class="outline-text-4" id="text-orgd9d8df3">
1122 
+<div id="outline-container-orgf4f4d73" class="outline-4">
1123 
+<h4 id="orgf4f4d73">Using with CSIPSimple</h4>
1124 
+<div class="outline-text-4" id="text-orgf4f4d73">
1121 1125 
 <p>
1122 1126 
 Add an account. Under <b>General Wizards</b> choose <b>Expert</b> and enter the following details:
1123 1127 
 </p>
 
@@ -1173,9 +1177,9 @@ If everything is working the account should appear in green with a status of <b>
1173 1177 
 </p>
1174 1178 
 </div>
1175 1179 
 </div>
1176 
-<div id="outline-container-org657508f" class="outline-4">
1177 
-<h4 id="org657508f">Using with Ring</h4>
1178 
-<div class="outline-text-4" id="text-org657508f">
1180 
+<div id="outline-container-orgcee8a17" class="outline-4">
1181 
+<h4 id="orgcee8a17">Using with Ring</h4>
1182 
+<div class="outline-text-4" id="text-orgcee8a17">
1179 1183 
 <p>
1180 1184 
 From the menu select <b>Manage accounts</b>.
1181 1185 
 </p>
 
@@ -1228,9 +1232,9 @@ Select the <b>Security</b> tab. Under <b>SRTP Key Exchange</b> select <b>ZRTP</b
1228 1232 
 </div>
1229 1233 
 </div>
1230 1234
1231 
-<div id="outline-container-org106df4e" class="outline-2">
1232 
-<h2 id="org106df4e">RSS Reader</h2>
1233 
-<div class="outline-text-2" id="text-org106df4e">
1235 
+<div id="outline-container-org260b176" class="outline-2">
1236 
+<h2 id="org260b176">RSS Reader</h2>
1237 
+<div class="outline-text-2" id="text-org260b176">
1234 1238 
 <p>
1235 1239 
 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.
1236 1240 
 </p>
 
@@ -1274,9 +1278,49 @@ A note for the paranoid is that on mobile devices you get redirected to a differ
1274 1278 
 </blockquote>
1275 1279 
 </div>
1276 1280 
 </div>
1277 
-<div id="outline-container-orga8ba25b" class="outline-2">
1278 
-<h2 id="orga8ba25b">Adding or removing users</h2>
1279 
-<div class="outline-text-2" id="text-orga8ba25b">
1281 
+<div id="outline-container-orgadc5cdd" class="outline-2">
1282 
+<h2 id="orgadc5cdd">Git Projects</h2>
1283 
+<div class="outline-text-2" id="text-orgadc5cdd">
1284 
+<p>
1285 
+Github is ok, but it's proprietary and funded by venture capital. If you been around on the internet for long enough then you know how this story eventually works itself out - i.e. badly for the users. It's really only a question of time. If you're a software developer or do things which involve the Git version control system then it's a good idea to become accustomed to hosting your own repositories, before the inevitable Github shitstorm happens.
1286 
+</p>
1287 
+
1288 
+<p>
1289 
+A Git hosting system called <a href="https://gogs.io/">Gogs</a> can optionally be installed. This is very similar to Github in appearance and use. It's lightweight and so well suited for use on low power ARM servers.
1290 
+</p>
1291 
+
1292 
+<p>
1293 
+Navigate to your git site and click the <b>Register</b> button. The first user registered on the system becomes the administrator. Once you've done that then it's a good idea to disable further registrations. Currently that's a little complicated, but you can do it as follows:
1294 
+</p>
1295 
+
1296 
+<div class="org-src-container">
1297 
+
1298 
+<pre class="src src-bash">sudo username@domainname -p 2222
1299 
+</pre>
1300 
+</div>
1301 
+
1302 
+<p>
1303 
+Select <b>Exit to the comand line</b>.
1304 
+</p>
1305 
+
1306 
+<div class="org-src-container">
1307 
+
1308 
+<pre class="src src-bash">sudo su
1309 
+<span class="org-builtin">export</span> <span class="org-variable-name">GO_VERSION</span>=1.5
1310 
+sed -i <span class="org-string">"s|DISABLE_REGISTRATION =.*|DISABLE_REGISTRATION = true|g"</span> /home/git/gvm/pkgsets/go${<span class="org-variable-name">GO_VERSION</span>}/global/src/github.com/gogits/gogs/custom/conf/app.ini
1311 
+systemctl restart gogs
1312 
+<span class="org-keyword">exit</span>; <span class="org-keyword">exit</span>
1313 
+</pre>
1314 
+</div>
1315 
+
1316 
+<p>
1317 
+This will stop any spam accounts being created by random strangers or bots. You might want to mirror existing repos, and at any time a mirror can be converted into the main repo.
1318 
+</p>
1319 
+</div>
1320 
+</div>
1321 
+<div id="outline-container-org639977b" class="outline-2">
1322 
+<h2 id="org639977b">Adding or removing users</h2>
1323 
+<div class="outline-text-2" id="text-org639977b">
1280 1324 
 <p>
1281 1325 
 Log into the system with:
1282 1326 
 </p>