Bladeren bron

Improve install instructions for laptop/PC

Bob Mottram 10 jaren geleden
bovenliggende
commit
943faf01a9
3 gewijzigde bestanden met toevoegingen van 129 en 8 verwijderingen
  1. 1
    1
      install-freedombone.sh
  2. 51
    3
      installation.org
  3. 77
    4
      website/installation.html

+ 1
- 1
install-freedombone.sh Bestand weergeven

2106
   echo "awk -F ' ' '{print $2}')" >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME
2106
   echo "awk -F ' ' '{print $2}')" >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME
2107
   echo -n '  export RSYNC_PASSWORD=$(echo "${remote_server}" | ' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME
2107
   echo -n '  export RSYNC_PASSWORD=$(echo "${remote_server}" | ' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME
2108
   echo "awk -F ' ' '{print $3}')" >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME
2108
   echo "awk -F ' ' '{print $3}')" >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME
2109
+  echo '  NOW=$(date +"%Y-%m-%d %H:%M:%S")' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME
2109
   echo '' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME
2110
   echo '' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME
2110
 
2111
 
2111
-  echo '  NOW=$(date +"%Y-%m-%d %H:%M:%S")' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME
2112
   echo '  logger -s "$NOW Starting backup to $RSYNC_SERVER" >> /var/log/backup_to_friends.log' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME
2112
   echo '  logger -s "$NOW Starting backup to $RSYNC_SERVER" >> /var/log/backup_to_friends.log' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME
2113
   echo -n '  rsync -avz -e "ssh -p $RSYNC_SSH_PORT" ' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME
2113
   echo -n '  rsync -avz -e "ssh -p $RSYNC_SSH_PORT" ' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME
2114
   echo '$SERVER_DIRECTORY/backup $RSYNC_SERVER' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME
2114
   echo '$SERVER_DIRECTORY/backup $RSYNC_SERVER' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME

+ 51
- 3
installation.org Bestand weergeven

7
 #+BEGIN_CENTER
7
 #+BEGIN_CENTER
8
 [[./images/logo.png]]
8
 [[./images/logo.png]]
9
 #+END_CENTER
9
 #+END_CENTER
10
-| [[file:index.html][Home]] | [[Download the code]] | [[On a Beaglebone Black]] | [[On other hardware]] | [[Internet Router]] |
10
+| [[file:index.html][Home]] | [[Download the code]] | [[On a Beaglebone Black]] | [[On a laptop/PC/netbook]] | [[Internet Router]] |
11
 
11
 
12
 * Download the code
12
 * Download the code
13
 Firstly you'll need to download the code as follows:
13
 Firstly you'll need to download the code as follows:
89
 
89
 
90
 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.
90
 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.
91
 
91
 
92
-* On other hardware
93
-It's also possible to install Freedombone onto other hardware, such as an old laptop or other type 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 *freedombone.cfg* or the *install-freedombone.sh* script. Obviously, you don't need to run the *initial_setup.sh* script on non-Beaglebone systems.
92
+* On a laptop/PC/netbook
93
+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 *freedombone.cfg* or the *install-freedombone.sh* script. Obviously, you don't need to run the *initial_setup.sh* script on non-Beaglebone systems.
94
+
95
+ * Download the [[https://www.debian.org/devel/debian-installer][Debian Jessie "netinst" installer]]
96
+ * Use [[https://apps.ubuntu.com/cat/applications/usb-creator-gtk/][Startup Disk Creator]] or [[https://en.wikipedia.org/wiki/UNetbootin][Unetbootin]] to copy the netinst image to a USB thumb drive
97
+ * 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.
98
+ * Within the installer unselect the *print server* and select the *ssh server*
99
+ * After installation use ssh to access the machine and become the root user
100
+#+BEGIN_SRC bash
101
+ssh username@192.168.1.60
102
+su
103
+#+END_SRC
104
+ * If you have GPG keys you may wish to transfer them to the */home/usernname* 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.
105
+ * Run the following commands:
106
+#+BEGIN_SRC bash
107
+cd /home/<username>
108
+apt-get install git
109
+git clone https://github.com/bashrc/freedombone
110
+cd freedombone
111
+nano freedombone.cfg
112
+#+END_SRC
113
+
114
+ * Now create a configuration file, such as the following, filling in the details for your [[https://freedns.afraid.org/][FreeDNS domains]].
115
+#+BEGIN_SRC bash
116
+INSTALLING_ON_BBB=no
117
+MY_EMAIL_ADDRESS=<your email>
118
+MY_NAME=<your name>
119
+MY_BLOG_TITLE=<your blog title>
120
+MY_BLOG_SUBTITLE=<your blog subtitle>
121
+SSH_PORT=2222
122
+FULLBLOG_DOMAIN_NAME=<your blog domain name
123
+FULLBLOG_FREEDNS_SUBDOMAIN_CODE=<your blog FreeDNS code>
124
+MICROBLOG_DOMAIN_NAME=<your GNU Social domain name>
125
+MICROBLOG_FREEDNS_SUBDOMAIN_CODE=<your GNU social FreeDNS domain code>
126
+REDMATRIX_DOMAIN_NAME=<your Red Matrix domain name>
127
+REDMATRIX_FREEDNS_SUBDOMAIN_CODE=1234
128
+OWNCLOUD_DOMAIN_NAME=<your Owncloud domain name>
129
+OWNCLOUD_FREEDNS_SUBDOMAIN_CODE=<your Owncloud FreeDNS domain code>
130
+WIKI_DOMAIN_NAME=<your wiki domain name>
131
+WIKI_FREEDNS_SUBDOMAIN_CODE=<your wiki FreeDNS domain code>
132
+WIKI_TITLE=<your wiki title>
133
+ROUTE_THROUGH_TOR=no
134
+LOCAL_NETWORK_STATIC_IP_ADDRESS=192.168.1.60
135
+#+END_SRC
136
+
137
+ * Save and exit, then run:
138
+#+BEGIN_SRC bash
139
+./install-freedombone.sh <your wiki domain name> <your username> <your wiki FreeDNS domain code>
140
+#+END_SRC
141
+
94
 * Internet Router
142
 * Internet Router
95
 On your internet router, typically under firewall settings, open the following ports and forward them to the Freedombone.
143
 On your internet router, typically under firewall settings, open the following ports and forward them to the Freedombone.
96
 
144
 

+ 77
- 4
website/installation.html Bestand weergeven

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
-<!-- 2014-10-26 Sun 22:02 -->
7
+<!-- 2014-12-20 Sat 11:04 -->
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" />
174
 <td class="left"><a href="index.html">Home</a></td>
174
 <td class="left"><a href="index.html">Home</a></td>
175
 <td class="left"><a href="#unnumbered-1">Download the code</a></td>
175
 <td class="left"><a href="#unnumbered-1">Download the code</a></td>
176
 <td class="left"><a href="#unnumbered-2">On a Beaglebone Black</a></td>
176
 <td class="left"><a href="#unnumbered-2">On a Beaglebone Black</a></td>
177
-<td class="left"><a href="#unnumbered-3">On other hardware</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>
178
 <td class="left"><a href="#unnumbered-4">Internet Router</a></td>
179
 </tr>
179
 </tr>
180
 </tbody>
180
 </tbody>
318
 </div>
318
 </div>
319
 
319
 
320
 <div id="outline-container-unnumbered-3" class="outline-2">
320
 <div id="outline-container-unnumbered-3" class="outline-2">
321
-<h2 id="unnumbered-3">On other hardware</h2>
321
+<h2 id="unnumbered-3">On a laptop/PC/netbook</h2>
322
 <div class="outline-text-2" id="text-unnumbered-3">
322
 <div class="outline-text-2" id="text-unnumbered-3">
323
 <p>
323
 <p>
324
-It's also possible to install Freedombone onto other hardware, such as an old laptop or other type 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 the <b>install-freedombone.sh</b> script. Obviously, you don't need to run the <b>initial_setup.sh</b> script on non-Beaglebone systems.
324
+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 the <b>install-freedombone.sh</b> script. Obviously, you don't need to run the <b>initial_setup.sh</b> script on non-Beaglebone systems.
325
 </p>
325
 </p>
326
+
327
+<ul class="org-ul">
328
+<li>Download the <a href="https://www.debian.org/devel/debian-installer">Debian Jessie "netinst" installer</a>
329
+</li>
330
+<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
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>
339
+<div class="org-src-container">
340
+
341
+<pre class="src src-bash">ssh username@192.168.1.60
342
+su
343
+</pre>
326
 </div>
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;
354
+apt-get install git
355
+git clone https://github.com/bashrc/freedombone
356
+<span class="org-builtin">cd</span> freedombone
357
+nano freedombone.cfg
358
+</pre>
327
 </div>
359
 </div>
360
+
361
+<ul class="org-ul">
362
+<li>Now create a configuration file, such as the following, filling in the details for your <a href="https://freedns.afraid.org/">FreeDNS domains</a>.
363
+</li>
364
+</ul>
365
+<div class="org-src-container">
366
+
367
+<pre class="src src-bash"><span class="org-variable-name">INSTALLING_ON_BBB</span>=no
368
+<span class="org-variable-name">MY_EMAIL_ADDRESS</span>=&lt;your email&gt;
369
+<span class="org-variable-name">MY_NAME</span>=&lt;your name&gt;
370
+<span class="org-variable-name">MY_BLOG_TITLE</span>=&lt;your blog title&gt;
371
+<span class="org-variable-name">MY_BLOG_SUBTITLE</span>=&lt;your blog subtitle&gt;
372
+<span class="org-variable-name">SSH_PORT</span>=2222
373
+<span class="org-variable-name">FULLBLOG_DOMAIN_NAME</span>=&lt;your blog domain name
374
+<span class="org-variable-name">FULLBLOG_FREEDNS_SUBDOMAIN_CODE</span>=&lt;your blog FreeDNS code&gt;
375
+<span class="org-variable-name">MICROBLOG_DOMAIN_NAME</span>=&lt;your GNU Social domain name&gt;
376
+<span class="org-variable-name">MICROBLOG_FREEDNS_SUBDOMAIN_CODE</span>=&lt;your GNU social FreeDNS domain code&gt;
377
+<span class="org-variable-name">REDMATRIX_DOMAIN_NAME</span>=&lt;your Red Matrix domain name&gt;
378
+<span class="org-variable-name">REDMATRIX_FREEDNS_SUBDOMAIN_CODE</span>=1234
379
+<span class="org-variable-name">OWNCLOUD_DOMAIN_NAME</span>=&lt;your Owncloud domain name&gt;
380
+<span class="org-variable-name">OWNCLOUD_FREEDNS_SUBDOMAIN_CODE</span>=&lt;your Owncloud FreeDNS domain code&gt;
381
+<span class="org-variable-name">WIKI_DOMAIN_NAME</span>=&lt;your wiki domain name&gt;
382
+<span class="org-variable-name">WIKI_FREEDNS_SUBDOMAIN_CODE</span>=&lt;your wiki FreeDNS domain code&gt;
383
+<span class="org-variable-name">WIKI_TITLE</span>=&lt;your wiki title&gt;
384
+<span class="org-variable-name">ROUTE_THROUGH_TOR</span>=no
385
+<span class="org-variable-name">LOCAL_NETWORK_STATIC_IP_ADDRESS</span>=192.168.1.60
386
+</pre>
387
+</div>
388
+
389
+<ul class="org-ul">
390
+<li>Save and exit, then run:
391
+</li>
392
+</ul>
393
+<div class="org-src-container">
394
+
395
+<pre class="src src-bash">./install-freedombone.sh &lt;your wiki domain name&gt; &lt;your username&gt; &lt;your wiki FreeDNS domain code&gt;
396
+</pre>
397
+</div>
398
+</div>
399
+</div>
400
+
328
 <div id="outline-container-unnumbered-4" class="outline-2">
401
 <div id="outline-container-unnumbered-4" class="outline-2">
329
 <h2 id="unnumbered-4">Internet Router</h2>
402
 <h2 id="unnumbered-4">Internet Router</h2>
330
 <div class="outline-text-2" id="text-unnumbered-4">
403
 <div class="outline-text-2" id="text-unnumbered-4">