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

Alexandre Aubin a65de8e520 Merge pull request #38 from YunoHost-Apps/testing Testing		2020-12-05 18:57:09 +01:00
conf	Update nginx.conf to protect against path traversal issue	2020-10-25 11:51:40 +01:00
scripts	rm -r -> ynh_secure_remove	2020-11-09 16:08:57 +01:00
check_process	Forgot to updated addon sources and updated readme, manifest	2020-04-20 10:53:16 +05:30
LICENSE	Tried rebuilding the app to make it work again	2017-07-18 15:51:08 +05:30
manifest.json	[fix] Version number	2020-10-11 02:00:51 +02:00
pull_request_template.md	Forgot to updated addon sources and updated readme, manifest	2020-04-20 10:53:16 +05:30
README.md	Update README.md	2020-11-04 23:49:35 +01:00

README.md

Friendica for YunoHost

This package allow you to install Friendica quickly and simply on a YunoHost server.
If you don't have YunoHost, please see here to know how to install and enjoy it.

Overview

Friendica is a software to create a distributed social network. It is part of the federation of servers that are running with Friendica, Diaspora and Hubzilla which are compatible to each other.

Version: 2020.03

Current snapshot in sources:

https://github.com/friendica/friendica: 2020.03
https://github.com/friendica/friendica-addons: 2020.03

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/ )

Multi-users support

LDAP auth supported. There are not yet active SSO.

To-do

Fail2Ban support

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.

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.

After the installation,login with the username provided at the time of the installaion with your SSO password.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 with it) Public users can register and use the instance as normal users. SSO users can login with there username and password as normal users too.

Links

Report a bug: https://github.com/YunoHost-Apps/friendica_ynh/issues

App website: http://friendi.ca/

Upstream app repository: https://github.com/friendica/friendica

YunoHost website: https://yunohost.org/

Developers info

Please do your pull request to the testing branch.

To try the testing branch, please proceed like that.

sudo yunohost app install https://github.com/YunoHost-Apps/friendica_ynh/tree/testing --debug or sudo yunohost app upgrade friendica -u https://github.com/YunoHost-Apps/friendica_ynh/tree/testing --debug