summaryrefslogtreecommitdiff
path: root/README.md
blob: 007c6085de5a4b8a5c1c5fce1b321846b5b87f87 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
INTALLATION PROCEDURE
=====================

This package uses [Composer][1] to install and maintain required PHP libraries
as well as the Roundcube framework. The requirements are basically the same as
for Roundcube so please read the INSTALLATION section in the Roundcube
framework's [README][2] file.

1. Install Composer

Execute this in the project root directory:

$ curl -s http://getcomposer.org/installer | php

This will create a file named composer.phar in the project directory.

2. Install Dependencies

$ php composer.phar install

3. Import the Roundcube Framework, Kolab plugins and Chwala

3.1. Either copy or symlink the Roundcube framework package into lib/Roundcube
3.2. Either copy or symlink the roundcubemail-plugins-kolab into lib/plugins
3.3. Either copy or symlink the Chwala lib/ directory into lib/FileAPI

4. Create local config

4.1. The configuration for this service inherits basic options from the Roundcube
config. To make that available, smylink the Roundcube config files
(main.inc.php and db.inc.php) into the local config/ directory.

4.2. Then copy the service-spcific config template:

$ cp config/dav.inc.php.sample config/dav.inc.php

Edit the local config/dav.inc.php file according to your setup and taste.
These settings override the default config options from the Roundcube
configuration.

5. Give write access for the webserver user to the 'logs' and 'temp' folders:

$ chown <www-user> logs
$ chown <www-user> temp

6. Configure your webserver to point to the 'public_html' directory of this
package as document root. This is necessary because Apple's Address Book App
expects the CardDAV server to run at the root of the host [3].

Add following mod_rewrite configuration into virtual host config or .htaccess file:

    RewriteEngine On
    RewriteBase /
    RewriteRule ^\.well-known/caldav   / [L,R=301]
    RewriteRule ^\.well-known/carddav  / [L,R=301]

    RewriteCond  %{REQUEST_FILENAME}  !-f
    RewriteCond  %{REQUEST_FILENAME}  !-d
    RewriteRule  (.*)                 index.php  [qsappend,last]

    SetEnv CALDAV     1
    SetEnv CARDDAV    1
    SetEnv WEBDAV     1

Use the SetEnv properties to configure which services shall be provided under
a certain host. If only WEBDAV is enabled, the shared folders are listed
directly at root level and not in /files/.


[1]: http://getcomposer.org
[2]: https://github.com/roundcube/roundcubemail/blob/master/program/lib/Roundcube/README.md)
[3]: https://code.google.com/p/sabredav/wiki/OSXAddressbook