mirror of
https://github.com/YunoHost-Apps/hubzilla_ynh.git
synced 2024-09-03 19:26:21 +02:00
66 lines
3.3 KiB
Markdown
66 lines
3.3 KiB
Markdown
# YunoHost App for Hubzilla Hub
|
|
|
|
## Hubzilla
|
|
[Hubzilla](http://hubzilla.org) 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 (commit c2830c4a98cf3c9983b3c4b61024d52a6d7187df)
|
|
* https://github.com/redmatrix/hubzilla-addons: 2.0 (commit 7cdd80991a517f318207223e0d5622f5535f476c)
|
|
|
|
## Important Notes
|
|
|
|
Before installing, read the [Hubzilla installation instructions](https://github.com/redmatrix/hubzilla/blob/master/install/INSTALL.txt) for important information about
|
|
|
|
- SSL certificate validation requirement (now with support for [Let's Encrypt!](https://letsencrypt.org)). 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](php.net/manual/function.exec.php).
|
|
|
|
|
|
|
|
## 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](https://reticu.li/yunohost/admin) panel. **Domains -> Add domain**. As Hubzilla uses the full domain and is installed on the root, you can create a subdomain such as hubzilla.domain.tld. Don't forget to update your DNS if you manage them manually.
|
|
|
|
Hubzilla requires browser-approved SSL certificates. If you have certificates not issued by [Let's Encrypt](https://letsencrypt.org/), install them manually as usual.
|
|
|
|
#### YunoHost >= 2.5 :
|
|
Once the dedicated domain has been added to YunoHost, go again to the admin panel, go to domains then select your domain and click on "Install Let's Encrypt certificate".
|
|
|
|
#### Yunohost < 2.5 :
|
|
For older versions of YunoHost, once you have added the new domain, SSH into your YunoHost server and perform the following steps:
|
|
|
|
1. Install [certbot](https://certbot.eff.org/) to make installing free SSL certificates from Let's Encrypt simple.
|
|
|
|
1. Stop nginx
|
|
|
|
service nginx stop
|
|
|
|
1. Run the **certbot** utility with the **certonly** option
|
|
|
|
certbot certonly
|
|
|
|
1. 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
|
|
|
|
1. Restart nginx
|
|
|
|
service nginx start
|
|
|
|
### Install the Hubzilla application
|
|
Use the [YunoHost admin](https://reticu.li/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.
|