diff options
Diffstat (limited to '.homeinstall/README.md')
| -rw-r--r-- | .homeinstall/README.md | 164 |
1 files changed, 164 insertions, 0 deletions
diff --git a/.homeinstall/README.md b/.homeinstall/README.md new file mode 100644 index 000000000..c147f92bc --- /dev/null +++ b/.homeinstall/README.md @@ -0,0 +1,164 @@ +# Hubzilla at Home next to your Router + +Run hubzilla-setup.sh for an unattended installation of hubzilla. + +The script is known to work with Debian 8.3 stable (Jessie) + ++ Home-PC (Debian-8.3.0-amd64) ++ DigitalOcean droplet (Debian 8.3 x64 / 512 MB Memory / 20 GB Disk / NYC3) + +# Step-by-Step Overwiew + +## Preconditions + +Hardware + ++ Internet connection and router at home ++ Mini-pc connected to your router ++ USB drive for backups + +Software + ++ Fresh installation of Debian on your mini-pc ++ Router with open ports 80 and 443 for your Debian + +## The basic steps (quick overview) + ++ Register your own domain (for example at selfHOST) or a free subdomain (for example at freeDNS) ++ Log on to your new debian (server) + - apt-get install git + - mkdir -p /var/www/html + - cd /var/www/html + - git clone https://github.com/redmatrix/hubzilla.git . + - 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 + - hubzilla-setup.sh as root + - ... wait, wait, wait until the script is finised + - reboot ++ Open your domain with a browser and step throught the initial configuration of hubzilla. + +# Step-by-Step in Detail + +## Preparations Hardware + +### Mini-PC + +### Recommended: USB Drive for Backups + +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. + +## Preparations Software + +### Install Debian Linux on the Mini-PC + +Download the stable Debian at https://www.debian.org/ + +Create bootable USB drive with Debian on it. You could use the programm +unetbootin, https://en.wikipedia.org/wiki/UNetbootin + +Switch of 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 + +Open the ports 80 and 443 on your router for your Debian + +## Preparations Dynamic IP Address + +Your Hubzilla must be reachable by a domain that you can type in your browser + + cooldomain.org + +You can use subdomains as well + + my.cooldomain.org + +There are two way to get a domain + +- buy a domain (recommended) or +- register a free subdomain + +### Method 1: Get yourself an own Domain (recommended) + +...for example at selfHOST.de + +### Method 2 Register a (free) Subdomain + +Register a free subdomain for example at + +- freeDNS +- selfHOST + +WATCH THIS: A free subdomain is not the prefered way to get a domain name. Why? + +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 + +Login to your debian +(Provided your username is "you" and the name of the mini pc is "debian". You +could take the IP address instead of "debian") + + ssh -X you@debian + +Change to root user + + su -l + +Install git + + apt-get install git + +Make the directory for apache and change diretory to it + + mkdir /var/www + cd /var/www/ + +Clone hubzilla from git ("git pull" will update it later) + + git clone https://github.com/redmatrix/hubzilla html + +Change to the install script + + cd html/.homeinstall/ + +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. + + nano hubzilla-config.txt + +Run the script + + ./hubzilla-setup.sh + +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 +successfull. Go on... +Expected: A page for the Hubzilla server configuration shows up. + +Leave db server name "127.0.0.1" and port "0" untouched. + +Enter + +- DB user name = hubzilla +- DB pass word = This is the password you entered in "hubzilla-config.txt" +- DB name = hubzilla + +Leave db type "MySQL" untouched. + +Follow the instructions in the next pages. + |