mirror of https://github.com/YunoHost-Apps/hubzilla_ynh.git synced 2024-09-03 19:26:21 +02:00

Hubzilla Hub package for YunoHost

Find a file

polytan02 b704adb2f0 Use of --quiet option un unzip (to much log for nothing)		2017-02-17 13:47:52 +00:00
conf	Adjustment as per hubzilla documentation	2017-02-17 13:41:33 +00:00
scripts	Use of --quiet option un unzip	2017-02-17 13:47:52 +00:00
sources	Adjustments on install script	2017-02-17 13:04:56 +00:00
.gitignore	Initial commit, forked from https://git.reticu.li/zot/redmatrix_ynh	2015-08-23 11:33:13 -04:00
check_process	Update on check process	2017-02-17 12:33:28 +00:00
manifest.json	Update of manifest with french translations	2017-02-17 11:55:59 +00:00
README.md	Add max upload size option to manifest. Update README.md to alert to system-wide changes. Force the app to be public. Remove the well-known nginx conf line that was blocking inter-hub communication. Add check_process file.	2017-02-10 20:05:28 -05:00

README.md

YunoHost App for Hubzilla Hub

Hubzilla

Hubzilla is a powerful platform for creating interconnected websites featuring a decentralized identity, communications, and permissions framework built using common webserver technology.

Current snapshot in sources:

https://github.com/redmatrix/hubzilla: 2.0.7
https://github.com/redmatrix/hubzilla-addons: >2.0 (commit 33a9a7f971097bcf14228b626bfb127559e47830)

Important Notes

Before installing, read the Hubzilla installation instructions for important information about

SSL certificate validation requirement (now with support for Let's Encrypt!). See Installation section below.
Dedicated domain (must install under web root like https://hub.example.com/ not https://example.com/hub/ )
Required packages (all of these are not yet installed by this YunoHost installer package). This YunoHost package installs the following additional packages:
- php5-cli
- php5-imagick
- php5-gd
- php5-mcrypt
This package requires a system-wide change to php.ini that enables the exec() perimission. See the PHP manual for more information.

Installation

Register a new domain and add it to YunoHost

Hubzilla requires a dedicated domain, so obtain one and add it using the YunoHost admin panel. Domains -> Add domain

Once you have added the new domain to YunoHost, SSH into your YunoHost server and perform the following steps:

Install certbot to make installing free SSL certificates from Let's Encrypt simple.
Stop nginx
```
 service nginx stop
```
Run the certbot utility with the certonly option
```
 certbot certonly
```

Copy the generated certificate and key into the appropriate location for YunoHost to use

 cp /etc/letsencrypt/live/YOUR_DOMAIN/fullchain.pem /etc/yunohost/certs/YOUR_DOMAIN/crt.pem 
 cp /etc/letsencrypt/live/YOUR_DOMAIN/privkey.pem /etc/yunohost/certs/YOUR_DOMAIN/key.pem

Restart nginx
```
 service nginx start
```

Install the Hubzilla application

Use the YunoHost admin panel to install Hubzilla by entering the GitHub repo address in the custom app URL

	https://github.com/YunoHost-Apps/hubzilla-yunohost

Make sure to select your domain from the previous section as the application domain. Also set the application to Public.

When installation is complete, you will need to visit your new hub and register a new account using the email address you specified in the app installation form. You should then be able to log in and create your first channel.