From 943faf01a9bf274848ab3100178f871e57c2b5d4 Mon Sep 17 00:00:00 2001 From: Bob Mottram Date: Sat, 20 Dec 2014 11:07:34 +0000 Subject: [PATCH] Improve install instructions for laptop/PC --- install-freedombone.sh | 2 +- installation.org | 54 ++++++++++++++++++++++++-- website/installation.html | 81 +++++++++++++++++++++++++++++++++++++-- 3 files changed, 129 insertions(+), 8 deletions(-) diff --git a/install-freedombone.sh b/install-freedombone.sh index 5e32f78d..864dc6f8 100755 --- a/install-freedombone.sh +++ b/install-freedombone.sh @@ -2106,9 +2106,9 @@ function backup_to_friends_servers { echo "awk -F ' ' '{print $2}')" >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME echo -n ' export RSYNC_PASSWORD=$(echo "${remote_server}" | ' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME echo "awk -F ' ' '{print $3}')" >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME + echo ' NOW=$(date +"%Y-%m-%d %H:%M:%S")' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME echo '' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME - echo ' NOW=$(date +"%Y-%m-%d %H:%M:%S")' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME echo ' logger -s "$NOW Starting backup to $RSYNC_SERVER" >> /var/log/backup_to_friends.log' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME echo -n ' rsync -avz -e "ssh -p $RSYNC_SSH_PORT" ' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME echo '$SERVER_DIRECTORY/backup $RSYNC_SERVER' >> /usr/bin/$BACKUP_TO_FRIENDS_SCRIPT_NAME diff --git a/installation.org b/installation.org index 2cd7dc99..7a541180 100644 --- a/installation.org +++ b/installation.org @@ -7,7 +7,7 @@ #+BEGIN_CENTER [[./images/logo.png]] #+END_CENTER -| [[file:index.html][Home]] | [[Download the code]] | [[On a Beaglebone Black]] | [[On other hardware]] | [[Internet Router]] | +| [[file:index.html][Home]] | [[Download the code]] | [[On a Beaglebone Black]] | [[On a laptop/PC/netbook]] | [[Internet Router]] | * Download the code Firstly you'll need to download the code as follows: @@ -89,8 +89,56 @@ ssh username@domain -p 2222 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. -* On other hardware -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. +* On a laptop/PC/netbook +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. + + * Download the [[https://www.debian.org/devel/debian-installer][Debian Jessie "netinst" installer]] + * 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 + * 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. + * Within the installer unselect the *print server* and select the *ssh server* + * After installation use ssh to access the machine and become the root user +#+BEGIN_SRC bash +ssh username@192.168.1.60 +su +#+END_SRC + * 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. + * Run the following commands: +#+BEGIN_SRC bash +cd /home/ +apt-get install git +git clone https://github.com/bashrc/freedombone +cd freedombone +nano freedombone.cfg +#+END_SRC + + * Now create a configuration file, such as the following, filling in the details for your [[https://freedns.afraid.org/][FreeDNS domains]]. +#+BEGIN_SRC bash +INSTALLING_ON_BBB=no +MY_EMAIL_ADDRESS= +MY_NAME= +MY_BLOG_TITLE= +MY_BLOG_SUBTITLE= +SSH_PORT=2222 +FULLBLOG_DOMAIN_NAME= +MICROBLOG_DOMAIN_NAME= +MICROBLOG_FREEDNS_SUBDOMAIN_CODE= +REDMATRIX_DOMAIN_NAME= +REDMATRIX_FREEDNS_SUBDOMAIN_CODE=1234 +OWNCLOUD_DOMAIN_NAME= +OWNCLOUD_FREEDNS_SUBDOMAIN_CODE= +WIKI_DOMAIN_NAME= +WIKI_FREEDNS_SUBDOMAIN_CODE= +WIKI_TITLE= +ROUTE_THROUGH_TOR=no +LOCAL_NETWORK_STATIC_IP_ADDRESS=192.168.1.60 +#+END_SRC + + * Save and exit, then run: +#+BEGIN_SRC bash +./install-freedombone.sh +#+END_SRC + * Internet Router On your internet router, typically under firewall settings, open the following ports and forward them to the Freedombone. diff --git a/website/installation.html b/website/installation.html index 413a972d..fb2f11a2 100644 --- a/website/installation.html +++ b/website/installation.html @@ -4,7 +4,7 @@ - + @@ -174,7 +174,7 @@ for the JavaScript code in this tag. Home Download the code On a Beaglebone Black -On other hardware +On a laptop/PC/netbook Internet Router @@ -318,13 +318,86 @@ Any manual post-installation setup instructions or passwords can be found in
-

On other hardware

+

On a laptop/PC/netbook

-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. +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.

+ +
    +
  • Download the Debian Jessie "netinst" installer +
    • +
  • Use Startup Disk Creator or Unetbootin to copy the netinst image to a USB thumb drive +
    • +
  • 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. +
    • +
  • Within the installer unselect the print server and select the ssh server +
    • +
  • After installation use ssh to access the machine and become the root user +
    • +
+
+ +
ssh username@192.168.1.60
+su
+
+
+
    +
  • 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. +
    • +
  • Run the following commands: +
    • +
+
+ +
cd /home/<username>
+apt-get install git
+git clone https://github.com/bashrc/freedombone
+cd freedombone
+nano freedombone.cfg
+
+
+ +
    +
  • Now create a configuration file, such as the following, filling in the details for your FreeDNS domains. +
    • +
+
+ +
INSTALLING_ON_BBB=no
+MY_EMAIL_ADDRESS=<your email>
+MY_NAME=<your name>
+MY_BLOG_TITLE=<your blog title>
+MY_BLOG_SUBTITLE=<your blog subtitle>
+SSH_PORT=2222
+FULLBLOG_DOMAIN_NAME=<your blog domain name
+FULLBLOG_FREEDNS_SUBDOMAIN_CODE=<your blog FreeDNS code>
+MICROBLOG_DOMAIN_NAME=<your GNU Social domain name>
+MICROBLOG_FREEDNS_SUBDOMAIN_CODE=<your GNU social FreeDNS domain code>
+REDMATRIX_DOMAIN_NAME=<your Red Matrix domain name>
+REDMATRIX_FREEDNS_SUBDOMAIN_CODE=1234
+OWNCLOUD_DOMAIN_NAME=<your Owncloud domain name>
+OWNCLOUD_FREEDNS_SUBDOMAIN_CODE=<your Owncloud FreeDNS domain code>
+WIKI_DOMAIN_NAME=<your wiki domain name>
+WIKI_FREEDNS_SUBDOMAIN_CODE=<your wiki FreeDNS domain code>
+WIKI_TITLE=<your wiki title>
+ROUTE_THROUGH_TOR=no
+LOCAL_NETWORK_STATIC_IP_ADDRESS=192.168.1.60
+
+
+ +
    +
  • Save and exit, then run: +
    • +
+
+ +
./install-freedombone.sh <your wiki domain name> <your username> <your wiki FreeDNS domain code>
+
+
+

Internet Router