1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/horde_ynh.git synced 2024-09-03 19:16:08 +02:00
horde_ynh/README.md
2018-11-05 16:51:57 +01:00

150 lines
4.3 KiB
Markdown

Horde for yunohost
==================
[![Integration level](https://dash.yunohost.org/integration/horde.svg)](https://ci-apps.yunohost.org/ci/apps/horde%20%28Community%29/lastBuild/consoleFull)
[![Install horde with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=horde)
> *This package allow you to install horde 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.*
Overview
--------
A groupware (webmail, adressbook, calendar) witch use PHP
**Shipped version:** 5.2.22
Screenshots
-----------
![](https://www.horde.org/images/slides/h5slider.png)
Demo
----
* [Official demo](http://demo.horde.org/)
Documentation
-------------
* Official documentation: https://wiki.horde.org/
* YunoHost documentation: There no other documentations, feel free to contribute.
YunoHost specific features
--------------------------
### Multi-users support
This app support the SSO and LDAP.
### Supported architectures
* x86-64b - [![Build Status](https://ci-apps.yunohost.org/ci/logs/horde%20(Community).svg)](https://ci-apps.yunohost.org/ci/apps/horde/)
* ARMv8-A - [![Build Status](https://ci-apps-arm.yunohost.org/ci/logs/horde%20(Community).svg)](https://ci-apps-arm.yunohost.org/ci/apps/horde/)
* Jessie x86-64b - [![Build Status](https://ci-stretch.nohost.me/jenkins/job/horde%20(Community).svg)](https://ci-stretch.nohost.me/jenkins/job/horde/)
<!--Limitations
-----------
* Any known limitations.-->
Additional informations
-----------------------
### Customisation
#### Install others app.
The package provide some apps, but it's could be possible to install some others apps. The list of all availabe apps are listed here : https://www.horde.org/apps
Before any change it's recommended to make a backup :
```bash
# In case of multiple instance adapt "horde" by the horde instance
sudo yunohost backup create --verbose --ignore-system --apps horde
```
Install horde apps with pear :
```bash
# Get the horde final_path
# In case of multiple instance adapt "horde" by the horde instance
final_path=$(yunohost app setting horde final_path)
# Set the pear command to call to stay in the horde environnement (not in the global system environnement)
pear_cmd="$final_path/pear/pear -c $final_path/pear.conf"
# Update the pear channel
$pear_cmd channel-update pear.horde.org
# Install the app that you want
$pear_cmd install -a -B horde/APP_TO_INSTALL
# Set the final permission
# In case of multiple instance adapt "horde" by the horde instance
chown -R www-data:horde $final_path
```
After you need to update the horde database schema and the horde config. So go on the horde config pannel (in the settings wheel > Preferences > Administration > Configuration). Click on "Update all DB schemas" and then on "Update all configurations".
Now you should be able to use the new apps.
### ActiveSync
For calendar, task and addressbook activeSync has been configured but not yet tested.
### Troubleshotting
**Get Address is missing domain while to try to send an email.**
- You need to create an identity before send an email.
- To create this go in the settings wheel > Preferences > Global Preferences > Personal Information.
- Complete the form and save it.
- You might be able to sed an email now.
Links
-----
* Report a bug: https://github.com/YunoHost-Apps/horde_ynh/issues
* App website: https://www.horde.org/
* YunoHost website: https://yunohost.org/
---
Install
-------
From command line:
`sudo yunohost app install -l horde https://github.com/YunoHost-Apps/horde_ynh`
Upgrade
-------
From command line:
`sudo yunohost app upgrade horde -u https://github.com/YunoHost-Apps/horde_ynh`
Developers infos
----------------
To try the testing branch, please proceed like that.
```
sudo yunohost app install https://github.com/YunoHost-Apps/horde_ynh/tree/testing --debug
or
sudo yunohost app upgrade horde -u https://github.com/YunoHost-Apps/horde_ynh/tree/testing --debug
```
License
-------
Horde is published under the GPL-2.0, LGPL-2.1, BSD-2-Clause, ASL, OSI certified
All information about the licence for each part is available here : http://pear.horde.org/
TODO
----
- [ ] Service auto-discovery test
- [ ] Improve doc
- [ ] Improve https://vm-yh-2.lan/horde/test.php to have all optional dependence installed