1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/roundcube_ynh.git synced 2024-09-03 20:16:28 +02:00
Roundcube package for YunoHost
Find a file
2019-03-12 18:52:35 +01:00
conf Merge branch 'testing' into package_upgrade 2019-03-09 12:37:44 +01:00
scripts Merge branch 'testing' into package_upgrade 2019-03-09 12:37:44 +01:00
.gitignore [enh] Initial commit for new app based on Kloadut/roundcube_ynh 2016-05-19 19:49:47 +02:00
check_process roll back to test an upgrade 2019-02-28 00:17:18 +01:00
LICENSE [fix] Add LICENSE and specify upstream license in manifest.json 2016-05-19 19:51:28 +02:00
manifest.json Merge branch 'testing' into package_upgrade 2019-03-09 12:37:44 +01:00
pull_request_template.md Create pull_request_template.md 2018-05-28 10:54:43 +02:00
README.md Merge branch 'testing' into package_upgrade 2019-03-09 12:37:44 +01:00

Roundcube for YunoHost

Integration level
Install Roundcube with YunoHost

This package allow you to install Roundcube 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

Roundcube is a browser-based multilingual IMAP client with an application-like user interface.

Shipped version: 1.3.8

Screenshots

Demo

Configuration

You can extend - or even override - the Roundcube configuration which is coming with this package in the file conf/local.inc.php. Do not edit the file conf/config.inc.php as future upgrades will overwrite it.

Documentation

Licence

LICENCE: GPL-3.0-only

YunoHost specific features

In addition to Roundcube core features, the following are made available with this package

Multi-users support

Supported architectures

  • x86-64b - Build Status
  • ARMv8-A - Build Status
  • Jessie x86-64b - Build Status

Limitations

Additional information

Plugins

You can also install other plugins - which will not be removed with upgrades. To do so, you can use the official Plugin Repository.

From the Plugin Repository

Let's say for example that we want to install the html5_notifier plugin.

  1. Connect to your server as root using SSH:

    $ ssh admin@1.2.3.4
    $ sudo -i
    
  2. Log in as the roundcube user - which owns the roundcube directory - and navigate in it:

    # su -s /bin/bash - roundcube
    $ cd /var/www/roundcube
    
  3. Install the plugin you want using composer - note that you have to specify kitist/html5_notifier and not only html5_notifier:

    $ COMPOSER_HOME=./.composer php composer.phar require "kitist/html5_notifier"
    
  4. Enable it in the local configuration file conf/local.inc.php using your favorite text editor by adding:

    <?php
    $config['plugins'][] = 'html5_notifier';
    

Note that you should also check the plugin homepage for additional installation steps as needed.

Manual installation

You can also download the plugin and put it under the plugins/ directory. In this case, do not forget to change ownerships of this folder to roundcube.

YunoHost specific features

In addition to Roundcube core features, the following are made available with this package:

  • Synchronize your email aliases as identities in Roundcube
  • Install the contextmenu and automatic addressbook plugins by default
  • Allow to install the CardDAV (address book) synchronization plugin at the installation - note that if you have installed ownCloud or Baïkal, it will automatically add the corresponding and existing address book.

Multi-users support

  • Integrate with YunoHost users and SSO - i.e. logout button, YunoHost users search

Supported architectures

  • x86-64b - Build Status
  • ARMv8-A - Build Status
  • Jessie x86-64b - Build Status

Limitations

  • No known limitations.

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.

To try the testing branch, please proceed like that.

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