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

Gogs usage

Bob Mottram 9 years ago
parent
4bae0f73ea
commit
dbd9010e2a
2 changed files with 187 additions and 120 deletions
Unified 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 
 | [[Readme]]                                               |
 19 
 | [[Readme]]                                               |
20 
 | [[Improving ssh security]]                               |
 20 
 | [[Improving ssh security]]                               |
21 
 | [[Administrating the system via an onion address (Tor)]] |
 21 
 | [[Administrating the system via an onion address (Tor)]] |
22 
-| [[./mobile.html][Mobile advice]]                     |
22 
+| [[./mobile.html][Mobile advice]]                                        |
23 
 | [[./usage_email.html][Using Email]]                                          |
 23 
 | [[./usage_email.html][Using Email]]                                          |
24 
 | [[Syncing to the Cloud]]                                 |
 24 
 | [[Syncing to the Cloud]]                                 |
25 
 | [[Play Music]]                                           |
 25 
 | [[Play Music]]                                           |
27 
 | [[Social Network]]                                       |
 27 
 | [[Social Network]]                                       |
28 
 | [[Chat Services]]                                        |
 28 
 | [[Chat Services]]                                        |
29 
 | [[RSS Reader]]                                           |
 29 
 | [[RSS Reader]]                                           |
30 
+| [[Git Projects]]                                         |
30 
 | [[Adding or removing users]]                             |
 31 
 | [[Adding or removing users]]                             |
31
32
32 
 * Readme
 33 
 * Readme
555 
 #+BEGIN_QUOTE
 556 
 #+BEGIN_QUOTE
556 
 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 
 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 
 #+END_QUOTE
 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 
 * Adding or removing users
 581 
 * Adding or removing users
559 
 Log into the system with:
 582 
 Log into the system with:
560
583

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

3 
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 3 
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4 
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
 4 
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5 
 <head>
 5 
 <head>
6 
-<!-- 2016-05-08 Sun 10:56 -->
6 
+<!-- 2016-05-12 Thu 21:35 -->
7 
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
 7 
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
8 
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 8 
 <meta name="viewport" content="width=device-width, initial-scale=1" />
9 
 <title></title>
 9 
 <title></title>
170 
 </colgroup>
 170 
 </colgroup>
171 
 <tbody>
 171 
 <tbody>
172 
 <tr>
 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 
 </tr>
 174 
 </tr>
175
175
176 
 <tr>
 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 
 </tr>
 178 
 </tr>
179
179
180 
 <tr>
 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 
 </tr>
 182 
 </tr>
183
183
184 
 <tr>
 184 
 <tr>
190 
 </tr>
 190 
 </tr>
191
191
192 
 <tr>
 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 
 </tr>
 194 
 </tr>
195
195
196 
 <tr>
 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 
 </tr>
 198 
 </tr>
199
199
200 
 <tr>
 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 
 </tr>
 202 
 </tr>
203
203
204 
 <tr>
 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 
 </tr>
 206 
 </tr>
207
207
208 
 <tr>
 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 
 </tr>
 210 
 </tr>
211
211
212 
 <tr>
 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 
 </tr>
 214 
 </tr>
215
215
216 
 <tr>
 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 
 </tr>
 222 
 </tr>
219 
 </tbody>
 223 
 </tbody>
220 
 </table>
 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 
 <p>
 229 
 <p>
226 
 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:
 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 
 </p>
 231 
 </p>
242 
 </p>
 246 
 </p>
243 
 </div>
 247 
 </div>
244 
 </div>
 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 
 <p>
 252 
 <p>
249 
 To improve ssh security you can generate an ssh key pair on your system and then upload the public key to the Freedombone.
 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 
 </p>
 254 
 </p>
297 
 </div>
 301 
 </div>
298 
 </div>
 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 
 <p>
 307 
 <p>
304 
 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:
 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 
 </p>
 309 
 </p>
345 
 </p>
 349 
 </p>
346 
 </div>
 350 
 </div>
347 
 </div>
 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 
 <p>
 355 
 <p>
352 
 <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.
 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 
 </p>
 357 
 </p>
357 
 </p>
 361 
 </p>
358 
 </div>
 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 
 <p>
 367 
 <p>
364 
 Install syncthing:
 368 
 Install syncthing:
365 
 </p>
 369 
 </p>
414 
 </p>
 418 
 </p>
415 
 </div>
 419 
 </div>
416 
 </div>
 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 
 <p>
 424 
 <p>
421 
 Install Syncthing and Connectbot from F-droid.
 425 
 Install Syncthing and Connectbot from F-droid.
422 
 </p>
 426 
 </p>
447 
 </div>
 451 
 </div>
448 
 </div>
 452 
 </div>
449 
 </div>
 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 
 <p>
 460 
 <p>
457 
 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.
 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 
 </p>
 462 
 </p>
493 
 </div>
 497 
 </div>
494 
 </div>
 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 
 <p>
 503 
 <p>
500 
 To log into your GNU Social site first obtain your username and password from the "microblogging" section of the readme file.
 504 
 To log into your GNU Social site first obtain your username and password from the "microblogging" section of the readme file.
501 
 </p>
 505 
 </p>
524 
 </div>
 528 
 </div>
525 
 </div>
 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 
 <p>
 537 
 <p>
534 
 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.
 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 
 </p>
 539 
 </p>
536 
 </div>
 540 
 </div>
537 
 </div>
 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 
 <p>
 545 
 <p>
542 
 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.
 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 
 </p>
 547 
 </p>
551 
 </div>
 555 
 </div>
552 
 </div>
 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 
 <p>
 564 
 <p>
561 
 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.
 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 
 </p>
 566 
 </p>
563 
 </div>
 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 
 <p>
 571 
 <p>
568 
 The easiest way to use irssi is to connect to your system, like this:
 572 
 The easiest way to use irssi is to connect to your system, like this:
569 
 </p>
 573 
 </p>
579 
 </p>
 583 
 </p>
580 
 </div>
 584 
 </div>
581 
 </div>
 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 
 <p>
 589 
 <p>
586 
 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.
 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 
 </p>
 591 
 </p>
759 
 </div>
 763 
 </div>
760 
 </div>
 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 
 <p>
 769 
 <p>
766 
 If you are an Emacs user then you can also connect to your IRC server via Emacs.
 770 
 If you are an Emacs user then you can also connect to your IRC server via Emacs.
767 
 </p>
 771 
 </p>
794 
 </div>
 798 
 </div>
795 
 </div>
 799 
 </div>
796 
 </div>
 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 
 <p>
 804 
 <p>
801 
 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:
 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 
 </p>
 806 
 </p>
814 
 </div>
 818 
 </div>
815 
 </div>
 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 
 <p>
 827 
 <p>
824 
 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.
 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 
 </p>
 829 
 </p>
909 
 </p>
 913 
 </p>
910 
 </div>
 914 
 </div>
911 
 </div>
 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 
 <p>
 919 
 <p>
916 
 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.
 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 
 </p>
 921 
 </p>
941 
 </p>
 945 
 </p>
942 
 </div>
 946 
 </div>
943 
 </div>
 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 
 <p>
 951 
 <p>
948 
 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.
 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 
 </p>
 953 
 </p>
961 
 </p>
 965 
 </p>
962 
 </div>
 966 
 </div>
963 
 </div>
 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 
 <p>
 971 
 <p>
968 
 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.
 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 
 </p>
 973 
 </p>
970 
 </div>
 974 
 </div>
971 
 </div>
 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 
 <p>
 979 
 <p>
976 
 Install <a href="https://f-droid.org/">F-Droid</a>
 980 
 Install <a href="https://f-droid.org/">F-Droid</a>
977 
 </p>
 981 
 </p>
1007 
 </div>
 1011 
 </div>
1008 
 </div>
 1012 
 </div>
1009 
 </div>
 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 
 <p>
 1017 
 <p>
1014 
 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.
 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 
 </p>
 1019 
 </p>
1016 
 </div>
 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 
 <p>
 1024 
 <p>
1021 
 Log into your system with:
 1025 
 Log into your system with:
1022 
 </p>
 1026 
 </p>
1040 
 </div>
 1044 
 </div>
1041 
 </div>
 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 
 <p>
 1053 
 <p>
1050 
 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.
 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 
 </p>
 1055 
 </p>
1052 
 </div>
 1056 
 </div>
1053 
 </div>
 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 
 <p>
 1061 
 <p>
1058 
 Within the software center search for "mumble" and install the client then run it. Skip through the audio setup wizard.
 1062 
 Within the software center search for "mumble" and install the client then run it. Skip through the audio setup wizard.
1059 
 </p>
 1063 
 </p>
1063 
 </p>
 1067 
 </p>
1064 
 </div>
 1068 
 </div>
1065 
 </div>
 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 
 <p>
 1073 
 <p>
1070 
 Install <a href="https://f-droid.org/">F-Droid</a>
 1074 
 Install <a href="https://f-droid.org/">F-Droid</a>
1071 
 </p>
 1075 
 </p>
1100 
 </div>
 1104 
 </div>
1101 
 </div>
 1105 
 </div>
1102 
 </div>
 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 
 <p>
 1110 
 <p>
1107 
 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.
 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 
 </p>
 1112 
 </p>
1109 
 </div>
 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 
 <p>
 1117 
 <p>
1114 
 <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.
 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 
 </p>
 1119 
 </p>
1116 
 </div>
 1120 
 </div>
1117 
 </div>
 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 
 <p>
 1125 
 <p>
1122 
 Add an account. Under <b>General Wizards</b> choose <b>Expert</b> and enter the following details:
 1126 
 Add an account. Under <b>General Wizards</b> choose <b>Expert</b> and enter the following details:
1123 
 </p>
 1127 
 </p>
1173 
 </p>
 1177 
 </p>
1174 
 </div>
 1178 
 </div>
1175 
 </div>
 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 
 <p>
 1183 
 <p>
1180 
 From the menu select <b>Manage accounts</b>.
 1184 
 From the menu select <b>Manage accounts</b>.
1181 
 </p>
 1185 
 </p>
1228 
 </div>
 1232 
 </div>
1229 
 </div>
 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 
 <p>
 1238 
 <p>
1235 
 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.
 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 
 </p>
 1240 
 </p>
1274 
 </blockquote>
 1278 
 </blockquote>
1275 
 </div>
 1279 
 </div>
1276 
 </div>
 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 
 <p>
 1324 
 <p>
1281 
 Log into the system with:
 1325 
 Log into the system with:
1282 
 </p>
 1326 
 </p>