From 8c75ace6ecbac65917622d46601253b143ac659c Mon Sep 17 00:00:00 2001 From: Einer von Vielen Date: Mon, 18 Dec 2017 23:03:10 +0100 Subject: Changes for Debian 9 (Stretch). Tested on a Raspberry 3 under Raspian (Debian 9.3) along with a FREE SUBDOMAIN registered at https://freedns.afraid.org. Changes for letsencrypt. Removed support for Debian 8. --- .homeinstall/README.md | 84 +++++++++++++++++++++++++++++++++++--------------- 1 file changed, 59 insertions(+), 25 deletions(-) (limited to '.homeinstall/README.md') diff --git a/.homeinstall/README.md b/.homeinstall/README.md index c0de914a1..ee2261b30 100644 --- a/.homeinstall/README.md +++ b/.homeinstall/README.md @@ -2,10 +2,12 @@ Run hubzilla-setup.sh for an unattended installation of hubzilla. -The script is known to work with Debian 8.3 stable (Jessie) +The script is known to work with Debian 9 stable (Stretch) -+ Home-PC (Debian-8.3.0-amd64) -+ DigitalOcean droplet (Debian 8.3 x64 / 512 MB Memory / 20 GB Disk / NYC3) ++ Home-PC (Debian-9.2-amd64) ++ Raspian (Debian-9.3 on a Rapberry 3) + +This script is not recommended for Debian 8 (Jessie) any longer. # Step-by-Step Overwiew @@ -14,12 +16,12 @@ The script is known to work with Debian 8.3 stable (Jessie) Hardware + Internet connection and router at home -+ Mini-pc connected to your router ++ Mini-pc connected to your router (a Raspberry 3 will do it too) + USB drive for backups Software -+ Fresh installation of Debian on your mini-pc ++ Fresh installation of Debian 9 (Stretch) on your mini-pc + Router with open ports 80 and 443 for your Debian ## The basic steps (quick overview) @@ -32,7 +34,8 @@ Software - git clone https://github.com/redmatrix/hubzilla.git html - cp .homeinstall/hubzilla-config.txt.template .homeinstall/hubzilla-config.txt - nano .homeinstall/hubzilla-config.txt - - Enter your values there: db pass, domain, values for dyn DNS + - Read the comments carefully + - Enter your values: db pass, domain, values for dyn DNS - hubzilla-setup.sh as root - ... wait, wait, wait until the script is finised - reboot @@ -51,18 +54,36 @@ The installation will create a daily backup. If the backup process does not find an external device than the backup goes to the internal disk. -The USB drive must be compatible with an encrpyted filesystem LUKS + ext4. +The USB drive must be compatible with the filesystems + +- ext4 (if you do not want to encrypt the USB) +- LUKS + ext4 (if you want to encrypt the USB) ## Preparations Software ### Install Debian Linux on the Mini-PC -Download the stable Debian at https://www.debian.org/ +Download the stable Debian at https://www.debian.org/ +(Debian 8 is no longer supported.) + +Create bootable USB drive with Debian on it.You could use + +- unetbootin, https://en.wikipedia.org/wiki/UNetbootin +- or simply the linux command "dd" + +Example for command dd... -Create bootable USB drive with Debian on it. You could use the programm -unetbootin, https://en.wikipedia.org/wiki/UNetbootin + su - + dd if=2017-11-29-raspbian-stretch.img of=/dev/mmcblk0 -Switch of your mini pc, plug in your USB drive and start the mini pc from the +Do not forget to unmount the SD card before and check if unmounted like in this example... + + su - + umount /dev/mmcblk0* + df -h + + +Switch off your mini pc, plug in your USB drive and start the mini pc from the stick. Install Debian. Follow the instructions of the installation. ### Configure your Router @@ -81,26 +102,21 @@ You can use subdomains as well There are two way to get a domain -- buy a domain (recommended) or +- buy a domain, or - register a free subdomain -### Method 1: Get yourself an own Domain (recommended) +### Method 1: Buy an own Domain -...for example at selfHOST.de +...for example buy at selfHOST.de -### Method 2 Register a (free) Subdomain +The cost are around 10,- € once and 1,50 € per month (2017). -Register a free subdomain for example at +### Method 2 Register a (free) Subdomain -- freeDNS -- selfHOST +...for example register at freeDNS -WATCH THIS: A free subdomain is not the prefered way to get a domain name. Why? +Follow the instructions in .homeinstall/hubzilla-config.txt. -Let's encrpyt issues a limited number of certificates each -day. Possibly other users of this domain will try to issue a certificate -at the same day as you do. So make sure you choose a domain with as less subdomains as -possible. ## Install Hubzilla on your Debian @@ -135,7 +151,7 @@ Copy the template file cp hubzilla-config.txt.template hubzilla-config.txt -Change the file "hubzilla-config.txt". Read the instructions there and enter your values. +Change the file "hubzilla-config.txt". Read the instructions there carefully and enter your values. nano hubzilla-config.txt @@ -146,7 +162,7 @@ Run the script Wait... The script should not finish with an error message. In a webbrowser open your domain. -Expected: A test page of hubzilla is shown. All checks there shoulg be +Expected: A test page of hubzilla is shown. All checks there should be successfull. Go on... Expected: A page for the Hubzilla server configuration shows up. @@ -162,3 +178,21 @@ Leave db type "MySQL" untouched. Follow the instructions in the next pages. +## Note for the Rasperry + +The script was tested with an Raspberry 3 under Raspian (Debian 9.3, 2017-11-29-raspbian-stretch.img). + +It is recommended to deinstall these programms to avoid endless updates. Use... + + sudo apt-get purge wolfram-engine sonic-pi + sudo apt-get autoremove + +It is recommended to run the Raspi without graphical frontend (X-Server). Use... + + sudo raspi-config + +to boot the Rapsi to the client console. + +DO NOT FORGET TO CHANGE THE DEFAULT PASSWORD FOR USER PI! + + -- cgit v1.2.3 From bb4dcbe89e5225f8feff774a338b8cb82d0c140b Mon Sep 17 00:00:00 2001 From: Einer von Vielen Date: Mon, 18 Dec 2017 23:31:36 +0100 Subject: Debian 8 not supported (without adjustments). --- .homeinstall/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to '.homeinstall/README.md') diff --git a/.homeinstall/README.md b/.homeinstall/README.md index ee2261b30..14a0846c3 100644 --- a/.homeinstall/README.md +++ b/.homeinstall/README.md @@ -7,7 +7,7 @@ The script is known to work with Debian 9 stable (Stretch) + Home-PC (Debian-9.2-amd64) + Raspian (Debian-9.3 on a Rapberry 3) -This script is not recommended for Debian 8 (Jessie) any longer. +This script does not work for Debian 8 (Jessie). # Step-by-Step Overwiew -- cgit v1.2.3 From 03d95ec089aeba03d4c9d8c129e8010c3bd1fb6e Mon Sep 17 00:00:00 2001 From: Einer von Vielen Date: Tue, 19 Dec 2017 17:35:14 +0100 Subject: Excluded third party plugins and themes from installation. Fixed backup for changed config of rsnapshot. Added autoremove of for apt-get. Added disclaimers in README.md. Added sanitiy check for Debian version 9. --- .homeinstall/README.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) (limited to '.homeinstall/README.md') diff --git a/.homeinstall/README.md b/.homeinstall/README.md index 14a0846c3..793f7d404 100644 --- a/.homeinstall/README.md +++ b/.homeinstall/README.md @@ -2,12 +2,15 @@ Run hubzilla-setup.sh for an unattended installation of hubzilla. -The script is known to work with Debian 9 stable (Stretch) +The script is known to work without adjustments with -+ Home-PC (Debian-9.2-amd64) -+ Raspian (Debian-9.3 on a Rapberry 3) ++ Home-PC (Debian-9.2-amd64) or Raspian (Debian-9.3 on a Rapberry 3) ++ DynDNS from selfHOST.de or freedns.afraid.org/ -This script does not work for Debian 8 (Jessie). +## Disclaimers + +- This script does work with Debian 9 (Stretch) only without adjustments. +- This script has to be used on a fresh debian install only (it does not take account for a possibly already installed and configured webserver or sql implementation). # Step-by-Step Overwiew @@ -16,7 +19,7 @@ This script does not work for Debian 8 (Jessie). Hardware + Internet connection and router at home -+ Mini-pc connected to your router (a Raspberry 3 will do it too) ++ Mini-pc connected to your router (a Raspberry 3 will do for very small Hubs) + USB drive for backups Software -- cgit v1.2.3 From 1c5630ef5a7542046815ac20ca525dd7c6e20cf4 Mon Sep 17 00:00:00 2001 From: Einer von Vielen Date: Tue, 19 Dec 2017 18:04:20 +0100 Subject: Typo --- .homeinstall/README.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) (limited to '.homeinstall/README.md') diff --git a/.homeinstall/README.md b/.homeinstall/README.md index 793f7d404..96ce3b6d4 100644 --- a/.homeinstall/README.md +++ b/.homeinstall/README.md @@ -4,12 +4,16 @@ Run hubzilla-setup.sh for an unattended installation of hubzilla. The script is known to work without adjustments with -+ Home-PC (Debian-9.2-amd64) or Raspian (Debian-9.3 on a Rapberry 3) -+ DynDNS from selfHOST.de or freedns.afraid.org/ ++ Hardware + - Mini-PC with Debian-9.2-amd64, or + - Rapberry 3 with Raspbian, Debian-9.3 ++ DynDNS + - selfHOST.de + - freedns.afraid.org ## Disclaimers -- This script does work with Debian 9 (Stretch) only without adjustments. +- This script does work with Debian 9 only. - This script has to be used on a fresh debian install only (it does not take account for a possibly already installed and configured webserver or sql implementation). # Step-by-Step Overwiew -- cgit v1.2.3