Nextcloud Connector
Connector Configuration
The Nextcloud connector allows you to synchronize files and documents stored in your Nextcloud instance to Wikit Semantics. It automatically retrieves files from the configured folder and applies path inclusion or exclusion filters according to your needs.
| Field name | Format / Type | Required | Comment |
|---|---|---|---|
| URL | URL | ✅ | Full URL of your Nextcloud instance (e.g., https://cloud.example.com) |
| Source folder path | Free text | ✅ | Path to the root folder to synchronize in Nextcloud |
| Identifiant | Free text | ✅ | Nextcloud username or login identifier |
| Password | Password | ✅ | Account password or Nextcloud application password |
| Paths to include | List of texts | ➖ | List of specific paths to include in the synchronization |
| Paths to exclude | List of texts | ➖ | List of paths to exclude from the synchronization |
💡 Fields marked ✅ are required for the connector to work.
How the Connector Works
The Nextcloud connector synchronizes files in a smart way (smart sync):
- Synchronization mode: The connector automatically detects new, modified, or deleted files since the last synchronization.
- Synchronized content types: Only files with authorized MIME types are synchronized (office documents, PDFs, images, etc.). Folders are recursively traversed.
- Frequency: Synchronization runs according to the schedule configured in Wikit Connect.
- Path filters: You can restrict synchronization to specific folders (paths to include) or exclude others (paths to exclude).
- Change management: The connector compares the last modification date of files to detect updates.
- Deletion management: Files deleted from Nextcloud are also removed from Wikit Semantics during the next synchronization.
- WebDAV protocol: The connector uses the WebDAV protocol to query and download files from Nextcloud.
Prerequisites
Before configuring the Nextcloud connector in the Wikit Connect console, ensure that:
- User account or service account: You have a Nextcloud account with read permissions on the folders to synchronize.
- Application password (recommended): For security reasons, create a specific application password in your Nextcloud account settings rather than using your main password.
- WebDAV access enabled: The WebDAV API must be accessible on your Nextcloud instance (it is enabled by default). The WebDAV URL is typically
/remote.php/dav/files/. - Access rights: The account used must have read access to the folders and files you want to synchronize.
FAQ
How do paths to include and exclude work?
Paths to include allow you to restrict synchronization to specific folders only. Paths to exclude allow you to ignore certain subfolders. If you specify paths to include, only files in those paths will be synchronized. Exclusions are then applied, even if a path is included. The expected format is: Folder-Name/Subfolder.
Why are some files not synchronized?
The connector only synchronizes files whose MIME type is authorized (documents, PDFs, images, etc.). Executable files, unauthorized ZIP archives, or unsupported file types are ignored. Also check that the account used has read access rights to these files.