Nextcloud

About

payload-nextcloud is a storage adapter for Payload 3 that routes upload collection files into a Nextcloud instance over WebDAV. It builds on `@payloadcms/plugin-cloud-storage`, supplying a custom adapter that covers upload, delete, URL generation, and a static handler for serving files back through Payload. The adapter authenticates with a Nextcloud username and an app password (recommended over the account password) or token. It derives the WebDAV files root from the configured base URL, defaulting to `/remote.php/dav/files/{username}`, and can scope uploads under a configurable `rootDirectory` such as `/Payload`. Per-collection options let you set a remote directory, toggle URL exposure, and control whether metadata syncs on upload or update. On upload the plugin stores standard WebDAV file properties (file id, path, size, mime type, etag, permissions, last modified, directory flag) on the document and can attempt to create a public share link through the Nextcloud OCS Files Sharing API, writing it to `nextcloud.share_url`. A direct WebDAV URL goes into `nextcloud.webdav_url`. Editable custom metadata can be synced to WebDAV via PROPPATCH using a configurable namespace and field map, and a `sync_status` group tracks the last sync and any errors. The plugin appends these fields to whichever collections you enable in config, keeping the schema intact even when the plugin is disabled so migrations stay consistent. It requires Payload 3.37.0 or newer and pulls in the `webdav` and `@payloadcms/plugin-cloud-storage` packages. For local development with self-signed certificates `verifyTLS` can be turned off, though that should stay out of production.

Package info

Package name

payload-nextcloud

Latest version

0.1.0

Unpacked size

109 kB

License

MIT

Weekly downloads

2

Last publish

Nov 11, 2025