free
/
freedombone
Suivre 1
Favoriser 0
Bifurcation 0
Code Tickets 0 Demandes d'ajout 0 Versions 0 Wiki Activité
Parcourir la source

Stylesheet

Bob Mottram il y a 10 ans
Parent
a16d3b6327
révision
15818e7a49
3 fichiers modifiés avec 170 ajouts et 161 suppressions
Vue séparée Afficher les stats Diff
  1. 1
    1
      doc/index.org
  2. 44
    7
      website/index.html
  3. 125
    153
      website/installation.html

+ 1
- 1
doc/index.org Voir le fichier 

@@ -16,7 +16,7 @@
16 16 
 Freedombone is a self-hosted home server configuration which can be installed onto any computer capable of running Debian Jessie. If you have an old laptop or netbook which you can leave turned on then you can use Freedombone to provide your own internet services, such as blogging, wiki, email, chat and social networking and have independence from the well known internet companies.
17 17
18 18 
 #+BEGIN_QUOTE
19 
-"With the increasing move of our computing to cloud infrastructures, we give up the control of our computing to the managers of our those infrastructures. Our terminals (laptops, desktops) might now be running entirely on Free Software, but this is increasingly irrelevant given that most of what actually matters gets executed on a remote closed system that we don’t control. The Free Software community needs to work to help users keep the control of all their computing, by developing suitable alternatives and facilitating their deployment." -- Lucas Nussbaum
19 
+"With the increasing move of our computing to cloud infrastructures, we give up the control of our computing to the managers of those infrastructures. Our terminals (laptops, desktops) might now be running entirely on Free Software, but this is increasingly irrelevant given that most of what actually matters gets executed on a remote closed system that we don’t control. The Free Software community needs to work to help users keep the control of all their computing, by developing suitable alternatives and facilitating their deployment." -- Lucas Nussbaum
20 20 
 #+END_QUOTE
21 21
22 22 
 Today everyone is concerned about privacy on the internet.  At the same time there's a problem with the companies who have traditionally provided most of the web services. The people running those companies may be well-intentioned - as in the famous motto "/don't be evil/" - but the advertising based business model which currently dominates, combined with an increasing level of political pressure to insert backdoors means that it is usually impossible for companies operating within both their own business models and the framework of national laws to provide you with services which don't intentionally leak your private communications to advertisers, insurers or governments.

+ 44
- 7
website/index.html Voir le fichier 

@@ -4,7 +4,7 @@
4 4 
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5 5 
 <head>
6 6 
 <title></title>
7 
-<!-- 2015-01-23 Fri 21:17 -->
7 
+<!-- 2015-01-23 Fri 21:20 -->
8 8 
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
9 9 
 <meta  name="generator" content="Org-mode" />
10 10 
 <meta  name="author" content="Bob Mottram" />
 
@@ -91,6 +91,10 @@
91 91 
     { background-color: #ffff00; color: #000000; font-weight: bold; }
92 92 
   /*]]>*/-->
93 93 
 </style>
94 
+<link rel="stylesheet" type="text/css"
95 
+href="http://sachachua.com/blog/wp-content/themes/sacha-v3/foundation/css/foundation.min.css"></link>
96 
+<link rel="stylesheet" type="text/css" href="http://sachachua.com/org-export.css"></link>
97 
+<link rel="stylesheet" type="text/css" href="http://sachachua.com/blog/wp-content/themes/sacha-v3/style.css"></link>
94 98 
 <script type="text/javascript">
95 99 
 /*
96 100 
 @licstart  The following is the entire license notice for the
 
@@ -139,6 +143,9 @@ for the JavaScript code in this tag.
139 143 
 </script>
140 144 
 </head>
141 145 
 <body>
146 
+<div id="preamble" class="status">
147 
+<a name="top" id="top"></a>
148 
+</div>
142 149 
 <div id="content">
143 150 
 <h1 class="title"></h1>
144 151 
 <div class="center">
 
@@ -194,7 +201,7 @@ Freedombone is a self-hosted home server configuration which can be installed on
194 201
195 202 
 <blockquote>
196 203 
 <p>
197 
-"With the increasing move of our computing to cloud infrastructures, we give up the control of our computing to the managers of our those infrastructures. Our terminals (laptops, desktops) might now be running entirely on Free Software, but this is increasingly irrelevant given that most of what actually matters gets executed on a remote closed system that we don’t control. The Free Software community needs to work to help users keep the control of all their computing, by developing suitable alternatives and facilitating their deployment." &#x2013; Lucas Nussbaum
204 
+"With the increasing move of our computing to cloud infrastructures, we give up the control of our computing to the managers of those infrastructures. Our terminals (laptops, desktops) might now be running entirely on Free Software, but this is increasingly irrelevant given that most of what actually matters gets executed on a remote closed system that we don’t control. The Free Software community needs to work to help users keep the control of all their computing, by developing suitable alternatives and facilitating their deployment." &#x2013; Lucas Nussbaum
198 205 
 </p>
199 206 
 </blockquote>
200 207 
 
@@ -219,14 +226,44 @@ You can bypass all of these dilemmas and take back ownership of your internet co
219 226 
 </div>
220 227
221 228 
 <p>
222 
-An emphasis of the Freedombone project is the protection of private communications from indiscriminate mass surveillance, otherwise known as "<i>bulk intercept</i>" or "<i>warrantless wiretapping</i>". With only a few exceptions data entering and leaving the system is encrypted using settings recommended by <a href="https://bettercrypto.org">bettercrypto.org</a>. Stored emails are encrypted such that only someone knowing your GPG password can read them and a GPG key is created automatically if you don't already have one. The system is firewalled with only the necessary ports being opened. Exclusively <a href="http://en.wikipedia.org/wiki/Free_software">free software</a> is used so that all of it can potentially be security audited and proprietary repositaries are disabled by default. There are still numerous security problems with the internet in general and software always contains bugs, but a best attempt has been made to ensure that the Freedombone is at least more secure than average. A limitation is that this system will not protect you from metadata analysis, although it is hoped that new types of email system may be able to do that in future.
229 
+An emphasis of the Freedombone project is the protection of private communications from indiscriminate mass surveillance, otherwise known as "<i>bulk intercept</i>" or "<i>warrantless wiretapping</i>". With only a few exceptions data entering and leaving the system is encrypted using settings recommended by <a href="https://bettercrypto.org/">bettercrypto.org</a>. Stored emails are encrypted such that only someone knowing your GPG password can read them and a GPG key is created automatically if you don't already have one. The system is firewalled with only the necessary ports being opened. Exclusively <a href="http://en.wikipedia.org/wiki/Free_software">free software</a> is used so that all of it can potentially be security audited and proprietary repositaries are disabled by default. There are still numerous security problems with the internet in general and software always contains bugs, but a best attempt has been made to ensure that the Freedombone is at least more secure than average. A limitation is that this system will not protect you from metadata analysis, although it is hoped that new types of email system may be able to do that in future.
223 230 
 </p>
224 231 
 </div>
225 232 
 <div id="postamble" class="status">
226 
-<p class="author">Author: Bob Mottram</p>
227 
-<p class="date">Created: 2015-01-23 Fri 21:17</p>
228 
-<p class="creator"><a href="http://www.gnu.org/software/emacs/">Emacs</a> 24.4.1 (<a href="http://orgmode.org">Org</a> mode 8.2.10)</p>
229 
-<p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
233 
+
234 
+<style type="text/css">
235 
+.back-to-top {
236 
+    position: fixed;
237 
+    bottom: 2em;
238 
+    right: 0px;
239 
+    text-decoration: none;
240 
+    color: #000000;
241 
+    background-color: rgba(235, 235, 235, 0.80);
242 
+    font-size: 12px;
243 
+    padding: 1em;
244 
+    display: none;
245 
+}
246 
+
247 
+.back-to-top:hover {
248 
+    background-color: rgba(135, 135, 135, 0.50);
249 
+}
250 
+</style>
251 
+
252 
+<div class="back-to-top">
253 
+<a href="#top">Back to top</a> | <a href="mailto:bob@robotics.uk.to">E-mail me</a>
254 
+</div>
255 
+
256 
+<script type="text/javascript">
257 
+    var offset = 220;
258 
+    var duration = 500;
259 
+    jQuery(window).scroll(function() {
260 
+        if (jQuery(this).scrollTop() > offset) {
261 
+            jQuery('.back-to-top').fadeIn(duration);
262 
+        } else {
263 
+            jQuery('.back-to-top').fadeOut(duration);
264 
+        }
265 
+    });
266 
+</script>
230 267 
 </div>
231 268 
 </body>
232 269 
 </html>

+ 125
- 153
website/installation.html Voir le fichier 

@@ -4,7 +4,7 @@
4 4 
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5 5 
 <head>
6 6 
 <title></title>
7 
-<!-- 2015-01-21 Wed 20:17 -->
7 
+<!-- 2015-01-16 Fri 23:51 -->
8 8 
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
9 9 
 <meta  name="generator" content="Org-mode" />
10 10 
 <meta  name="author" content="Bob Mottram" />
 
@@ -168,32 +168,38 @@ for the JavaScript code in this tag.
168 168 
 <col  class="left" />
169 169
170 170 
 <col  class="left" />
171 
-
172 
-<col  class="left" />
173 
-
174 
-<col  class="left" />
175 171 
 </colgroup>
176 172 
 <tbody>
177 173 
 <tr>
178 174 
 <td class="left"><a href="index.html">Home</a></td>
179 
-<td class="left"><a href="#unnumbered-1">Preparation for the Beaglebone Black</a></td>
180 
-<td class="left"><a href="#unnumbered-2">Checklist</a></td>
181 
-<td class="left"><a href="#unnumbered-3">GPG Keys</a></td>
182 
-<td class="left"><a href="#unnumbered-4">Interactive Setup</a></td>
183 
-<td class="left"><a href="#unnumbered-5">Non-Interactive Setup</a></td>
184 
-<td class="left"><a href="#unnumbered-6">Post-Setup</a></td>
175 
+<td class="left"><i>Download the code</i></td>
176 
+<td class="left"><a href="#unnumbered-2">On a Beaglebone Black</a></td>
177 
+<td class="left"><a href="#unnumbered-3">On a laptop/PC/netbook</a></td>
178 
+<td class="left"><a href="#unnumbered-4">Internet Router</a></td>
185 179 
 </tr>
186 180 
 </tbody>
187 181 
 </table>
188 182
189 
-
190 183 
 <div id="outline-container-unnumbered-1" class="outline-2">
191 
-<h2 id="unnumbered-1">Preparation for the Beaglebone Black</h2>
184 
+<h2 id="unnumbered-1">Download and install the code</h2>
192 185 
 <div class="outline-text-2" id="text-unnumbered-1">
193 186 
 <p>
194 
-This section is specific to the Beaglebone Black hardware. If you're not using that hardware then just skip to the next section.
187 
+Firstly you'll need to download the code as follows:
195 188 
 </p>
196 189
190 
+<div class="org-src-container">
191 
+
192 
+<pre class="src src-bash">sudo apt-get install git
193 
+git clone https://github.com/bashrc/freedombone
194 
+<span class="org-builtin">cd</span> freedombone
195 
+make install
196 
+</pre>
197 
+</div>
198 
+</div>
199 
+</div>
200 
+<div id="outline-container-unnumbered-2" class="outline-2">
201 
+<h2 id="unnumbered-2">On a Beaglebone Black</h2>
202 
+<div class="outline-text-2" id="text-unnumbered-2">
197 203 
 <p>
198 204 
 To get started you will need:
199 205 
 </p>
 
@@ -211,7 +217,7 @@ To get started you will need:
211 217 
 </li>
212 218 
 <li>USB thumb drive (for backups or storing media)
213 219 
 </li>
214 
-<li>One or more domains available via a dynamic DNS provider, such as <a href="https://freedns.afraid.org/">https://freedns.afraid.org/</a>
220 
+<li>One or more subdomains created on <a href="https://freedns.afraid.org/">https://freedns.afraid.org/</a>
215 221 
 </li>
216 222 
 <li>A purchased domain name and SSL certificate (only needed for Red Matrix)
217 223 
 </li>
 
@@ -224,217 +230,183 @@ You will also need to know, or find out, the IP address of your internet router
224 230 
 </p>
225 231
226 232 
 <p>
227 
-You can either install from a debian package or manually as follows:
233 
+Plug the microSD card into your laptop/desktop and then run the <b>freedombone-prep</b> command. For example:
228 234 
 </p>
229 235
230 236 
 <div class="org-src-container">
231 237
232 
-<pre class="src src-bash">sudo apt-get install git dialog
233 
-git clone https://github.com/bashrc/freedombone
234 
-<span class="org-builtin">cd</span> freedombone
235 
-sudo make install
238 
+<pre class="src src-bash">freedombone-prep -d /dev/sdX --ip &lt;static LAN IP&gt; --iprouter &lt;router LAN IP&gt;
236 239 
 </pre>
237 240 
 </div>
238 241
239 242 
 <p>
240 
-Plug the microSD card into your laptop/desktop and then run the <b>freedombone-prep</b> command. For example:
243 
+where <b>/dev/sdX</b> is the device name for the microSD card. Often it's <b>/dev/sdb</b> or <b>/dev/sdc</b>, depending upon how many drives there are on your system. The script will download the Debian installer and update the microSD card. It can take a while, so be patient.
244 
+</p>
245 
+
246 
+<p>
247 
+When the initial setup is done follow the instructions on screen to run the main Freedombone script. You can create a separate configuration file called <b>freedombone.cfg</b> which contains those variables. Variables which you might want to put into a <b>freedombone.cfg</b> file are:
241 248 
 </p>
242 249
243 250 
 <div class="org-src-container">
244 251
245 
-<pre class="src src-bash">freedombone-prep -d /dev/sdX --ip freedombone_IP_address --iprouter router_IP_address
252 
+<pre class="src src-bash"><span class="org-variable-name">MY_EMAIL_ADDRESS</span>=&lt;your email address&gt;
253 
+<span class="org-variable-name">MY_NAME</span>=&lt;your name/nick/pseudonym&gt;
254 
+<span class="org-variable-name">MY_BLOG_TITLE</span>=&lt;title of your blog&gt;
255 
+<span class="org-variable-name">MY_BLOG_SUBTITLE</span>=&lt;subtitle of your blog&gt;
256 
+<span class="org-variable-name">SSH_PORT</span>=2222
257 
+<span class="org-variable-name">FULLBLOG_DOMAIN_NAME</span>=&lt;freedns subdomain for your blog&gt;
258 
+<span class="org-variable-name">FULLBLOG_FREEDNS_SUBDOMAIN_CODE</span>=&lt;freedns subdomain code for your blog&gt;
259 
+<span class="org-variable-name">MICROBLOG_DOMAIN_NAME</span>=&lt;domain name for your microblog&gt;
260 
+<span class="org-variable-name">MICROBLOG_FREEDNS_SUBDOMAIN_CODE</span>=1234
261 
+<span class="org-variable-name">REDMATRIX_DOMAIN_NAME</span>=&lt;domain name for your Red Matrix site&gt;
262 
+<span class="org-variable-name">OWNCLOUD_DOMAIN_NAME</span>=&lt;freedns subdomain for your Owncloud site&gt;
263 
+<span class="org-variable-name">OWNCLOUD_FREEDNS_SUBDOMAIN_CODE</span>=&lt;freedns subdomain code for your Owncloud site&gt;
264 
+<span class="org-variable-name">WIKI_TITLE</span>=&lt;title of your wiki&gt;
265 
+<span class="org-variable-name">WIKI_DOMAIN_NAME</span>=&lt;freedns subdomain for your wiki&gt;
266 
+<span class="org-variable-name">WIKI_FREEDNS_SUBDOMAIN_CODE</span>=&lt;freedns subdomain code for your wiki&gt;
267 
+<span class="org-variable-name">MY_GPG_PUBLIC_KEY</span>=&lt;exported public key filename&gt;
268 
+<span class="org-variable-name">MY_GPG_PRIVATE_KE</span>=&lt;exported private key filename&gt;
269 
+<span class="org-variable-name">PUBLIC_MAILING_LIST</span>=&lt;name of your mailing list&gt;
270 
+<span class="org-variable-name">LOCAL_NETWORK_STATIC_IP_ADDRESS</span>=192.168.1.60
271 
+<span class="org-variable-name">ROUTER_IP_ADDRESS</span>=192.168.1.254
272 
+<span class="org-variable-name">ENABLE_CJDNS</span>=no
246 273 
 </pre>
247 274 
 </div>
248 275
249 276 
 <p>
250 
-where /dev/sdX is the device name for the microSD card. Often it's /dev/sdb or /dev/sdc, depending upon how many drives there are on your system. The script will download the Debian installer and update the microSD card. It can take a while, so be patient.
277 
+The GPG public/private key variables are for the filenames of exported GPG keys, and if a private key filename is given then it will be automatically shredded after import.
251 278 
 </p>
252 279
253 280 
 <p>
254 
-When the initial setup is done follow the instructions on screen to run the main freedombone command.
281 
+The <a href="https://freedns.afraid.org/">FreeDNS</a> subdomain codes can be found under "Dynamic DNS" and "quick cron example". On the last line it will be the string located between the '?' and the '==' characters.
255 282 
 </p>
256 
-</div>
257 
-</div>
258 283
259 
-<div id="outline-container-unnumbered-2" class="outline-2">
260 
-<h2 id="unnumbered-2">Checklist</h2>
261 
-<div class="outline-text-2" id="text-unnumbered-2">
262 284 
 <p>
263 
-Before running the freedombone command you will need a few things.
264 
-</p>
265 
-
266 
-<ul class="org-ul">
267 
-<li>Have some domains, or subdomains, registered with a dynamic DNS service
268 
-</li>
269 
-<li>System with a new installation of Debian Jessie
270 
-</li>
271 
-<li>Ethernet connection to an internet router
272 
-</li>
273 
-<li>It is possible to forward ports from the internet router to the system
274 
-</li>
275 
-<li>If you want to set up a social network or microblog then you will need SSL certificates corresponding to those domains
276 
-</li>
277 
-<li>Have ssh access to the system
278 
-</li>
279 
-</ul>
280 
-</div>
281 
-</div>
282 
-
283 
-<div id="outline-container-unnumbered-3" class="outline-2">
284 
-<h2 id="unnumbered-3">GPG Keys</h2>
285 
-<div class="outline-text-2" id="text-unnumbered-3">
286 
-<p>
287 
-If you have existing GPG keys then copy the .gnupg directory onto the system.
285 
+The syntax of the <b>freedombone</b> command is:
288 286 
 </p>
289 287
290 288 
 <div class="org-src-container">
291 289
292 
-<pre class="src src-bash">scp -r ~/.gnupg username@freedombone_IP_address:/home/username
290 
+<pre class="src src-bash">freedombone --bbb -d [domain name] -u [username] -c [FreeDNS subdomain code] --ddnsuser [FreeDNS username] --ddnspass [FreeDNS password] -s [optional variant type]
293 291 
 </pre>
294 292 
 </div>
295 
-</div>
296 
-</div>
297 293
298 
-<div id="outline-container-unnumbered-4" class="outline-2">
299 
-<h2 id="unnumbered-4">Interactive Setup</h2>
300 
-<div class="outline-text-2" id="text-unnumbered-4">
301 294 
 <p>
302 
-The interactive server configuration setup is recommended for most users. On the system where freedombone is to be installed create a configuration file.
295 
+Also see the manpage for additional options which can be used instead of a configuration file. If you don't specify a variant type with the final option then everything will be installed. If you have a <b>freedombone.cfg</b> file then it should be in the same directory from which the <b>freedombone</b> command is run.
303 296 
 </p>
304 297
305 
-<div class="org-src-container">
306 
-
307 
-<pre class="src src-bash">ssh username@freedombone_IP_address
308 
-su
309 
-apt-get install git dialog
310 
-git clone https://github.com/bashrc/freedombone
311 
-<span class="org-builtin">cd</span> freedombone
312 
-make install
313 
-</pre>
314 
-</div>
298 
+<p>
299 
+Installation is not quick, and depends upon which variant you choose and your internet bandwidth. Allow about three hours for a full installation on the Beaglebone Black. On the Beaglebone installation is in two parts, since a reboot is needed to enable the hardware random number generator and zram.
300 
+</p>
315 301
316 302 
 <p>
317 
-Now the easiest way to install the system is via the interactive setup.
303 
+When done you can ssh into the Freedombone with:
318 304 
 </p>
319 305
320 306 
 <div class="org-src-container">
321 307
322 
-<pre class="src src-bash">freedombone menuconfig
308 
+<pre class="src src-bash">ssh username@domain -p 2222
323 309 
 </pre>
324 310 
 </div>
325 311
326 312 
 <p>
327 
-You can select which variant you wish to install and then enter the details as requested. A video of the install sequence can be <a href="./installer.ogv">seen here</a>.
313 
+Any manual post-installation setup instructions or passwords can be found in <b>/home/username/README</b>. You should remove any passwords from that file and store them within a password manager such as KeepassX.
328 314 
 </p>
329 315 
 </div>
330 316 
 </div>
331 317
332 
-<div id="outline-container-unnumbered-5" class="outline-2">
333 
-<h2 id="unnumbered-5">Non-Interactive Setup</h2>
334 
-<div class="outline-text-2" id="text-unnumbered-5">
335 
-<p>
336 
-If you don't want to install interactively then it's possible to manually create a configuration file as follows:
337 
-</p>
338 
-
318 
+<div id="outline-container-unnumbered-3" class="outline-2">
319 
+<h2 id="unnumbered-3">On a laptop/PC/netbook</h2>
320 
+<div class="outline-text-2" id="text-unnumbered-3">
339 321 
 <p>
340 
-On the system where freedombone is to be installed create a configuration file.
322 
+It's also possible to install Freedombone onto other hardware, including other types of single board computer. Any system with a fresh installation of Debian Jessie will do. Just make sure that you change the variable INSTALLING_ON_BBB to "no" within <b>freedombone.cfg</b> or do not include the <b>&#x2013;bbb</b> option within the <b>freedombone</b> command. Obviously, you don't need to run the <b>freedombone-prep</b> command on non-Beaglebone systems.
341 323 
 </p>
342 324
325 
+<ul class="org-ul">
326 
+<li>Download the <a href="https://www.debian.org/devel/debian-installer">Debian Jessie "netinst" installer</a>
327 
+</li>
328 
+<li>Use <a href="https://apps.ubuntu.com/cat/applications/usb-creator-gtk/">Startup Disk Creator</a> or <a href="https://en.wikipedia.org/wiki/UNetbootin">Unetbootin</a> to copy the netinst image to a USB thumb drive
329 
+</li>
330 
+<li>Connect the machine to your internet router using an ethernet patch lead. Freedombone is a fully free (as in freedom) system and so wifi drivers may not work. A wired network connection will give better performance anyway.
331 
+</li>
332 
+<li>On the target machine boot from the USB drive and go through the installation. It's a good idea to use LVM and disk encryption together with a long passphrase which will be hard to crack by brute force methods. Keep a note of the passphrase in your password manager.
333 
+</li>
334 
+<li>Within the installer unselect the <b>print server</b> and select the <b>ssh server</b>
335 
+</li>
336 
+<li>After installation use ssh to access the machine and become the root user
337 
+</li>
338 
+</ul>
343 339 
 <div class="org-src-container">
344 340
345 
-<pre class="src src-bash">ssh username@freedombone_IP_address
341 
+<pre class="src src-bash">ssh username@192.168.1.60
346 342 
 su
343 
+</pre>
344 
+</div>
345 
+<ul class="org-ul">
346 
+<li>If you have GPG keys you may wish to transfer them to the <b>/home/usernname</b> directory. If the machine has a second USB socket or an SD card slot then that may be the most secure way to do it.
347 
+</li>
348 
+<li>Run the following commands:
349 
+</li>
350 
+</ul>
351 
+<div class="org-src-container">
352 
+
353 
+<pre class="src src-bash"><span class="org-builtin">cd</span> /home/&lt;username&gt;
347 354 
 apt-get install git
348 355 
 git clone https://github.com/bashrc/freedombone
349 356 
 <span class="org-builtin">cd</span> freedombone
350 357 
 make install
351 
-nano /home/username/freedombone/freedombone.cfg
358 
+nano freedombone.cfg
352 359 
 </pre>
353 360 
 </div>
354 361
355 
-<p>
356 
-Add the following, and set the values as needed.
357 
-</p>
358 
-
362 
+<ul class="org-ul">
363 
+<li>Now create a configuration file, such as the following, filling in the details for your <a href="https://freedns.afraid.org/">FreeDNS subdomains</a>.
364 
+</li>
365 
+</ul>
359 366 
 <div class="org-src-container">
360 367
361 
-<pre class="src src-bash"><span class="org-variable-name">MY_EMAIL_ADDRESS</span>=
362 
-<span class="org-variable-name">MY_NAME</span>=
363 
-<span class="org-variable-name">MY_BLOG_TITLE</span>=
364 
-<span class="org-variable-name">MY_BLOG_SUBTITLE</span>=
365 
-<span class="org-variable-name">FULLBLOG_DOMAIN_NAME</span>=
366 
-<span class="org-variable-name">MICROBLOG_DOMAIN_NAME</span>=
367 
-<span class="org-variable-name">REDMATRIX_DOMAIN_NAME</span>=
368 
-<span class="org-variable-name">OWNCLOUD_DOMAIN_NAME</span>=
369 
-<span class="org-variable-name">WIKI_DOMAIN_NAME</span>=
370 
-<span class="org-variable-name">WIKI_TITLE</span>=
368 
+<pre class="src src-bash"><span class="org-variable-name">INSTALLING_ON_BBB</span>=no
369 
+<span class="org-variable-name">MY_EMAIL_ADDRESS</span>=&lt;your email address&gt;
370 
+<span class="org-variable-name">MY_NAME</span>=&lt;your name/nick/pseudonym&gt;
371 
+<span class="org-variable-name">MY_BLOG_TITLE</span>=&lt;title of your blog&gt;
372 
+<span class="org-variable-name">MY_BLOG_SUBTITLE</span>=&lt;subtitle of your blog&gt;
373 
+<span class="org-variable-name">SSH_PORT</span>=2222
374 
+<span class="org-variable-name">FULLBLOG_DOMAIN_NAME</span>=&lt;freedns subdomain for your blog&gt;
375 
+<span class="org-variable-name">FULLBLOG_FREEDNS_SUBDOMAIN_CODE</span>=&lt;freedns subdomain code for your blog&gt;
376 
+<span class="org-variable-name">MICROBLOG_DOMAIN_NAME</span>=&lt;domain name for your microblog&gt;
377 
+<span class="org-variable-name">MICROBLOG_FREEDNS_SUBDOMAIN_CODE</span>=1234
378 
+<span class="org-variable-name">REDMATRIX_DOMAIN_NAME</span>=&lt;domain name for your Red Matrix site&gt;
379 
+<span class="org-variable-name">OWNCLOUD_DOMAIN_NAME</span>=&lt;freedns subdomain for your Owncloud site&gt;
380 
+<span class="org-variable-name">OWNCLOUD_FREEDNS_SUBDOMAIN_CODE</span>=&lt;freedns subdomain code for your Owncloud site&gt;
381 
+<span class="org-variable-name">WIKI_TITLE</span>=&lt;title of your wiki&gt;
382 
+<span class="org-variable-name">WIKI_DOMAIN_NAME</span>=&lt;freedns subdomain for your wiki&gt;
383 
+<span class="org-variable-name">WIKI_FREEDNS_SUBDOMAIN_CODE</span>=&lt;freedns subdomain code for your wiki&gt;
384 
+<span class="org-variable-name">MY_GPG_PUBLIC_KEY</span>=&lt;exported public key filename&gt;
385 
+<span class="org-variable-name">MY_GPG_PRIVATE_KE</span>=&lt;exported private key filename&gt;
386 
+<span class="org-variable-name">PUBLIC_MAILING_LIST</span>=&lt;name of your mailing list&gt;
387 
+<span class="org-variable-name">LOCAL_NETWORK_STATIC_IP_ADDRESS</span>=192.168.1.60
388 
+<span class="org-variable-name">ROUTER_IP_ADDRESS</span>=192.168.1.254
371 389 
 <span class="org-variable-name">ENABLE_CJDNS</span>=no
372 
-<span class="org-variable-name">LOCAL_NETWORK_STATIC_IP_ADDRESS</span>=
373 
-<span class="org-variable-name">ROUTER_IP_ADDRESS</span>=
374 
-</pre>
375 
-</div>
376 
-
377 
-<p>
378 
-Both of the IP addresses are local IP addresses, typically of the form 192.168.x.x, with one being for the system and the other being for the internet router.
379 
-</p>
380 
-
381 
-<p>
382 
-Save the configuration file and exit from your editor.
383 
-</p>
384 
-
385 
-<p>
386 
-Now you can begin the installation. If you are doing this on a Beaglebone Black:
387 
-</p>
388 
-
389 
-<div class="org-src-container">
390 
-
391 
-<pre class="src src-bash">freedombone --bbb -d [default domain name] -u [username] --ddns [dynamic DNS provider domain] --ddnsuser [dynamic DNS username] --ddnspass [dynamic DNS password]
392 390 
 </pre>
393 391 
 </div>
394 392
395 
-<p>
396 
-Or on any other system don't include the <b>&#x2013;bbb</b> option.
397 
-</p>
398 
-
393 
+<ul class="org-ul">
394 
+<li>Save and exit, then run:
395 
+</li>
396 
+</ul>
399 397 
 <div class="org-src-container">
400 398
401 
-<pre class="src src-bash">freedombone -d [default domain name] -u [username] --ddns [dynamic DNS provider domain] --ddnsuser [dynamic DNS username] --ddnspass [dynamic DNS password]
399 
+<pre class="src src-bash">freedombone -d [your wiki domain name] -u [your username] -c [your wiki FreeDNS domain code] --ddnsuser [FreeDNS username] --ddnspass [FreeDNS password]
402 400 
 </pre>
403 401 
 </div>
404 
-
405 
-<p>
406 
-The above command should be run in the same directory in which your configuration file exists. You can use any of your domains as the default one, but typically the default domain is the same as the one for your wiki.
407 
-</p>
408 
-
409 
-<p>
410 
-Also see the manpage for additional options which can be used instead of a configuration file. If you don't specify a variant type with the final option then everything will be installed. If you have a <b>freedombone.cfg</b> file then it should be in the same directory from which the <b>freedombone</b> command is run.
411 
-</p>
412 402 
 </div>
413 403 
 </div>
414 404
415 
-<div id="outline-container-unnumbered-6" class="outline-2">
416 
-<h2 id="unnumbered-6">Post-Setup</h2>
417 
-<div class="outline-text-2" id="text-unnumbered-6">
418 
-<p>
419 
-Setup of the server and installation of all the relevant packages is not quick, and depends upon which variant you choose and your internet bandwidth. Allow about three hours for a full installation on the Beaglebone Black. On the Beaglebone installation is in two parts, since a reboot is needed to enable the hardware random number generator and zram.
420 
-</p>
421 
-
422 
-<p>
423 
-When done you can ssh into the Freedombone with:
424 
-</p>
425 
-
426 
-<div class="org-src-container">
427 
-
428 
-<pre class="src src-bash">ssh username@domain -p 2222
429 
-</pre>
430 
-</div>
431 
-
432 
-<p>
433 
-Any manual post-installation setup instructions or passwords can be found in /home/username/README. You should remove any passwords from that file and store them within a password manager such as KeepassX.
434 
-</p>
435 
-
405 
+<div id="outline-container-unnumbered-4" class="outline-2">
406 
+<h2 id="unnumbered-4">Internet Router</h2>
407 
+<div class="outline-text-2" id="text-unnumbered-4">
436 408 
 <p>
437 
-On your internet router, typically under firewall settings, open the following ports and forward them to your server.
409 
+On your internet router, typically under firewall settings, open the following ports and forward them to the Freedombone.
438 410 
 </p>
439 411
440 412 
 <table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">