free
/
freedombone
關註 1
收藏 0
複製 0
程式碼 問題管理 0 合併請求 0 版本發佈 0 Wiki Activity
瀏覽代碼

Stylesheet

Bob Mottram 10 年之前
父節點
a16d3b6327
當前提交
15818e7a49
共有 3 個文件被更改，包括 170 次插入 和 161 次删除
統一視圖 顯示文件統計
  1. 1
    1
      doc/index.org
  2. 44
    7
      website/index.html
  3. 125
    153
      website/installation.html

+ 1
- 1
doc/index.org 查看文件

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.
 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 
 #+BEGIN_QUOTE
 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 
 #+END_QUOTE
 20 
 #+END_QUOTE
21
21
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.
 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 查看文件

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 
 <title></title>
 6 
 <title></title>
7 
-<!-- 2015-01-23 Fri 21:17 -->
7 
+<!-- 2015-01-23 Fri 21:20 -->
8 
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
 8 
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
9 
 <meta  name="generator" content="Org-mode" />
 9 
 <meta  name="generator" content="Org-mode" />
10 
 <meta  name="author" content="Bob Mottram" />
 10 
 <meta  name="author" content="Bob Mottram" />
91 
     { background-color: #ffff00; color: #000000; font-weight: bold; }
 91 
     { background-color: #ffff00; color: #000000; font-weight: bold; }
92 
   /*]]>*/-->
 92 
   /*]]>*/-->
93 
 </style>
 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 
 <script type="text/javascript">
 98 
 <script type="text/javascript">
95 
 /*
 99 
 /*
96 
 @licstart  The following is the entire license notice for the
 100 
 @licstart  The following is the entire license notice for the
139 
 </script>
 143 
 </script>
140 
 </head>
 144 
 </head>
141 
 <body>
 145 
 <body>
146 
+<div id="preamble" class="status">
147 
+<a name="top" id="top"></a>
148 
+</div>
142 
 <div id="content">
 149 
 <div id="content">
143 
 <h1 class="title"></h1>
 150 
 <h1 class="title"></h1>
144 
 <div class="center">
 151 
 <div class="center">
194
201
195 
 <blockquote>
 202 
 <blockquote>
196 
 <p>
 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 
 </p>
 205 
 </p>
199 
 </blockquote>
 206 
 </blockquote>
200
207
219 
 </div>
 226 
 </div>
220
227
221 
 <p>
 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 
 </p>
 230 
 </p>
224 
 </div>
 231 
 </div>
225 
 <div id="postamble" class="status">
 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 
 </div>
 267 
 </div>
231 
 </body>
 268 
 </body>
232 
 </html>
 269 
 </html>

+ 125
- 153
website/installation.html 查看文件

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 
 <title></title>
 6 
 <title></title>
7 
-<!-- 2015-01-21 Wed 20:17 -->
7 
+<!-- 2015-01-16 Fri 23:51 -->
8 
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
 8 
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
9 
 <meta  name="generator" content="Org-mode" />
 9 
 <meta  name="generator" content="Org-mode" />
10 
 <meta  name="author" content="Bob Mottram" />
 10 
 <meta  name="author" content="Bob Mottram" />
168 
 <col  class="left" />
 168 
 <col  class="left" />
169
169
170 
 <col  class="left" />
 170 
 <col  class="left" />
171 
-
172 
-<col  class="left" />
173 
-
174 
-<col  class="left" />
175 
 </colgroup>
 171 
 </colgroup>
176 
 <tbody>
 172 
 <tbody>
177 
 <tr>
 173 
 <tr>
178 
 <td class="left"><a href="index.html">Home</a></td>
 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 
 </tr>
 179 
 </tr>
186 
 </tbody>
 180 
 </tbody>
187 
 </table>
 181 
 </table>
188
182
189 
-
190 
 <div id="outline-container-unnumbered-1" class="outline-2">
 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 
 <div class="outline-text-2" id="text-unnumbered-1">
 185 
 <div class="outline-text-2" id="text-unnumbered-1">
193 
 <p>
 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 
 </p>
 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 
 <p>
 203 
 <p>
198 
 To get started you will need:
 204 
 To get started you will need:
199 
 </p>
 205 
 </p>
211 
 </li>
 217 
 </li>
212 
 <li>USB thumb drive (for backups or storing media)
 218 
 <li>USB thumb drive (for backups or storing media)
213 
 </li>
 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 
 </li>
 221 
 </li>
216 
 <li>A purchased domain name and SSL certificate (only needed for Red Matrix)
 222 
 <li>A purchased domain name and SSL certificate (only needed for Red Matrix)
217 
 </li>
 223 
 </li>
224 
 </p>
 230 
 </p>
225
231
226 
 <p>
 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 
 </p>
 234 
 </p>
229
235
230 
 <div class="org-src-container">
 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 
 </pre>
 239 
 </pre>
237 
 </div>
 240 
 </div>
238
241
239 
 <p>
 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 
 </p>
 248 
 </p>
242
249
243 
 <div class="org-src-container">
 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 
 </pre>
 273 
 </pre>
247 
 </div>
 274 
 </div>
248
275
249 
 <p>
 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 
 </p>
 278 
 </p>
252
279
253 
 <p>
 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 
 </p>
 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 
 <p>
 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 
 </p>
 286 
 </p>
289
287
290 
 <div class="org-src-container">
 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 
 </pre>
 291 
 </pre>
294 
 </div>
 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 
 <p>
 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 
 </p>
 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 
 <p>
 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 
 </p>
 304 
 </p>
319
305
320 
 <div class="org-src-container">
 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 
 </pre>
 309 
 </pre>
324 
 </div>
 310 
 </div>
325
311
326 
 <p>
 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 
 </p>
 314 
 </p>
329 
 </div>
 315 
 </div>
330 
 </div>
 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 
 <p>
 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 
 </p>
 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 
 <div class="org-src-container">
 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 
 su
 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 
 apt-get install git
 354 
 apt-get install git
348 
 git clone https://github.com/bashrc/freedombone
 355 
 git clone https://github.com/bashrc/freedombone
349 
 <span class="org-builtin">cd</span> freedombone
 356 
 <span class="org-builtin">cd</span> freedombone
350 
 make install
 357 
 make install
351 
-nano /home/username/freedombone/freedombone.cfg
358 
+nano freedombone.cfg
352 
 </pre>
 359 
 </pre>
353 
 </div>
 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 
 <div class="org-src-container">
 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 
 <span class="org-variable-name">ENABLE_CJDNS</span>=no
 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 
 </pre>
 390 
 </pre>
393 
 </div>
 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 
 <div class="org-src-container">
 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 
 </pre>
 400 
 </pre>
403 
 </div>
 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 
 </div>
 402 
 </div>
413 
 </div>
 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 
 <p>
 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 
 </p>
 410 
 </p>
439
411
440 
 <table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
 412 
 <table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">