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

62 lines
2.9 KiB
Markdown
Raw Normal View History

2017-07-23 00:14:45 +02:00
# Friendica social network for YunoHost
2018-06-12 17:35:18 +02:00
[![Integration level](https://dash.yunohost.org/integration/friendica.svg)](https://dash.yunohost.org/appci/app/friendica)
2017-07-23 00:14:45 +02:00
[![Install Friendica with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=friendica)
> *This package allow you to install Friendica quickly and simply on a YunoHost server.
If you don't have YunoHost, please see [here](https://yunohost.org/#/install) to know how to install and enjoy it.*
2015-02-16 23:19:37 +01:00
2017-07-21 22:43:01 +02:00
[Friendica](http://friendi.ca/) integration for YunoHost<br>
2020-04-09 10:42:49 +02:00
**Version:2020.03**<br><br>
2015-02-16 23:19:37 +01:00
2017-07-21 22:43:01 +02:00
Current snapshot in *sources*:
2020-04-09 10:42:49 +02:00
* https://github.com/friendica/friendica: 2020.03
* https://github.com/friendica/friendica-addons: 2020.03
2017-07-21 22:43:01 +02:00
## Important Notes
Before installing, read the [Friendica installation instructions](https://github.com/friendica/friendica/blob/master/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/** )
#### Multi-users support
LDAP auth supported. There are not yet active SSO.
<br><br>
2017-07-19 22:00:25 +02:00
# To-do
2019-03-12 12:09:25 +01:00
- [ ] Fail2Ban support
2017-07-21 22:43:01 +02:00
## 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.
2018-06-06 04:09:03 +02:00
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.<b>(The admin panel don't have text,so don't get confuse with it) </b>
Public users can register and use the instance as normal users. SSO users can login with there username and password as normal users too.
Developers info
----------------
**Only if you want to use a testing branch for coding, instead of merging directly into master.**
Please do your pull request to the [testing branch](https://github.com/YunoHost-Apps/friendica_ynh/tree/testing).
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 REPLACEBYYOURAPP -u https://github.com/YunoHost-Apps/friendica_ynh/tree/testing --debug
```