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

68 lines
3.8 KiB
Markdown
Raw Normal View History

2021-06-22 17:26:16 +02:00
<!--
N.B.: This README was automatically generated by https://github.com/YunoHost/apps/tree/master/tools/README-generator
It shall NOT be edited by hand.
-->
2021-01-12 17:42:56 +01:00
2021-06-22 17:26:16 +02:00
# Hubzilla for YunoHost
2021-01-12 18:08:53 +01:00
2023-01-28 22:44:19 +01:00
[![Integration level](https://dash.yunohost.org/integration/hubzilla.svg)](https://dash.yunohost.org/appci/app/hubzilla) ![Working status](https://ci-apps.yunohost.org/ci/badges/hubzilla.status.svg) ![Maintenance status](https://ci-apps.yunohost.org/ci/badges/hubzilla.maintain.svg)
2023-05-21 08:08:21 +02:00
2021-01-12 18:08:53 +01:00
[![Install Hubzilla with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=hubzilla)
2018-06-12 17:36:50 +02:00
2021-06-22 17:26:16 +02:00
*[Lire ce readme en français.](./README_fr.md)*
2018-06-12 17:36:50 +02:00
2021-06-22 17:26:16 +02:00
> *This package allows you to install Hubzilla quickly and simply on a YunoHost server.
If you don't have YunoHost, please consult [the guide](https://yunohost.org/#/install) to learn how to install it.*
2019-04-04 18:48:56 +02:00
2020-11-04 22:17:01 +01:00
## Overview
2022-10-17 02:01:08 +02:00
[Hubzilla](https://hub.libranet.de/directory?f=&global=1&pubforums=1) is a social networking platform built with control of your privacy at center stage. Your online communications can be as public as you wish or as private as you require. Private conversations, private photos, private videos. Your media isn't hidden behind an obscure URL which can be guessed, it is protected by state-of-the-art cross-domain authentication. What this all means for you: **less drama**.
2021-06-22 17:26:16 +02:00
2023-05-21 08:08:21 +02:00
**Shipped version:** 8.4.1~ynh1
2021-06-22 17:26:16 +02:00
2020-11-04 22:17:01 +01:00
## Screenshots
2022-06-17 14:22:39 +02:00
![Screenshot of Hubzilla](./doc/screenshots/hubzilla-1.png)
2021-06-22 17:26:16 +02:00
## Disclaimers / important information
## Installation
Before installing, read the [Hubzilla installation instructions](https://framagit.org/hubzilla/core/blob/master/install/INSTALL.txt) for important information about:
### 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**. 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.
## Ldap Admin user rights, logs and failed database updates
- **For admin rights**: When installation is complete, you will need to visit your new hub's page and login with the **admin account username** which was entered at the time of installation process. You should then be able to create your first channel and have the **admin rights** for the hub.
2020-11-13 11:25:58 +01:00
- **For normal YunoHost users**: Normal LDAP users can login through LDAP authentication and create there channels.
2020-11-19 09:38:20 +01:00
- **Failing to get admin rights**: If the admin cannot access the admin settings at `https://hubzilla.example.com/admin` then you have to **manually add 4096** to the **account_roles** under **accounts** for that user in the **database through phpMyAdmin**.
2020-11-13 11:25:58 +01:00
- **For logs**: Go to **admin->logs** and enter the file name **php.log**.
2020-11-13 11:25:58 +01:00
- **Failed Database after Upgrade:** Some times databse upgrade fails after version upgrade. You can go to hub eg. `https://hubzilla.example.com/admin/dbsync/` and check the numbers of failled update. These updates will have to be ran manually by **phpMyAdmin**.
2021-06-22 17:26:16 +02:00
## Documentation and resources
2020-11-04 22:17:01 +01:00
2022-06-17 14:22:39 +02:00
* Official app website: <https://zotlabs.org/page/hubzilla/hubzilla-project>
* Upstream app code repository: <https://framagit.org/hubzilla/core>
* YunoHost documentation for this app: <https://yunohost.org/app_hubzilla>
* Report a bug: <https://github.com/YunoHost-Apps/hubzilla_ynh/issues>
2020-11-04 22:17:01 +01:00
## Developer info
Please send your pull request to the [testing branch](https://github.com/YunoHost-Apps/hubzilla_ynh/tree/testing).
To try the testing branch, please proceed like that.
2022-06-17 14:22:39 +02:00
``` bash
2020-11-04 22:17:01 +01:00
sudo yunohost app install https://github.com/YunoHost-Apps/hubzilla_ynh/tree/testing --debug
or
sudo yunohost app upgrade hubzilla -u https://github.com/YunoHost-Apps/hubzilla_ynh/tree/testing --debug
```
2021-06-22 17:26:16 +02:00
2022-06-17 14:22:39 +02:00
**More info regarding app packaging:** <https://yunohost.org/packaging_apps>