mirror of https://github.com/YunoHost-Apps/friendica_ynh.git synced 2024-09-03 18:36:14 +02:00

Friendica package for YunoHost

Find a file

anmol26s ff374811bb Fixed wrong sources		2018-06-06 03:28:53 +05:30
conf	Fixed wrong sources	2018-06-06 03:28:53 +05:30
scripts	Fixed wrong sources	2018-06-06 03:28:53 +05:30
check_process	Updated to version 2018.05 and many fixes	2018-06-06 02:47:03 +05:30
LICENSE	Tried rebuilding the app to make it work again	2017-07-18 15:51:08 +05:30
manifest.json	Fixed manifest	2018-06-06 03:04:37 +05:30
README.md	Updated to version 3.6	2018-03-31 15:15:38 +05:30

README.md

Friendica integration for YunoHost
Version:3.6

If you are updating from a very old version of Friendica, you have to first update to version 3.5.4(from here 58774643d2) before you can update to the 3.6 release.

Current snapshot in sources:

https://github.com/friendica/friendica: 3.6 (commit bacc5de3a229ab069db527854adbe6f1e593cd5a)
https://github.com/friendica/friendica-addons: 3.6 (commit dbe8118e406510d85404d9577f83d68782cfe2a0)

Important Notes

Before installing, read the Friendica 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/ )

Note:You can use accounts from YunoHost's LDAP. There are not yet active SSO.

To-do

Installation and remove script.
Ldap integration.
Upgrade script
Backup and restore script.

Installation

Register a new domain and add it to YunoHost

Friendica requires a dedicated domain, so obtain one and add it using the YunoHost admin panel. Domains -> Add domain. As Friendica uses the full domain and is installed on the root, you can create a subdomain such as friendica.domain.tld. Don't forget to update your DNS if you manage them manually.

Friendica requires browser-approved SSL certificates. If you have certificates not issued by Let's Encrypt, 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:

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 Friendica application

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

	https://github.com/YunoHost-Apps/friendica_ynh

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

When installation is complete, you will need to visit your new hub and login from the admin account you provided at the time of installation.You can then create your profile and access the admin panel from the button in the center of the top nav bar, just adjecent to the search bar.(The admin panel don't have text,so don't get confuse) Other users can use the Ldap authentication to be a normal user on the hub.