More comprehensive install instructions

doc/EN/app_gnusocial.org

@@ -22,6 +22,19 @@ You can host your own GNU Social instance and then "/remote follow/" other users
 
 You should regard anything posted to GNU Social as being /public communication/ visible to anyone on the internet. There is a direct messaging capability between users but it's not particularly secure, so for one-to-one messages stick to better methods, such as XMPP with OTR/OMEMO or Tox.
 
+* Installation
+Log into your system with:
+
+#+begin_src bash
+ssh myusername@mydomain -p 2222
+#+end_src
+
+Using cursor keys, space bar and Enter key select *Administrator controls* and type in your password.
+
+Select *Add/Remove Apps* then *gnusocial*. You will then be asked for a domain name and if you are using FreeDNS also the code for the domain which can be found under *Dynamic DNS* on the FreeDNS site (the random string from "/quick cron example/" which appears after /update.php?/ and before />>/). For more details on obtaining a domain and making it accessible via dynamic DNS see the [[./faq.html][FAQ]]. You can also add a welcome message and background picture URL if you wish, although those things are optional. Typically the domain name you use will be a subdomain, such as /gnusocial.mydomainname.net/. It will need to be a domain which you have bought somewhere and own and not one of the FreeDNS subdomains, otherwise you won't be able to get a SSL/TLS certificate for it.
+
+After the install has completed go to *Security settings* and select *Create a new Let's Encrypt certificate* and enter the domain name that you are using for GNU Social. If you're using the "onion only" version of the system then you don't need to do this. If the certificate is obtained successfully then you will see a congratulations message.
+
 * Initial setup
 To log into your GNU Social site first obtain your username and password from the "microblogging" section of the readme file.
 
@@ -39,6 +52,7 @@ GNU Social has a clutter-free mobile user interface which can be accessed via a
 [[file:images/gnusocial_mobile.jpg]]
 #+END_CENTER
 
+
 * Using with Emacs
 If you are an Emacs user it's also possible to set up GNU Social mode as follows:
 

doc/EN/app_gogs.org

@@ -20,6 +20,20 @@ Github is ok, but it's proprietary and funded by venture capital. If you been ar
 
 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.
 
+* Installation
+Log into your system with:
+
+#+begin_src bash
+ssh myusername@mydomain -p 2222
+#+end_src
+
+Using cursor keys, space bar and Enter key select *Administrator controls* and type in your password.
+
+Select *Add/Remove Apps* then *gogs*. You will then be asked for a domain name and if you are using FreeDNS also the code for the domain which can be found under *Dynamic DNS* on the FreeDNS site (the random string from "/quick cron example/" which appears after /update.php?/ and before />>/). For more details on obtaining a domain and making it accessible via dynamic DNS see the [[./faq.html][FAQ]]. Typically the domain name you use will be a subdomain, such as /code.mydomainname.net/. It will need to be a domain which you have bought somewhere and own and not one of the FreeDNS subdomains, otherwise you won't be able to get a SSL/TLS certificate for it.
+
+After the install has completed go to *Security settings* and select *Create a new Let's Encrypt certificate* and enter the domain name that you are using for Gogs. If you're using the "onion only" version of the system then you don't need to do this. If the certificate is obtained successfully then you will see a congratulations message.
+
+* Initial setup
 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:
 
 #+begin_src bash :tangle no

doc/EN/app_hubzilla.org

@@ -18,7 +18,20 @@
 
 Hubzilla is a web publishing and social network system which includes wiki, web pages, photo albums and file storage. It also has privacy controls which allow you to define who can see which content. It's possible to write posts and have them visible only to a group of friends (known as "/privacy groups/"), with the encryption being handled automatically.
 
-* Initial install
+* Installation
+Log into your system with:
+
+#+begin_src bash
+ssh myusername@mydomain -p 2222
+#+end_src
+
+Using cursor keys, space bar and Enter key select *Administrator controls* and type in your password.
+
+Select *Add/Remove Apps* then *hubzilla*. You will then be asked for a domain name and if you are using FreeDNS also the code for the domain which can be found under *Dynamic DNS* on the FreeDNS site (the random string from "/quick cron example/" which appears after /update.php?/ and before />>/). For more details on obtaining a domain and making it accessible via dynamic DNS see the [[./faq.html][FAQ]]. Typically the domain name you use will be a subdomain, such as /hub.mydomainname.net/. It will need to be a domain which you have bought somewhere and own and not one of the FreeDNS subdomains, otherwise you won't be able to get a SSL/TLS certificate for it.
+
+After the install has completed go to *Security settings* and select *Create a new Let's Encrypt certificate* and enter the domain name that you are using for Hubzilla. If you're using the "onion only" version of the system then you don't need to do this. If the certificate is obtained successfully then you will see a congratulations message.
+
+* Initial setup
 On first visiting your Hubzilla site you'll see the login screen. The first thing you need to do is *register* a new user. The first user on the system then becomes its administrator.
 
 #+BEGIN_CENTER

doc/EN/app_mailpile.org

@@ -22,7 +22,20 @@ An advantage of this type of webmail is that /it keeps your GPG keys off of any
 
 One down side is that this appears to be a single user system, so if you have multiple users on your Freedombone server only the administrator will actually be able to use mailpile.
 
-* Setup
+* Installation
+Log into your system with:
+
+#+begin_src bash
+ssh myusername@mydomain -p 2222
+#+end_src
+
+Using cursor keys, space bar and Enter key select *Administrator controls* and type in your password.
+
+Select *Add/Remove Apps* then *mailpile*. You will then be asked for a domain name and if you are using FreeDNS also the code for the domain which can be found under *Dynamic DNS* on the FreeDNS site (the random string from "/quick cron example/" which appears after /update.php?/ and before />>/). For more details on obtaining a domain and making it accessible via dynamic DNS see the [[./faq.html][FAQ]]. Typically the domain name you use will be a subdomain, such as /mail.mydomainname.net/. It will need to be a domain which you have bought somewhere and own and not one of the FreeDNS subdomains, otherwise you won't be able to get a SSL/TLS certificate for it.
+
+After the install has completed go to *Security settings* and select *Create a new Let's Encrypt certificate* and enter the domain name that you are using for Mailpile. If you're using the "onion only" version of the system then you don't need to do this. If the certificate is obtained successfully then you will see a congratulations message.
+
+* Initial setup
 
 If you're viewing your mail domain site on a mobile device via OrFox then make sure you allow the domain in the NoScript settings.
 

website/EN/app_gnusocial.html

@@ -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-11-12 Sat 18:35 -->
+<!-- 2016-11-14 Mon 12:39 -->
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title></title>
@@ -259,9 +259,35 @@ You can host your own GNU Social instance and then "<i>remote follow</i>" other
 You should regard anything posted to GNU Social as being <i>public communication</i> visible to anyone on the internet. There is a direct messaging capability between users but it's not particularly secure, so for one-to-one messages stick to better methods, such as XMPP with OTR/OMEMO or Tox.
 </p>
 
-<div id="outline-container-org4d93721" class="outline-2">
-<h2 id="org4d93721">Initial setup</h2>
-<div class="outline-text-2" id="text-org4d93721">
+<div id="outline-container-org23c39bb" class="outline-2">
+<h2 id="org23c39bb">Installation</h2>
+<div class="outline-text-2" id="text-org23c39bb">
+<p>
+Log into your system with:
+</p>
+
+<div class="org-src-container">
+<pre class="src src-bash">ssh myusername@mydomain -p 2222
+</pre>
+</div>
+
+<p>
+Using cursor keys, space bar and Enter key select <b>Administrator controls</b> and type in your password.
+</p>
+
+<p>
+Select <b>Add/Remove Apps</b> then <b>gnusocial</b>. You will then be asked for a domain name and if you are using FreeDNS also the code for the domain which can be found under <b>Dynamic DNS</b> on the FreeDNS site (the random string from "<i>quick cron example</i>" which appears after <i>update.php?</i> and before <i>&gt;&gt;</i>). For more details on obtaining a domain and making it accessible via dynamic DNS see the <a href="./faq.html">FAQ</a>. You can also add a welcome message and background picture URL if you wish, although those things are optional. Typically the domain name you use will be a subdomain, such as <i>gnusocial.mydomainname.net</i>. It will need to be a domain which you have bought somewhere and own and not one of the FreeDNS subdomains, otherwise you won't be able to get a SSL/TLS certificate for it.
+</p>
+
+<p>
+After the install has completed go to <b>Security settings</b> and select <b>Create a new Let's Encrypt certificate</b> and enter the domain name that you are using for GNU Social. If you're using the "onion only" version of the system then you don't need to do this. If the certificate is obtained successfully then you will see a congratulations message.
+</p>
+</div>
+</div>
+
+<div id="outline-container-orge2c9ceb" class="outline-2">
+<h2 id="orge2c9ceb">Initial setup</h2>
+<div class="outline-text-2" id="text-orge2c9ceb">
 <p>
 To log into your GNU Social site first obtain your username and password from the "microblogging" section of the readme file.
 </p>
@@ -291,9 +317,10 @@ GNU Social has a clutter-free mobile user interface which can be accessed via a
 </div>
 </div>
 
-<div id="outline-container-org8255163" class="outline-2">
-<h2 id="org8255163">Using with Emacs</h2>
-<div class="outline-text-2" id="text-org8255163">
+
+<div id="outline-container-org779847a" class="outline-2">
+<h2 id="org779847a">Using with Emacs</h2>
+<div class="outline-text-2" id="text-org779847a">
 <p>
 If you are an Emacs user it's also possible to set up GNU Social mode as follows:
 </p>
@@ -377,9 +404,9 @@ And as a quick reference the main keys are:
 </div>
 
 
-<div id="outline-container-orge07089f" class="outline-2">
-<h2 id="orge07089f">Sharing things</h2>
-<div class="outline-text-2" id="text-orge07089f">
+<div id="outline-container-org9824bbd" class="outline-2">
+<h2 id="org9824bbd">Sharing things</h2>
+<div class="outline-text-2" id="text-org9824bbd">
 <p>
 If you have the GNU Social microblogging system installed then it's also possible to share things or services between groups or with particular users. This can be useful for sharing items within a family, club or in a local sharing economy. Sharing things freely, without money, reveals the social basis at the root of all economics which money normally conceals or obscures.
 </p>

website/EN/app_gogs.html

@@ -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-11-12 Sat 23:35 -->
+<!-- 2016-11-14 Mon 12:44 -->
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title></title>
@@ -255,6 +255,35 @@ Github is ok, but it's proprietary and funded by venture capital. If you been ar
 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.
 </p>
 
+<div id="outline-container-orge92ce52" class="outline-2">
+<h2 id="orge92ce52">Installation</h2>
+<div class="outline-text-2" id="text-orge92ce52">
+<p>
+Log into your system with:
+</p>
+
+<div class="org-src-container">
+<pre class="src src-bash">ssh myusername@mydomain -p 2222
+</pre>
+</div>
+
+<p>
+Using cursor keys, space bar and Enter key select <b>Administrator controls</b> and type in your password.
+</p>
+
+<p>
+Select <b>Add/Remove Apps</b> then <b>gogs</b>. You will then be asked for a domain name and if you are using FreeDNS also the code for the domain which can be found under <b>Dynamic DNS</b> on the FreeDNS site (the random string from "<i>quick cron example</i>" which appears after <i>update.php?</i> and before <i>&gt;&gt;</i>). For more details on obtaining a domain and making it accessible via dynamic DNS see the <a href="./faq.html">FAQ</a>. Typically the domain name you use will be a subdomain, such as <i>code.mydomainname.net</i>. It will need to be a domain which you have bought somewhere and own and not one of the FreeDNS subdomains, otherwise you won't be able to get a SSL/TLS certificate for it.
+</p>
+
+<p>
+After the install has completed go to <b>Security settings</b> and select <b>Create a new Let's Encrypt certificate</b> and enter the domain name that you are using for Gogs. If you're using the "onion only" version of the system then you don't need to do this. If the certificate is obtained successfully then you will see a congratulations message.
+</p>
+</div>
+</div>
+
+<div id="outline-container-org8926ec0" class="outline-2">
+<h2 id="org8926ec0">Initial setup</h2>
+<div class="outline-text-2" id="text-org8926ec0">
 <p>
 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:
 </p>
@@ -272,6 +301,8 @@ Select <b>Administrator controls</b> then <b>App Settings</b> then <b>gogs</b>.
 Disabling further registrations will stop any spam accounts being created by random strangers or bots.
 </p>
 </div>
+</div>
+</div>
 <div id="postamble" class="status">
 
 <style type="text/css">

website/EN/app_hubzilla.html

@@ -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-11-12 Sat 19:05 -->
+<!-- 2016-11-14 Mon 12:45 -->
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title></title>
@@ -251,9 +251,35 @@ for the JavaScript code in this tag.
 Hubzilla is a web publishing and social network system which includes wiki, web pages, photo albums and file storage. It also has privacy controls which allow you to define who can see which content. It's possible to write posts and have them visible only to a group of friends (known as "<i>privacy groups</i>"), with the encryption being handled automatically.
 </p>
 
-<div id="outline-container-org1eabf16" class="outline-2">
-<h2 id="org1eabf16">Initial install</h2>
-<div class="outline-text-2" id="text-org1eabf16">
+<div id="outline-container-org7d086f1" class="outline-2">
+<h2 id="org7d086f1">Installation</h2>
+<div class="outline-text-2" id="text-org7d086f1">
+<p>
+Log into your system with:
+</p>
+
+<div class="org-src-container">
+<pre class="src src-bash">ssh myusername@mydomain -p 2222
+</pre>
+</div>
+
+<p>
+Using cursor keys, space bar and Enter key select <b>Administrator controls</b> and type in your password.
+</p>
+
+<p>
+Select <b>Add/Remove Apps</b> then <b>hubzilla</b>. You will then be asked for a domain name and if you are using FreeDNS also the code for the domain which can be found under <b>Dynamic DNS</b> on the FreeDNS site (the random string from "<i>quick cron example</i>" which appears after <i>update.php?</i> and before <i>&gt;&gt;</i>). For more details on obtaining a domain and making it accessible via dynamic DNS see the <a href="./faq.html">FAQ</a>. Typically the domain name you use will be a subdomain, such as <i>hub.mydomainname.net</i>. It will need to be a domain which you have bought somewhere and own and not one of the FreeDNS subdomains, otherwise you won't be able to get a SSL/TLS certificate for it.
+</p>
+
+<p>
+After the install has completed go to <b>Security settings</b> and select <b>Create a new Let's Encrypt certificate</b> and enter the domain name that you are using for Hubzilla. If you're using the "onion only" version of the system then you don't need to do this. If the certificate is obtained successfully then you will see a congratulations message.
+</p>
+</div>
+</div>
+
+<div id="outline-container-org8b38964" class="outline-2">
+<h2 id="org8b38964">Initial setup</h2>
+<div class="outline-text-2" id="text-org8b38964">
 <p>
 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.
 </p>

website/EN/app_mailpile.html

@@ -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-11-14 Mon 10:21 -->
+<!-- 2016-11-14 Mon 12:45 -->
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title></title>
@@ -259,9 +259,35 @@ An advantage of this type of webmail is that <i>it keeps your GPG keys off of an
 One down side is that this appears to be a single user system, so if you have multiple users on your Freedombone server only the administrator will actually be able to use mailpile.
 </p>
 
-<div id="outline-container-org2dc938f" class="outline-2">
-<h2 id="org2dc938f">Setup</h2>
-<div class="outline-text-2" id="text-org2dc938f">
+<div id="outline-container-orgd2990f3" class="outline-2">
+<h2 id="orgd2990f3">Installation</h2>
+<div class="outline-text-2" id="text-orgd2990f3">
+<p>
+Log into your system with:
+</p>
+
+<div class="org-src-container">
+<pre class="src src-bash">ssh myusername@mydomain -p 2222
+</pre>
+</div>
+
+<p>
+Using cursor keys, space bar and Enter key select <b>Administrator controls</b> and type in your password.
+</p>
+
+<p>
+Select <b>Add/Remove Apps</b> then <b>mailpile</b>. You will then be asked for a domain name and if you are using FreeDNS also the code for the domain which can be found under <b>Dynamic DNS</b> on the FreeDNS site (the random string from "<i>quick cron example</i>" which appears after <i>update.php?</i> and before <i>&gt;&gt;</i>). For more details on obtaining a domain and making it accessible via dynamic DNS see the <a href="./faq.html">FAQ</a>. Typically the domain name you use will be a subdomain, such as <i>mail.mydomainname.net</i>. It will need to be a domain which you have bought somewhere and own and not one of the FreeDNS subdomains, otherwise you won't be able to get a SSL/TLS certificate for it.
+</p>
+
+<p>
+After the install has completed go to <b>Security settings</b> and select <b>Create a new Let's Encrypt certificate</b> and enter the domain name that you are using for Mailpile. If you're using the "onion only" version of the system then you don't need to do this. If the certificate is obtained successfully then you will see a congratulations message.
+</p>
+</div>
+</div>
+
+<div id="outline-container-orga48e7d0" class="outline-2">
+<h2 id="orga48e7d0">Initial setup</h2>
+<div class="outline-text-2" id="text-orga48e7d0">
 <p>
 If you're viewing your mail domain site on a mobile device via OrFox then make sure you allow the domain in the NoScript settings.
 </p>