Getting Started

The plugin repository for Roundcube is based on Composer to manage, install and update the plugins for your Roundcube installation. The following two steps are necessary to connect your local Roundcube installation to the plugin repository:

1. Install Composer

Run this in your command line:

cd <roundcube-project-root>
curl -s https://getcomposer.org/installer | php

Or download composer.phar into your Roundcube root directory.

2. Configure composer.json

Copy the template composer.json-dist to composer.json in your Roundcube root directory.

3. Installing plugins

Browse through our repository and find the plugins you want to install.

Then edit your local composer.json file and add the "vendor/plugin" names to the "require" section of the JSON structure. Don't forget to specify the version constraint:

"require" : {
    ...,
    "roundcube/rcsample": ">=0.2.0"
}

After every change to composer.json run

php composer.phar install

to download and install all dependencies.

The plugins are installed to the plugins/ directory and when running the install command you'll be asked whether to activate the plugins right away. For any later activation or deactivation of a plugin, you can add/remove the plugin name to/from the $config['plugins'] option in your local Roundcube config file config/config.inc.php.