Configuration

Publish the config file when you need to override package defaults:

php artisan vendor:publish --tag=dav-config

The published file is config/dav.php.

Models

The owner model defaults to App\Models\User. It must implement Bambamboole\LaravelDav\Contracts\DavOwner.

'models' => [
    'owner' => App\Models\User::class,
],

Content models can also be replaced with subclasses of the package models:

'models' => [
    'calendar' => App\Models\TeamCalendar::class,
    'card' => App\Models\ContactCard::class,
],

Available model keys include calendar, calendar_instance, calendar_object, calendar_attachment, calendar_subscription, calendar_proxy_membership, address_book, card, credential, and scheduling_object.

Protocols

CalDAV and CardDAV are enabled by default:

'caldav' => [
    'enabled' => env('DAV_CALDAV_ENABLED', true),
],

'carddav' => [
    'enabled' => env('DAV_CARDDAV_ENABLED', true),
],

Disable either protocol when your application only needs calendar or contact support. Disabling CalDAV also disables CalDAV scheduling, sharing, subscriptions, managed attachments, and ICS export.

Routes

The DAV endpoint defaults to /dav/:

'route' => [
    'prefix' => 'dav',
    'middleware' => [],
],

Change route.prefix to serve DAV traffic from another path:

'route' => [
    'prefix' => 'remote.php/dav',
    'middleware' => [],
],

The advertised Sabre base URI is derived from route.prefix.

Authentication

The Basic authentication realm defaults to your Laravel application name:

'realm' => config('app.name', 'Laravel'),

Use DavCredential records for per-client usernames and hashed secrets.

Paths

The internal DAV path segments are configurable:

'principal_prefix' => 'principals',
'calendar_prefix' => 'calendars',

Only change these before clients start syncing. Existing clients may cache discovered collection URLs.

Scheduling

Scheduling is enabled by default:

'scheduling' => [
    'enabled' => true,
    'mailer' => env('MAIL_MAILER'),
    'from' => env('DAV_SCHEDULING_FROM', env('MAIL_FROM_ADDRESS', 'noreply@laravel-dav.example')),
],

Disable it if your application only needs local storage and sync:

'scheduling' => [
    'enabled' => false,
],

Managed attachments

Managed calendar attachments are stored through Laravel’s filesystem:

'attachments' => [
    'disk' => env('DAV_ATTACHMENTS_DISK', env('FILESYSTEM_DISK', 'local')),
    'path' => env('DAV_ATTACHMENTS_PATH', 'dav-attachments'),
],

Use a private disk unless your application has a separate reason to expose the raw storage path. DAV downloads are served through the package so calendar access rules still apply.