42167fb9cc
Instructions on how to integrate SOGOs CardDAV addressbooks in Roundcube - preconfigured for every user.
134 Zeilen
4,5 KiB
Markdown
134 Zeilen
4,5 KiB
Markdown
Download Roundcube 1.3.x to the web htdocs directory and extract it (here `rc/`):
|
|
```
|
|
cd data/web
|
|
wget -O - https://github.com/roundcube/roundcubemail/releases/download/1.3.x/roundcubemail-1.3.x-complete.tar.gz | tar xfvz -
|
|
# Change folder name
|
|
mv roundcubemail-1.3.x rc
|
|
# Change permissions
|
|
chown -R root: rc/
|
|
```
|
|
|
|
Create a file `data/web/rc/config/config.inc.php` with the following content.
|
|
|
|
**Change the `des_key` parameter to a random value.** It is used to temporarily store your IMAP password.
|
|
|
|
```
|
|
<?php
|
|
error_reporting(0);
|
|
if (!file_exists('/tmp/mime.types')) {
|
|
file_put_contents("/tmp/mime.types", fopen("http://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/conf/mime.types", 'r'));
|
|
}
|
|
$config = array();
|
|
$config['db_dsnw'] = 'mysql://' . getenv('DBUSER') . ':' . getenv('DBPASS') . '@mysql/' . getenv('DBNAME');
|
|
$config['default_host'] = 'tls://dovecot';
|
|
$config['default_port'] = '143';
|
|
$config['smtp_server'] = 'tls://postfix';
|
|
$config['smtp_port'] = 587;
|
|
$config['smtp_user'] = '%u';
|
|
$config['smtp_pass'] = '%p';
|
|
$config['support_url'] = '';
|
|
$config['product_name'] = 'Roundcube Webmail';
|
|
$config['des_key'] = 'rcmail-!24ByteDESkey*Str';
|
|
$config['log_dir'] = '/dev/null';
|
|
$config['temp_dir'] = '/tmp';
|
|
$config['plugins'] = array(
|
|
'archive',
|
|
);
|
|
$config['skin'] = 'larry';
|
|
$config['mime_types'] = '/tmp/mime.types';
|
|
$config['imap_conn_options'] = array(
|
|
'ssl' => array('verify_peer' => false, 'verify_peer_name' => false, 'allow_self_signed' => true)
|
|
);
|
|
$config['enable_installer'] = true;
|
|
$config['smtp_conn_options'] = array(
|
|
'ssl' => array('verify_peer' => false, 'verify_peer_name' => false, 'allow_self_signed' => true)
|
|
);
|
|
```
|
|
|
|
Point your browser to `https://myserver/rc/installer` and follow the instructions.
|
|
Initialize the database and leave the installer.
|
|
|
|
**Delete the directory `data/web/rc/installer` after a successful installation!**
|
|
|
|
### Enable change password function in Roundcube
|
|
|
|
Open `data/web/rc/config/config.inc.php` and enable the password plugin:
|
|
|
|
```
|
|
...
|
|
$config['plugins'] = array(
|
|
'archive',
|
|
'password',
|
|
);
|
|
...
|
|
```
|
|
|
|
Open `data/web/rc/plugins/password/password.php`, search for `case 'ssha':` and add above:
|
|
|
|
```
|
|
case 'ssha256':
|
|
$salt = rcube_utils::random_bytes(8);
|
|
$crypted = base64_encode( hash('sha256', $password . $salt, TRUE ) . $salt );
|
|
$prefix = '{SSHA256}';
|
|
break;
|
|
```
|
|
|
|
Open `data/web/rc/plugins/password/config.inc.php` and change the following parameters (or add them at the bottom of that file):
|
|
|
|
```
|
|
$config['password_driver'] = 'sql';
|
|
$config['password_algorithm'] = 'ssha256';
|
|
$config['password_algorithm_prefix'] = '{SSHA256}';
|
|
$config['password_query'] = "UPDATE mailbox SET password = %P WHERE username = %u";
|
|
```
|
|
|
|
### Integrate CardDAV addressbooks in Roundcube
|
|
|
|
Download the latest release of [RCMCardDAV](https://github.com/blind-coder/rcmcarddav/) to the Roundcube plugin directory and extract it (here `rc/plugins`):
|
|
```
|
|
cd data/web/rc/plugins
|
|
wget -O - https://github.com/blind-coder/rcmcarddav/releases/download/v3.0.3/carddav-3.0.3.tar.bz2 | tar xfvj -
|
|
```
|
|
|
|
Copy the file `config.inc.php.dist` to `config.inc.php` (here in `rc/plugins/carddav`) and append the following preset to the end of the file - don't forget to replace `mx.example.org` with your own hostname:
|
|
```
|
|
$prefs['SOGo'] = array(
|
|
'name' => 'SOGo',
|
|
'username' => '%u',
|
|
'password' => '%p',
|
|
'url' => 'https://mx.example.org/SOGo/dav/%u/',
|
|
'carddav_name_only' => true,
|
|
'use_categories' => true,
|
|
'active' => true,
|
|
'readonly' => false,
|
|
'refresh_time' => '02:00:00',
|
|
'fixed' => array( 'active', 'name', 'username', 'password', 'refresh_time' ),
|
|
'hide' => false,
|
|
);
|
|
```
|
|
|
|
Enable the plugin by adding `carddav` to `$config['plugins']` in `roundcube/config/config.inc.php`.
|
|
|
|
If you want to remove the default addressbooks (stored in the Roundcube database), so that only the CardDAV addressbooks are accessable, append `$config['address_book_type'] = '';` to the config file `data/web/rc/config/config.inc.php`.
|
|
|
|
---
|
|
|
|
Optionally, you can add Roundcube's link to the mailcow Apps list.
|
|
To do this, open or create `data/web/inc/vars.local.inc.php` and add the following code-block:
|
|
|
|
*NOTE: Don't forget to add the `<?php` delimiter on the first line*
|
|
|
|
````
|
|
...
|
|
$MAILCOW_APPS = array(
|
|
array(
|
|
'name' => 'SOGo',
|
|
'link' => '/SOGo/'
|
|
),
|
|
array(
|
|
'name' => 'Roundcube',
|
|
'link' => '/rc/'
|
|
)
|
|
);
|
|
...
|
|
````
|