Installation

The DAM NextCloud extension is shipped as a .zip after purchase. Install it manually as below.

1. Extract the package

Unzip the downloaded archive into your UnoPim project's packages/ directory:

cd /path/to/your/unopim
unzip ~/Downloads/dam-webdav.zip -d packages/Webkul/DamWebdav

Command	Purpose
cd /path/to/your/unopim	Changes into your UnoPim project root before extracting package files.
unzip ~/Downloads/dam-webdav.zip -d packages/Webkul/DamWebdav	Extracts the Dam WebDAV package into the expected UnoPim package directory.

You should end up with packages/Webkul/DamWebdav/{src,composer.json,...}.

2. Register the autoloader

Open the project's root composer.json and add the package's psr-4 namespace under autoload.psr-4:

{
    "autoload": {
        "psr-4": {
            "Webkul\\DamWebdav\\": "packages/Webkul/DamWebdav/src/"
        }
    }
}

Then refresh the autoload map:

composer dump-autoload

Command	Purpose
composer dump-autoload	Regenerates Composer's autoloader mapping to include the newly added namespace.

3. Register the service provider

Open bootstrap/providers.php (Laravel 12) or config/app.php (older) and add:

Webkul\DamWebdav\Providers\DamWebdavServiceProvider::class,

NOTE

This registers DamWebdavServiceProvider in Laravel so the extension can bootstrap its WebDAV services, routes, and package configuration during application startup.

4. Run migrations

php artisan migrate

This creates the dam_webdav_* tables (credentials, sync profiles, sync events, remote sources, trash).

Command	Purpose
php artisan migrate	Runs pending database migrations required by the Dam WebDAV package.

5. Publish & adjust config

php artisan vendor:publish --tag=dam-webdav-config

Command	Purpose
php artisan vendor:publish --tag=dam-webdav-config	Publishes Dam WebDAV configuration files into the application.

Edit config/dam_webdav.php:

Key	Default	Purpose
base_path	/webdav/dam	Internal WebDAV mount path.
lock_ttl	300 (sec)	How long a LOCK is held by a client.
trash_retention_days	30	Soft-delete retention before automatic purge.
nc_flow.enabled	true	Enable Nextcloud login-flow-v2 endpoints.
nc_flow.session_ttl	1200 (sec)	Login-flow token lifetime.

6. nginx — pass WebDAV verbs through

Vanilla nginx blocks PROPFIND and friends. Add to your server block:

location ~ \.php$ {
    fastcgi_pass   php-fpm;
    fastcgi_index  index.php;
    fastcgi_param  REQUEST_METHOD $request_method;
    include        fastcgi_params;
}

# Forward Nextcloud-style paths to Laravel's front controller
location ~ ^/(remote\.php|index\.php|status\.php|ocs)/ {
    try_files $uri /index.php?$query_string;
}

# Disable nginx's WebDAV module — Laravel handles WebDAV itself
dav_methods off;

The package registers the verbs PROPFIND PROPPATCH MKCOL COPY MOVE LOCK UNLOCK REPORT SEARCH with the router, so they hit your controllers normally.

7. Clear caches & rebuild assets

php artisan route:clear
php artisan config:clear
php artisan cache:clear
npm run build

Command	Purpose
php artisan route:clear	Clears Laravel's cached route definitions.
php artisan config:clear	Clears Laravel's cached configuration values.
php artisan cache:clear	Clears the application cache store.
npm run build	Rebuilds frontend assets so UI changes are available.

8. Verify

Hit the status endpoint:

curl -i http://your-unopim-host/status.php

Command	Purpose
curl -i http://your-unopim-host/status.php	Sends a test request to verify the status endpoint responds correctly after installation.

Expected: HTTP/1.1 200 OK with a JSON body containing productname and version.

Now sign in to the admin panel — a new Nextcloud menu item appears in the sidebar.