|
|
@@ -9,13 +9,14 @@
|
|
9
|
9
|
#+END_CENTER
|
|
10
|
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 and install the code
|
|
13
|
13
|
Firstly you'll need to download the code as follows:
|
|
14
|
14
|
|
|
15
|
15
|
#+BEGIN_SRC bash
|
|
16
|
16
|
sudo apt-get install git
|
|
17
|
17
|
git clone https://github.com/bashrc/freedombone
|
|
18
|
18
|
cd freedombone
|
|
|
19
|
+make install
|
|
19
|
20
|
#+END_SRC
|
|
20
|
21
|
* On a Beaglebone Black
|
|
21
|
22
|
To get started you will need:
|
|
|
@@ -32,17 +33,15 @@ To get started you will need:
|
|
32
|
33
|
|
|
33
|
34
|
You will also need to know, or find out, the IP address of your internet router and have a suitable static IP address for the Beaglebone on your local network. The router should allow you to forward ports to the Beaglebone (often this is under firewall or "advanced" settings).
|
|
34
|
35
|
|
|
35
|
|
-Check that within *initial_setup.sh* the router IP address and static IP for the Beaglebone are set correctly.
|
|
36
|
|
-
|
|
37
|
|
-Plug the microSD card into your laptop/desktop and then run the *initial_setup.sh* script. For example:
|
|
|
36
|
+Plug the microSD card into your laptop/desktop and then run the *freedombone-prep* command. For example:
|
|
38
|
37
|
|
|
39
|
38
|
#+BEGIN_SRC bash
|
|
40
|
|
-./initial_setup.sh /dev/sdX
|
|
|
39
|
+freedombone-prep -d /dev/sdX --ip <static LAN IP> --iprouter <router LAN IP>
|
|
41
|
40
|
#+END_SRC
|
|
42
|
41
|
|
|
43
|
42
|
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.
|
|
44
|
43
|
|
|
45
|
|
-When the initial setup is done follow the instructions on screen to run the main Freedombone script. You can either edit the variables within the *install-freedombone.sh* script directly, or create a separate configuration file called *freedombone.cfg* which contains those variables. Variables which you might want to put into a *freedombone.cfg* file are:
|
|
|
44
|
+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 *freedombone.cfg* which contains those variables. Variables which you might want to put into a *freedombone.cfg* file are:
|
|
46
|
45
|
|
|
47
|
46
|
#+BEGIN_SRC bash
|
|
48
|
47
|
MY_EMAIL_ADDRESS=<your email address>
|
|
|
@@ -72,13 +71,13 @@ The GPG public/private key variables are for the filenames of exported GPG keys,
|
|
72
|
71
|
|
|
73
|
72
|
The [[https://freedns.afraid.org/][FreeDNS]] 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.
|
|
74
|
73
|
|
|
75
|
|
-The syntax of the *install-freedombone.sh* script is:
|
|
|
74
|
+The syntax of the *freedombone* command is:
|
|
76
|
75
|
|
|
77
|
76
|
#+BEGIN_SRC bash
|
|
78
|
|
-./install-freedombone.sh <your wiki domain name> <your username> <your wiki FreeDNS domain code> [optional variant type]
|
|
|
77
|
+freedombone --bbb -d [domain name] -u [username] -c [FreeDNS subdomain code] -s [optional variant type]
|
|
79
|
78
|
#+END_SRC
|
|
80
|
79
|
|
|
81
|
|
-If you don't specify a variant type with the final option then everything will be installed. If you have a *freedombone.cfg* file then it should be in the same directory as *install-freedombone.sh*.
|
|
|
80
|
+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 *freedombone.cfg* file then it should be in the same directory from which the *freedombone* command is run.
|
|
82
|
81
|
|
|
83
|
82
|
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.
|
|
84
|
83
|
|
|
|
@@ -91,7 +90,7 @@ ssh username@domain -p 2222
|
|
91
|
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.
|
|
92
|
91
|
|
|
93
|
92
|
* On a laptop/PC/netbook
|
|
94
|
|
-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.
|
|
|
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 do not include the *--bbb* option within the *freedombone* command. Obviously, you don't need to run the *freedombone-prep* command on non-Beaglebone systems.
|
|
95
|
94
|
|
|
96
|
95
|
* Download the [[https://www.debian.org/devel/debian-installer][Debian Jessie "netinst" installer]]
|
|
97
|
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
|
|
|
@@ -110,6 +109,7 @@ cd /home/<username>
|
|
110
|
109
|
apt-get install git
|
|
111
|
110
|
git clone https://github.com/bashrc/freedombone
|
|
112
|
111
|
cd freedombone
|
|
|
112
|
+make install
|
|
113
|
113
|
nano freedombone.cfg
|
|
114
|
114
|
#+END_SRC
|
|
115
|
115
|
|
|
|
@@ -141,7 +141,7 @@ ENABLE_CJDNS=no
|
|
141
|
141
|
|
|
142
|
142
|
* Save and exit, then run:
|
|
143
|
143
|
#+BEGIN_SRC bash
|
|
144
|
|
-./install-freedombone.sh <your wiki domain name> <your username> <your wiki FreeDNS domain code>
|
|
|
144
|
+freedombone -d <your wiki domain name> -u <your username> -c <your wiki FreeDNS domain code>
|
|
145
|
145
|
#+END_SRC
|
|
146
|
146
|
|
|
147
|
147
|
* Internet Router
|
Bob Mottram
10 years ago