Nextcloud
Nextcloud is a self-hosted (or hosted) file sharing and collaboration platform. Ordalie connects to your Nextcloud instance via the WebDAV protocol, giving you access to your files, search, and write capabilities.
Who can configure it
Any PRO user, from Settings > Integrations. This is a personal integration using your Nextcloud credentials.
Setup guide
Step 1: Connect your Nextcloud instance
- Go to Settings > Integrations.
- Find Nextcloud and click Connect.
- Enter your Nextcloud server URL (e.g.,
https://cloud.example.com).- The URL is automatically cleaned: trailing paths like
/apps/...or/index.phpare stripped. - Both
https://andhttps://are accepted, but HTTPS is strongly recommended.
- The URL is automatically cleaned: trailing paths like
- Choose the access level (Read Only or Read & Write).
- Click Connect. A Nextcloud login window will open.
- Sign in to your Nextcloud instance and grant access to the application.
- Nextcloud will generate an app token specifically for Ordalie. This token is stored securely.
Step 2: Start using your files
Once connected:
- Browse your Nextcloud files through the workspace panel.
- Use @ mentions to reference Nextcloud files in conversations.
- Search across your files.
- Upload files and create folders (if write access is enabled).
How it works
Ordalie uses the WebDAV protocol to communicate with your Nextcloud instance:
- Listing:
PROPFINDrequests to browse directories. - Search: WebDAV
SEARCHmethod with filename filtering. Falls back to listing + filtering if the server doesn't support the SEARCH method. - Reading: Standard
GETrequests to download file content. - Writing:
PUTrequests to upload files. - Folder creation:
MKCOLrequests to create directories.
Authentication uses Basic Auth with the app token generated during the login flow. No passwords are stored — only the app-specific token.
Security
- SSRF protection: Ordalie validates the server URL to prevent connections to internal network addresses (localhost, private IP ranges).
- App tokens: The token is scoped to Ordalie and can be revoked independently from your Nextcloud account.
- HTTPS: While HTTP is technically supported, always use HTTPS for production instances.
Configuration reference
| Field | Required | Description |
|---|---|---|
| Server URL | Yes | Your Nextcloud instance URL (e.g., https://cloud.example.com) |
| Access Level | Yes | read or read_write |
The username and app token are obtained automatically during the login flow and stored securely.
Supported operations
| Operation | Available | Notes |
|---|---|---|
| Browse files and folders | Yes | WebDAV PROPFIND |
| Search | Yes | WebDAV SEARCH or fallback listing |
| Read/download files | Yes | Up to 50 MB per file |
| Upload files | Yes | When access is Read & Write |
| Create folders | Yes | When access is Read & Write (non-recursive) |
Frequently asked questions
Q: What Nextcloud versions are supported? A: Any Nextcloud version that supports the WebDAV protocol and the Login Flow v2 (used for app token generation). This includes Nextcloud 16 and later.
Q: Can I connect to a Nextcloud behind a VPN? A: Ordalie connects from its servers, so the Nextcloud instance must be accessible from the internet. If your instance is behind a VPN, you would need to expose it or use a reverse proxy.
Q: What happens if I change my Nextcloud password? A: App tokens are independent from your main password. Changing your password does not invalidate the app token used by Ordalie.
Q: How do I revoke access? A: Go to Settings > Integrations in Ordalie and disconnect. You can also revoke the app token from your Nextcloud instance: Settings > Security > Devices & sessions.