mirror of
https://github.com/YunoHost-Apps/hubzilla_ynh.git
synced 2024-09-03 19:26:21 +02:00
165 lines
4 KiB
Markdown
165 lines
4 KiB
Markdown
|
# 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.
|
||
|
|
|