From 747ae7a8d50bd79b2af4616dbdce45b26ba88b93 Mon Sep 17 00:00:00 2001 From: Leo Vasanko Date: Sun, 26 Apr 2026 05:15:55 +0000 Subject: [PATCH] Document WebDAV access and compatible clients in README MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add WebDAV Access section with client setup instructions - Explain Basic auth and API token authentication for WebDAV - Document Windows NTLM limitation and token-based workaround - Fix typo: authenticatioon → authentication --- README.md | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 23dd327..edb4d20 100644 --- a/README.md +++ b/README.md @@ -45,7 +45,7 @@ The server remembers its settings in the config folder (default `~/.local/share/ ## Authentication -Cista supports two authenticatioon mode, each of which supporting ordinary and privileged users. Either one can be combined with the public mode. +Cista supports two authentication modes, each supporting ordinary and privileged users. Either one can be combined with the public mode. ### Public Mode @@ -83,6 +83,28 @@ In Paskia mode: - Users with `cista:login` permission can access files - Users with `cista:admin` permission get privileged access (Admin Settings) +## WebDAV Access + +Cista supports WebDAV, so you can mount it as a network drive or browse it directly from your operating system's file manager. + +Connect to `http://cista.example.com/files/` (or `https://...`). + +### Authentication + +- **Standard users:** Use your username and password with Basic auth. +- **API tokens:** For scripts, backup tools, or when your client requires NTLM (e.g. Windows File Explorer), create a token in the web interface via **🔑 API Tokens**. Authenticate with username `token` and the token secret as the password. + +### Supported clients + +| Client | Setup | +|--------|-------| +| **Windows File Explorer** | Map Network Drive → `http://cista.example.com/files/` (or Add a network location). Windows may try NTLM first; API tokens are recommended. | +| **macOS Finder** | Go → Connect to Server (⌘K) → `http://cista.example.com/files/` | +| **Linux (GNOME/KDE)** | Enter `dav://cista.example.com/files/` or `webdav://cista.example.com/files/` in the location bar | +| **Cyberduck, WinSCP, rclone** | Standard WebDAV profile with Basic auth | + +**Note on Windows NTLM:** Windows WebDAV clients often require NTLM authentication, which is incompatible with Cista's Argon2 password hashes. API tokens solve this — Cista uses the token secret as the NTLM password. + ### Internet Access Most admins find the [Caddy](https://caddyserver.com/) web server convenient for its auto TLS certificates and all. A proxy also allows running multiple web services or Cista instances on the same IP address but different (sub)domains.